藍(lán)牙API

如果你進(jìn)來了,點(diǎn)下關(guān)注行不行_

CBCentralManager 中心設(shè)備管理類#

//設(shè)置中心設(shè)備代理
@property(assign, nonatomic, nullable) id<CBCentralManagerDelegate> delegate;
//中心設(shè)備當(dāng)前狀態(tài)
@property(readonly) CBCentralManagerState state;
//中心設(shè)備是否正在掃描
@property(readonly) BOOL isScanning NS_AVAILABLE(NA, 9_0);

CBCentralManagerState 設(shè)備狀態(tài)#

typedef NS_ENUM(NSInteger, CBCentralManagerState) {
    //狀態(tài)未知
    CBCentralManagerStateUnknown = 0,
    //連接斷開 即將重置
    CBCentralManagerStateResetting,
    //該平臺(tái)不支持藍(lán)牙
    CBCentralManagerStateUnsupported,
    //未授權(quán)藍(lán)牙使用
    CBCentralManagerStateUnauthorized,
    //藍(lán)牙關(guān)閉
    CBCentralManagerStatePoweredOff,
    //藍(lán)牙正常開啟
    CBCentralManagerStatePoweredOn,
};

初始化CBCentralManager方法#

//初始化方法
//設(shè)置的代理需要遵守CBCentralManagerDelegate協(xié)議
//queue可以設(shè)置藍(lán)牙掃描的線程 傳入nil則為在主線程中進(jìn)行
- (instancetype)initWithDelegate:(nullable id<CBCentralManagerDelegate>)delegate
queue:(nullable dispatch_queue_t)queue;
//此方法同上 在options字典中用于進(jìn)行一些管理中心的初始化屬性設(shè)置
//字典中支持的鍵值如下
/*
 NSString * const CBCentralManagerOptionShowPowerAlertKey 對(duì)應(yīng)一個(gè)NSNumber類型的bool值扒腕，用于設(shè)置是否在關(guān)閉藍(lán)牙時(shí)彈出用戶提示
 NSString * const CBCentralManagerOptionRestoreIdentifierKey 對(duì)應(yīng)一個(gè)NSString對(duì)象绞绒，設(shè)置管理中心的標(biāo)識(shí)符ID
 */
- (instancetype)initWithDelegate:(nullable id<CBCentralManagerDelegate>)delegate
queue:(nullable dispatch_queue_t)queue
options:(nullable NSDictionary<NSString *, id> *)options;

根據(jù)獲取連接設(shè)備列表#

//?根據(jù)服務(wù)NSUUID,獲取所有設(shè)備,并返回一個(gè)列表
- (NSArray<CBPeripheral *> *)retrievePeripheralsWithIdentifiers:(NSArray<NSUUID *> *)identifiers;
//根據(jù)服務(wù)id獲取所有連接的設(shè)備
- (NSArray<CBPeripheral *> *)retrieveConnectedPeripheralsWithServices:(NSArray<CBUUID *> *)serviceUUIDs;

初始化CBCentralManager后,會(huì)自動(dòng)回調(diào)代理方法#

//這個(gè)方法中可以獲取到管理中心的狀態(tài)
- (void)centralManagerDidUpdateState:(CBCentralManager *)central;

掃描藍(lán)牙設(shè)備方法#

// serviceUUIDs     :  用于掃描一個(gè)特點(diǎn)ID的外設(shè)
// options          :  用于設(shè)置一些掃描屬性 鍵值如下
/*
 //是否允許重復(fù)掃描 對(duì)應(yīng)NSNumber的bool值，默認(rèn)為NO透敌，會(huì)自動(dòng)去重
 NSString *const CBCentralManagerScanOptionAllowDuplicatesKey;
 //要掃描的設(shè)備UUID 數(shù)組 對(duì)應(yīng)NSArray
 NSString *const CBCentralManagerScanOptionSolicitedServiceUUIDsKey;
 */
- (void)scanForPeripheralsWithServices:(nullable NSArray<CBUUID *> *)serviceUUIDs options:(nullable NSDictionary<NSString *, id> *)options;

停止藍(lán)牙掃描的方法#

- (void)stopScan;

掃描成功的方法#

