【转】iOS开发之蓝牙通信

来自:https://my.oschina.net/u/2340880/blog/548127

iOS开发之蓝牙通讯

一、引言

        蓝牙是设备近距离通信的一种方便手段,在iPhone引入蓝牙4.0后,设备之间的通讯变得更加简单。相关的蓝牙操作由专门的CoreBluetooth.framework进行统一管理。通过蓝牙进行通讯交互分为两方,一方为中心设备central,一方为外设peripheral,外设通过广播的方式向外发送信息,中心设备检索到外设发的广播信息,可以进行配对连接,进而进行数据交互。

二、中心设备CBCentralManager

CBCentralManager是管理中心设备的管理类,其中重要方法如下:

//设置中心设备代理

@property(assign,nonatomic,nullable)id delegate;

//中心设备当前状态

@property(readonly) CBCentralManagerState state;

//中心设备是否正在扫描

@property(readonly)BOOLisScanningNS_AVAILABLE(NA,9_0);

   其中state是一个枚举,有关蓝牙是否可用的状态如下:

typedefNS_ENUM(NSInteger, CBCentralManagerState) {

CBCentralManagerStateUnknown =0, //状态未知

CBCentralManagerStateResetting, //连接断开 即将重置

CBCentralManagerStateUnsupported, //该平台不支持蓝牙

CBCentralManagerStateUnauthorized, //未授权蓝牙使用

CBCentralManagerStatePoweredOff, //蓝牙关闭

CBCentralManagerStatePoweredOn, //蓝牙正常开启};

下面这些方法用于初始化管理中心:

//初始化方法//设置的代理需要遵守CBCentralManagerDelegate协议//queue可以设置蓝牙扫描的线程 传入nil则为在主线程中进行

- (instancetype)initWithDelegate:(nullableid)delegate   queue:(nullabledispatch_queue_t)queue;

//此方法同上 在options字典中用于进行一些管理中心的初始化属性设置//字典中支持的键值如下/*

NSString * const CBCentralManagerOptionShowPowerAlertKey 对应一个NSNumber类型的bool值,用于设置是否在关闭蓝牙时弹出用户提示

NSString * const CBCentralManagerOptionRestoreIdentifierKey 对应一个NSString对象,设置管理中心的标识符ID

*/- (instancetype)initWithDelegate:(nullableid)delegate   queue:(nullabledispatch_queue_t)queue options:(nullableNSDictionary *)options;

- (NSArray *)retrievePeripheralsWithIdentifiers:(NSArray *)identifiers; //根据获取所有已知设备

- (NSArray *)retrieveConnectedPeripheralsWithServices:(NSArray *)serviceUUIDs; //根据服务id获取所有连接的设备

在初始化管理中心完成后,会回调代理中的如下方法,我们必须实现如下方法:

- (void)centralManagerDidUpdateState:(CBCentralManager *)central; //这个方法中可以获取到管理中心的状态

如果上面方法中管理中心状态为蓝牙可用,可以通过下面方法开启扫描外设:

//serviceUUIDs用于扫描一个特点ID的外设 options用于设置一些扫描属性 键值如下

/*

//是否允许重复扫描 对应NSNumber的bool值,默认为NO,会自动去重

NSString *const CBCentralManagerScanOptionAllowDuplicatesKey;

//要扫描的设备UUID 数组 对应NSArray

NSString *const CBCentralManagerScanOptionSolicitedServiceUUIDsKey;

*/

- (void)scanForPeripheralsWithServices:(nullableNSArray *)serviceUUIDs options:(nullableNSDictionary *)options;

- (void)stopScan; //停止扫描外设

扫描的结果会在如下代理方法中回掉:


- (void)centralManager:(CBCentralManager *)central didDiscoverPeripheral:(CBPeripheral *)peripheral advertisementData:(NSDictionary *)advertisementData RSSI:(NSNumber*)RSSI;  //peripheral 扫描到的外设//advertisementData是外设发送的广播数据//RSSI 是信号强度

扫描到外设后,通过下面方法可以连接一个外设:

/*

options中可以设置一些连接设备的初始属性键值如下

//对应NSNumber的bool值,设置当外设连接后是否弹出一个警告

NSString *const CBConnectPeripheralOptionNotifyOnConnectionKey;

//对应NSNumber的bool值,设置当外设断开连接后是否弹出一个警告

NSString *const CBConnectPeripheralOptionNotifyOnDisconnectionKey;

//对应NSNumber的bool值,设置当外设暂停连接后是否弹出一个警告

NSString *const CBConnectPeripheralOptionNotifyOnNotificationKey;

*/

- (void)connectPeripheral:(CBPeripheral *)peripheral options:(nullableNSDictionary *)options;

- (void)cancelPeripheralConnection:(CBPeripheral *)peripheral; //取消一个外设的连接

调用过连接外设的方法后,会回掉如下代理方法:

- (void)centralManager:(CBCentralManager *)centraldidConnectPeripheral: (CBPeripheral *)peripheral; //连接外设成功

- (void)centralManager:(CBCentralManager *)centraldidFailToConnectPeripheral:(CBPeripheral *)peripheralerror:(nullable NSError *)error; //连接外设败

- (void)centralManager:(CBCentralManager *)centraldidDisconnectPeripheral:(CBPeripheral *)peripheralerror:(nullable NSError *)error; //断开外设连接

当管理中心恢复时会调用如下代理:

//dict中会传入如下键值对/*

//恢复连接的外设数组

NSString *const CBCentralManagerRestoredStatePeripheralsKey;

//恢复连接的服务UUID数组

NSString *const CBCentralManagerRestoredStateScanServicesKey;

//恢复连接的外设扫描属性字典数组

NSString *const CBCentralManagerRestoredStateScanOptionsKey;

*/

- (void)centralManager:(CBCentralManager *)central willRestoreState:(NSDictionary *)dict;

三、外设CBPeripheralManager

        从上面我们知道,中心设备是用来扫描周围的外设,两台设备的通讯中,必须有一个充当中心设备,一个充当外设,外设是由CBPeripheralManager进行管理,主要方法如下:


@property(assign,nonatomic,nullable)id delegate; //设置外设管理中心代理@property(readonly) CBPeripheralManagerState state; //外设状态 枚举如中心设备@property(readonly)BOOLisAdvertising; //是否正在发送广播+ (CBPeripheralManagerAuthorizationStatus)authorizationStatus; //用户的授权状态

- (instancetype)initWithDelegate:(nullableid)delegate   queue:(nullabledispatch_queue_t);- (instancetype)initWithDelegate:(nullableid)delegate   queue:(nullabledispatch_queue_t)queue options:(nullableNSDictionary *)options; //初始化并设置代理 参数的具体含义与中心设备管理中心

//开始发送广播//advertisementData中可以发送的数据有约定 如下

/*

对应设置NSString类型的广播名

NSString *const CBAdvertisementDataLocalNameKey;

外设制造商的NSData数据

NSString *const CBAdvertisementDataManufacturerDataKey;

外设制造商的CBUUID数据

NSString *const CBAdvertisementDataServiceDataKey;

服务的UUID与其对应的服务数据字典数组

NSString *const CBAdvertisementDataServiceUUIDsKey;

附加服务的UUID数组

NSString *const CBAdvertisementDataOverflowServiceUUIDsKey;

外设的发送功率 NSNumber类型

NSString *const CBAdvertisementDataTxPowerLevelKey;

外设是否可以连接

NSString *const CBAdvertisementDataIsConnectable;

服务的UUID数组

NSString *const CBAdvertisementDataSolicitedServiceUUIDsKey;

*/

- (void)startAdvertising:(nullableNSDictionary *)advertisementData; //停止发送广播- (void)stopAdvertising;

//设置一个连接的具体central设备的延时 枚举如下

/*

typedef NS_ENUM(NSInteger, CBPeripheralManagerConnectionLatency) {

CBPeripheralManagerConnectionLatencyLow = 0,

CBPeripheralManagerConnectionLatencyMedium,

CBPeripheralManagerConnectionLatencyHigh

} NS_ENUM_AVAILABLE(NA, 6_0);

*/

- (void)setDesiredConnectionLatency:(CBPeripheralManagerConnectionLatency)latency forCentral:(CBCentral *)central;

- (void)addService:(CBMutableService *)service; //添加一个服务

- (void)removeService:(CBMutableService *)service; //移除一个服务

- (void)removeAllServices; //移除所有服务

- (void)respondToRequest:(CBATTRequest *)request withResult:(CBATTError)result; //响应中心设备的读写请求

- (BOOL)updateValue:(NSData*)value forCharacteristic:(CBMutableCharacteristic *)characteristic onSubscribedCentrals:(nullableNSArray *)centrals; //更新一个连接中心设备的订阅特征值

外设代理的相关方法如下:

- (void)peripheralManagerDidUpdateState:(CBPeripheralManager *)peripheral; //这个方法是必须实现的 状态可用后可以发送广播

- (void)peripheralManager:(CBPeripheralManager *)peripheralwillRestoreState:(NSDictionary *)dict; //连接回复时调用的方法 和centralManager类似

- (void)peripheralManagerDidStartAdvertising:(CBPeripheralManager *)peripheralerror:(nullable NSError *)error; //开始发送广播时调用的方法

- (void)peripheralManager:(CBPeripheralManager *)peripheral didAddService:(CBService *)serviceerror:(nullable NSError *)error; //添加服务调用的回调

- (void)peripheralManager:(CBPeripheralManager *)peripheralcentral:(CBCentral *)centraldidSubscribeToCharacteristic:(CBCharacteristic *)characteristic; //当一个central设备订阅一个特征值时调用的方法

- (void)peripheralManager:(CBPeripheralManager *)peripheralcentral:(CBCentral *)central didUnsubscribeFromCharacteristic:(CBCharacteristic *)characteristic; //取消订阅一个特征值时调用的方法

- (void)peripheralManager:(CBPeripheralManager *)peripheral didReceiveReadRequest:(CBATTRequest *)request; //收到读请求时触发的方法

- (void)peripheralManager:(CBPeripheralManager *)peripheral didReceiveWriteRequests:(NSArray *)requests; //收到写请求时触发的方法

- (void)peripheralManagerIsReadyToUpdateSubscribers:(CBPeripheralManager *)peripheral; //外设准备更新特征值时调用的方法

四、中心设备与外设对象CBCentral与CBPeripheral

        上面介绍了中心设备管理类与外设管理类,这些类用于将设备连接建立起来,器具的数据交换的服务和一些信息则是在对应的设备对象中。

1、中心设备 CBCentral属性与方法

@property(readonly,nonatomic)NSUUID*identifier; //设备UUID

@property(readonly,nonatomic)NSUIntegermaximumUpdateValueLength; //中心设备最大接收的数据长度

2、外设CAPeripheral属性与方法

        外设对象要比中心对象复杂的多,当centralManager连接到外设后,需要通过外设对象的代理方法进行数据交互,其中主要方法属性如下:

@property(assign,nonatomic,nullable)id delegate; //设置代理

@property(retain,readonly,nullable)NSString*name; //外设name

@property(retain,readonly,nullable)NSNumber *RSSI NS_DEPRECATED(NA, NA,5_0,8_0); //信号强度

/*

typedef NS_ENUM(NSInteger, CBPeripheralState) {

CBPeripheralStateDisconnected = 0, //未连接

CBPeripheralStateConnecting, //正在链接

CBPeripheralStateConnected, //已经连接

CBPeripheralStateDisconnecting NS_AVAILABLE(NA, 9_0), //正在断开连接

} NS_AVAILABLE(NA, 7_0);

*/

@property(readonly) CBPeripheralState state; //外设状态

@property(retain,readonly,nullable)NSArray *services; //所有的服务数组

- (void)readRSSI; //获取当前信号强度

- (void)discoverServices:(nullableNSArray *)serviceUUIDs; //根据服务UUID寻找服务对象

- (void)discoverIncludedServices:(nullableNSArray *)includedServiceUUIDs forService:(CBService *)service; //在服务对象UUID数组中寻找特定服务

- (void)discoverCharacteristics:(nullableNSArray *)characteristicUUIDs forService:(CBService *)service; //在一个服务中寻找特征值

- (void)readValueForCharacteristic:(CBCharacteristic *)characteristic; //从一个特征中读取数据

//type枚举如下

/*

typedef NS_ENUM(NSInteger, CBCharacteristicWriteType) {

CBCharacteristicWriteWithResponse = 0, //写数据并且接收成功与否回执

CBCharacteristicWriteWithoutResponse, //写数据不接收回执

};

*/

 - (NSUInteger)maximumWriteValueLengthForType:(CBCharacteristicWriteType)typeNS_AVAILABLE(NA,9_0); //写数据的最大长度

(void)writeValue:(NSData*)data forCharacteristic:(CBCharacteristic *)characteristic type:(CBCharacteristicWriteType)type; //向某个特征中写数据-

- (void)setNotifyValue:(BOOL)enabled forCharacteristic:(CBCharacteristic *)characteristic; //为制定的特征值设置监听通知

- (void)discoverDescriptorsForCharacteristic:(CBCharacteristic *)characteristic; //寻找特征值的描述

- (void)readValueForDescriptor:(CBDescriptor *)descriptor; //读取特征的描述值

- (void)writeValue:(NSData*)data forDescriptor:(CBDescriptor *)descriptor; //写特征的描述值

外设的代理方法如下:

- (void)peripheralDidUpdateName:(CBPeripheral *)peripheral NS_AVAILABLE(NA,6_0); //外设名称更改时回调的方法

- (void)peripheral:(CBPeripheral *)peripheraldidModifyServices:(NSArray *)invalidatedServices NS_AVAILABLE(NA,7_0); //外设服务变化时回调的方法

- (void)peripheralDidUpdateRSSI:(CBPeripheral *)peripheralerror:(nullable NSError *)error NS_DEPRECATED(NA, NA,5_0,8_0); //信号强度改变时调用的方法

- (void)peripheral:(CBPeripheral *)peripheraldidReadRSSI:(NSNumber *)RSSIerror:(nullable NSError *)error NS_AVAILABLE(NA,8_0); //读取信号强度回调的方法

- (void)peripheral:(CBPeripheral *)peripheraldidDiscoverServices:(nullable NSError *)error; //发现服务时调用的方法

- (void)peripheral:(CBPeripheral *)peripheraldidDiscoverIncludedServicesForService:(CBService *)serviceerror:(nullable NSError *)error; //在服务中发现子服务回调的方法

- (void)peripheral:(CBPeripheral *)peripheraldidDiscoverCharacteristicsForService:(CBService *)serviceerror:(nullable NSError *)error; //发现服务的特征值后回调的方法

- (void)peripheral:(CBPeripheral *)peripheraldidUpdateValueForCharacteristic:(CBCharacteristic *)characteristicerror:(nullable NSError *)error; //特征值更新时回调的方法

- (void)peripheral:(CBPeripheral *)peripheraldidWriteValueForCharacteristic:(CBCharacteristic *)characteristicerror:(nullable NSError *)error; //向特征值写数据时回调的方法

- (void)peripheral:(CBPeripheral *)peripheraldidUpdateNotificationStateForCharacteristic:(CBCharacteristic *)characteristicerror:(nullable NSError *)error; //特征值的通知设置改变时触发的方法

- (void)peripheral:(CBPeripheral *)peripheraldidDiscoverDescriptorsForCharacteristic:(CBCharacteristic *)characteristicerror:(nullable NSError *)error; //发现特征值的描述信息触发的方法

- (void)peripheral:(CBPeripheral *)peripheraldidUpdateValueForDescriptor:(CBDescriptor *)descriptorerror:(nullable NSError *)error; //特征的描述值更新时触发的方法

- (void)peripheral:(CBPeripheral *)peripheraldidWriteValueForDescriptor:(CBDescriptor *)descriptorerror:(nullable NSError *)error; //写描述信息时触发的方法

五、服务对象CBService

    服务对象是用来管理外设提供的一些数据服务的,其中属性如下:

@property(assign,readonly,nonatomic) CBPeripheral *peripheral; //对应的外设

@property(readonly,nonatomic)BOOLisPrimary; //是否是初等服务

@property(retain,readonly,nullable)NSArray *includedServices; //包含的自服务

@property(retain,readonly,nullable)NSArray *characteristics; //服务中的特征值

六、服务的特征值CBCharacteristic

        通过绑定服务中的特征值来进行数据的读写操作,其中属性如下:

//对应的服务对象@property(assign,readonly,nonatomic) CBService *service;//特征值的属性 枚举如下/*

typedef NS_OPTIONS(NSUInteger, CBCharacteristicProperties) {

CBCharacteristicPropertyBroadcast, //允许广播特征

CBCharacteristicPropertyRead, //可读属性

CBCharacteristicPropertyWriteWithoutResponse, //可写并且接收回执

CBCharacteristicPropertyWrite, //可写属性

CBCharacteristicPropertyNotify, //可通知属性

CBCharacteristicPropertyIndicate, //可展现的特征值

CBCharacteristicPropertyAuthenticatedSignedWrites, //允许签名的特征值写入

CBCharacteristicPropertyExtendedProperties,

CBCharacteristicPropertyNotifyEncryptionRequired,

CBCharacteristicPropertyIndicateEncryptionRequired

};

*/@property(readonly,nonatomic) CBCharacteristicProperties properties; //特征值的数据@property(retain,readonly,nullable)NSData*value; //特征值的描述@property(retain,readonly,nullable)NSArray *descriptors; //是否是当前广播的特征@property(readonly)BOOLisBroadcasted; //是否是正在通知的特征@property(readonly)BOOLisNotifying;

七、读写请求对象CBATTRequest

        服务对象是外设向中心设备提供的相关数据服务,获取到相应服务后,中心设备可以进行读写请求,读写对象属性如下:

@property(readonly,nonatomic) CBCentral *central; //对应的中心设备

@property(readonly,nonatomic) CBCharacteristic *characteristic; //对应的特征值

@property(readwrite,copy,nullable) NSData*value; //读写数据值

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 160,165评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,720评论 1 298
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,849评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,245评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,596评论 3 288
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,747评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,977评论 2 315
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,708评论 0 204
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,448评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,657评论 2 249
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,141评论 1 261
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,493评论 3 258
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,153评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,108评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,890评论 0 198
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,799评论 2 277
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,685评论 2 272