// peripheral 掃描到的外設(shè)
// advertisementData是外設(shè)發(fā)送的廣播數(shù)據(jù)
// RSSI 是信號(hào)強(qiáng)度
- (void)centralManager:(CBCentralManager *)central didDiscoverPeripheral:(CBPeripheral *)peripheral advertisementData:(NSDictionary<NSString *, id> *)advertisementData RSSI:(NSNumber *)RSSI;

連接設(shè)備的方法#

/*
 options中可以設(shè)置一些連接設(shè)備的初始屬性鍵值如下
 //對(duì)應(yīng)NSNumber的bool值，設(shè)置當(dāng)外設(shè)連接后是否彈出一個(gè)警告
 NSString *const CBConnectPeripheralOptionNotifyOnConnectionKey;
 //對(duì)應(yīng)NSNumber的bool值，設(shè)置當(dāng)外設(shè)斷開連接后是否彈出一個(gè)警告
 NSString *const CBConnectPeripheralOptionNotifyOnDisconnectionKey;
 //對(duì)應(yīng)NSNumber的bool值，設(shè)置當(dāng)外設(shè)暫停連接后是否彈出一個(gè)警告
 NSString *const CBConnectPeripheralOptionNotifyOnNotificationKey;
 */
- (void)connectPeripheral:(CBPeripheral *)peripheral options:(nullable NSDictionary<NSString *, id> *)options;

取消連接設(shè)備的方法#

//取消一個(gè)外設(shè)的連接
- (void)cancelPeripheralConnection:(CBPeripheral *)peripheral;

連接后處理的方法#

//連接外設(shè)成功
- (void)centralManager:(CBCentralManager *)central didConnectPeripheral:(CBPeripheral *)peripheral;
//連接外設(shè)失敗
- (void)centralManager:(CBCentralManager *)central didFailToConnectPeripheral:(CBPeripheral *)peripheral error:(nullable NSError *)error;
//斷開外設(shè)連接
- (void)centralManager:(CBCentralManager *)central didDisconnectPeripheral:(CBPeripheral *)peripheral error:(nullable NSError *)error;

當(dāng)管理中心恢復(fù)時(shí)會(huì)調(diào)用如下方法#

//dict中會(huì)傳入如下鍵值對(duì)
/*
 //恢復(fù)連接的外設(shè)數(shù)組
 NSString *const CBCentralManagerRestoredStatePeripheralsKey;
 //恢復(fù)連接的服務(wù)UUID數(shù)組
 NSString *const CBCentralManagerRestoredStateScanServicesKey;
 //恢復(fù)連接的外設(shè)掃描屬性字典數(shù)組
 NSString *const CBCentralManagerRestoredStateScanOptionsKey;
 */
- (void)centralManager:(CBCentralManager *)central willRestoreState:(NSDictionary<NSString *, id> *)dict;

外設(shè)的設(shè)備的方法,(找服務(wù),找特征)#

//設(shè)置代理
@property(assign, nonatomic, nullable) id<CBPeripheralDelegate> delegate;
//外設(shè)name
@property(retain, readonly, nullable) NSString *name;
//信號(hào)強(qiáng)度
@property(retain, readonly, nullable) NSNumber *RSSI NS_DEPRECATED(NA, NA, 5_0, 8_0);
//外設(shè)狀態(tài)
/*
 typedef NS_ENUM(NSInteger, CBPeripheralState) {
 CBPeripheralStateDisconnected = 0,//未連接
 CBPeripheralStateConnecting,//正在鏈接
 CBPeripheralStateConnected,//已經(jīng)連接
 CBPeripheralStateDisconnecting NS_AVAILABLE(NA, 9_0),//正在斷開連接
 } NS_AVAILABLE(NA, 7_0);
 */
@property(readonly) CBPeripheralState state;
//所有的服務(wù)數(shù)組
@property(retain, readonly, nullable) NSArray<CBService *> *services;
//獲取當(dāng)前信號(hào)強(qiáng)度
- (void)readRSSI;
//根據(jù)服務(wù)UUID尋找服務(wù)對(duì)象
- (void)discoverServices:(nullable NSArray<CBUUID *> *)serviceUUIDs;
//在服務(wù)對(duì)象UUID數(shù)組中尋找特定服務(wù)
- (void)discoverIncludedServices:(nullable NSArray<CBUUID *> *)includedServiceUUIDs forService:(CBService *)service;
//在一個(gè)服務(wù)中尋找特征值
- (void)discoverCharacteristics:(nullable NSArray<CBUUID *> *)characteristicUUIDs forService:(CBService *)service;
//從一個(gè)特征中讀取數(shù)據(jù)
- (void)readValueForCharacteristic:(CBCharacteristic *)characteristic;
//寫數(shù)據(jù)的最大長(zhǎng)度
//type枚舉如下
/*
 typedef NS_ENUM(NSInteger, CBCharacteristicWriteType) {
 CBCharacteristicWriteWithResponse = 0,//寫數(shù)據(jù)并且接收成功與否回執(zhí)
 CBCharacteristicWriteWithoutResponse,//寫數(shù)據(jù)不接收回執(zhí)
 };
 */
- (NSUInteger)maximumWriteValueLengthForType:(CBCharacteristicWriteType)type NS_AVAILABLE(NA, 9_0);
//向某個(gè)特征中寫數(shù)據(jù)
- (void)writeValue:(NSData *)data forCharacteristic:(CBCharacteristic *)characteristic type:(CBCharacteristicWriteType)type;
//為制定的特征值設(shè)置監(jiān)聽通知
- (void)setNotifyValue:(BOOL)enabled forCharacteristic:(CBCharacteristic *)characteristic;
//尋找特征值的描述
- (void)discoverDescriptorsForCharacteristic:(CBCharacteristic *)characteristic;
//讀取特征的描述值
- (void)readValueForDescriptor:(CBDescriptor *)descriptor;
//寫特征的描述值
- (void)writeValue:(NSData *)data forDescriptor:(CBDescriptor *)descriptor;

外設(shè)方法的回調(diào),代理方法#

//外設(shè)名稱更改時(shí)回調(diào)的方法
- (void)peripheralDidUpdateName:(CBPeripheral *)peripheral NS_AVAILABLE(NA, 6_0);
//外設(shè)服務(wù)變化時(shí)回調(diào)的方法
- (void)peripheral:(CBPeripheral *)peripheral didModifyServices:(NSArray<CBService *> *)invalidatedServices NS_AVAILABLE(NA, 7_0);
//信號(hào)強(qiáng)度改變時(shí)調(diào)用的方法
- (void)peripheralDidUpdateRSSI:(CBPeripheral *)peripheral error:(nullable NSError *)error NS_DEPRECATED(NA, NA, 5_0, 8_0);
//讀取信號(hào)強(qiáng)度回調(diào)的方法
- (void)peripheral:(CBPeripheral *)peripheral didReadRSSI:(NSNumber *)RSSI error:(nullable NSError *)error NS_AVAILABLE(NA, 8_0);
//發(fā)現(xiàn)服務(wù)時(shí)調(diào)用的方法
- (void)peripheral:(CBPeripheral *)peripheral didDiscoverServices:(nullable NSError *)error;
//在服務(wù)中發(fā)現(xiàn)子服務(wù)回調(diào)的方法
- (void)peripheral:(CBPeripheral *)peripheral didDiscoverIncludedServicesForService:(CBService *)service error:(nullable NSError *)error;
//發(fā)現(xiàn)服務(wù)的特征值后回調(diào)的方法
- (void)peripheral:(CBPeripheral *)peripheral didDiscoverCharacteristicsForService:(CBService *)service error:(nullable NSError *)error;
//特征值更新時(shí)回調(diào)的方法
- (void)peripheral:(CBPeripheral *)peripheral didUpdateValueForCharacteristic:(CBCharacteristic *)characteristic error:(nullable NSError *)error;
//向特征值寫數(shù)據(jù)時(shí)回調(diào)的方法
- (void)peripheral:(CBPeripheral *)peripheral didWriteValueForCharacteristic:(CBCharacteristic *)characteristic error:(nullable NSError *)error;
//特征值的通知設(shè)置改變時(shí)觸發(fā)的方法
- (void)peripheral:(CBPeripheral *)peripheral didUpdateNotificationStateForCharacteristic:(CBCharacteristic *)characteristic error:(nullable NSError *)error;
//發(fā)現(xiàn)特征值的描述信息觸發(fā)的方法
- (void)peripheral:(CBPeripheral *)peripheral didDiscoverDescriptorsForCharacteristic:(CBCharacteristic *)characteristic error:(nullable NSError *)error;
//特征的描述值更新時(shí)觸發(fā)的方法
- (void)peripheral:(CBPeripheral *)peripheral didUpdateValueForDescriptor:(CBDescriptor *)descriptor error:(nullable NSError *)error;
//寫描述信息時(shí)觸發(fā)的方法
- (void)peripheral:(CBPeripheral *)peripheral didWriteValueForDescriptor:(CBDescriptor *)descriptor error:(nullable NSError *)error;

CBService服務(wù)的方法#

//對(duì)應(yīng)的外設(shè)
@property(assign, readonly, nonatomic) CBPeripheral *peripheral;
//是否是初等服務(wù)
@property(readonly, nonatomic) BOOL isPrimary;
//包含的自服務(wù)
@property(retain, readonly, nullable) NSArray<CBService *> *includedServices;
//服務(wù)中的特征值
@property(retain, readonly, nullable) NSArray<CBCharacteristic *> *characteristics;

Characteristic特征的方法#

//對(duì)應(yīng)的服務(wù)對(duì)象
@property(assign, readonly, nonatomic) CBService *service;
//特征值的屬性 枚舉如下
/*
 typedef NS_OPTIONS(NSUInteger, CBCharacteristicProperties) {
 CBCharacteristicPropertyBroadcast,//允許廣播特征
 CBCharacteristicPropertyRead,//可讀屬性
 CBCharacteristicPropertyWriteWithoutResponse,//可寫并且接收回執(zhí)
 CBCharacteristicPropertyWrite,//可寫屬性
 CBCharacteristicPropertyNotify,//可通知屬性
 CBCharacteristicPropertyIndicate,//可展現(xiàn)的特征值
 CBCharacteristicPropertyAuthenticatedSignedWrites,//允許簽名的特征值寫入
 CBCharacteristicPropertyExtendedProperties,
 CBCharacteristicPropertyNotifyEncryptionRequired,
 CBCharacteristicPropertyIndicateEncryptionRequired
 };
 */
@property(readonly, nonatomic) CBCharacteristicProperties properties;
//特征值的數(shù)據(jù)
@property(retain, readonly, nullable) NSData *value;
//特征值的描述
@property(retain, readonly, nullable) NSArray<CBDescriptor *> *descriptors;
//是否是當(dāng)前廣播的特征
@property(readonly) BOOL isBroadcasted;
//是否是正在通知的特征
@property(readonly) BOOL isNotifying;
最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 人面猴
    序言：七十年代末廊酣，一起剝皮案震驚了整個(gè)濱河市，隨后出現(xiàn)的幾起案子赏枚，更是在濱河造成了極大的恐慌，老刑警劉巖晓猛，帶你破解...
    沈念sama閱讀 206,311評(píng)論 6贊 481
  • 死咒
    序言：濱河連續(xù)發(fā)生了三起死亡事件饿幅，死亡現(xiàn)場(chǎng)離奇詭異，居然都是意外死亡戒职，警方通過查閱死者的電腦和手機(jī)栗恩，發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,339評(píng)論 2贊 382
  • 救了他兩次的神仙讓他今天三更去死
    文/潘曉璐 我一進(jìn)店門，熙熙樓的掌柜王于貴愁眉苦臉地迎上來洪燥，“玉大人磕秤，你說我怎么就攤上這事∨踉希” “怎么了市咆？”我有些...
    開封第一講書人閱讀 152,671評(píng)論 0贊 342
  • 道士緝兇錄：失蹤的賣姜人
    文/不壞的土叔 我叫張陵，是天一觀的道長(zhǎng)再来。 經(jīng)常有香客問我蒙兰，道長(zhǎng)磷瘤，這世上最難降的妖魔是什么？ 我笑而不...
    開封第一講書人閱讀 55,252評(píng)論 1贊 279
  • ?港島之戀（遺憾婚禮）
    正文 為了忘掉前任搜变，我火速辦了婚禮采缚，結(jié)果婚禮上，老公的妹妹穿的比我還像新娘挠他。我一直安慰自己扳抽，他們只是感情好，可當(dāng)我...
    茶點(diǎn)故事閱讀 64,253評(píng)論 5贊 371
  • 惡毒庶女頂嫁案：這布局不是一般人想出來的
    文/花漫 我一把揭開白布殖侵。 她就那樣靜靜地躺著贸呢，像睡著了一般。 火紅的嫁衣襯著肌膚如雪愉耙。 梳的紋絲不亂的頭發(fā)上贮尉，一...
    開封第一講書人閱讀 49,031評(píng)論 1贊 285
  • 城市分裂傳說
    那天，我揣著相機(jī)與錄音朴沿，去河邊找鬼猜谚。 笑死，一個(gè)胖子當(dāng)著我的面吹牛赌渣，可吹牛的內(nèi)容都是我干的靶溜。 我是一名探鬼主播，決...
    沈念sama閱讀 38,340評(píng)論 3贊 399
  • 雙鴛鴦連環(huán)套：你想象不到人心有多黑
    文/蒼蘭香墨 我猛地睜開眼忘晤，長(zhǎng)吁一口氣：“原來是場(chǎng)噩夢(mèng)啊……” “哼谷朝！你這毒婦竟也來了？” 一聲冷哼從身側(cè)響起鸿竖，我...
    開封第一講書人閱讀 36,973評(píng)論 0贊 259
  • 萬榮殺人案實(shí)錄
    序言：老撾萬榮一對(duì)情侶失蹤沧竟，失蹤者是張志新（化名）和其女友劉穎，沒想到半個(gè)月后缚忧，有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體悟泵，經(jīng)...
    沈念sama閱讀 43,466評(píng)論 1贊 300
  • ?護(hù)林員之死
    正文 獨(dú)居荒郊野嶺守林人離奇死亡，尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,937評(píng)論 2贊 323
  • ?白月光啟示錄
    正文 我和宋清朗相戀三年闪水，在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了糕非。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,039評(píng)論 1贊 333
  • 活死人
    序言：一個(gè)原本活蹦亂跳的男人離奇死亡球榆，死狀恐怖朽肥，靈堂內(nèi)的尸體忽然破棺而出，到底是詐尸還是另有隱情持钉，我是刑警寧澤衡招，帶...
    沈念sama閱讀 33,701評(píng)論 4贊 323
  • ?日本核電站爆炸內(nèi)幕
    正文 年R本政府宣布，位于F島的核電站每强，受9級(jí)特大地震影響蚁吝，放射性物質(zhì)發(fā)生泄漏旱爆。R本人自食惡果不足惜，卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,254評(píng)論 3贊 307
  • 男人毒藥：我在死后第九天來索命
    文/蒙蒙 一窘茁、第九天 我趴在偏房一處隱蔽的房頂上張望怀伦。 院中可真熱鬧，春花似錦山林、人聲如沸房待。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,259評(píng)論 0贊 19
  • 一樁弒父案驼抹，背后竟有這般陰謀
    文/蒼蘭香墨 我抬頭看了看天上的太陽桑孩。三九已至，卻和暖如春框冀，著一層夾襖步出監(jiān)牢的瞬間流椒，已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,485評(píng)論 1贊 262
  • 情欲美人皮
    我被黑心中介騙來泰國(guó)打工明也， 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留宣虾，地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 45,497評(píng)論 2贊 354
  • 代替公主和親
    正文 我出身青樓温数，卻偏偏與公主長(zhǎng)得像绣硝，于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子撑刺，可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,786評(píng)論 2贊 345

推薦閱讀更多精彩內(nèi)容

  • 原文：http://www.myexception.cn/operating-system/2052286.htm...
    KYM1988閱讀 1,926評(píng)論 2贊 2
  • 藍(lán)牙簡(jiǎn)介 藍(lán)牙（ Bluetooth? ）：是一種無線技術(shù)標(biāo)準(zhǔn)鹉胖，可實(shí)現(xiàn)固定設(shè)備、移動(dòng)設(shè)備和樓宇個(gè)人域網(wǎng)之間的短距離...
    Chefil閱讀 2,030評(píng)論 2贊 19
  • 1.簡(jiǎn)介 通過藍(lán)牙API够傍，可以實(shí)現(xiàn)以下內(nèi)容： 掃描其他藍(lán)牙設(shè)備 查詢配對(duì)藍(lán)牙設(shè)備的本地藍(lán)牙適配器 創(chuàng)建RFCOMM...
    justCode_閱讀 4,808評(píng)論 0贊 3
  • 緊張工作甫菠，樂在心中，開拓思維冕屯，擼袖加油
    呢子大衣閱讀 154評(píng)論 0贊 1
  • 【小魚愛笑】D9 "擁有尊重的能力醋寝，來自于自信和自尊搞挣。" 《為婚姻立界線》20161002學(xué)而思：今天去聽寄居蟹的...
    小魚愛笑閱讀 316評(píng)論 0贊 0