蓝牙客户端-中心设备
主要内容
1. 创建`中央管理器`
2. 发现并且连接外设
3. 寻找连接上的外设数据
4. 发送读或写`特征值`的请求
5. 订阅外设特征值
1. 创建中心管理器
因为CBCentralManager
代表着本地中央设备
,所以你必须先创建一个中央管理器对象,通过CBCentralManager
的initWithDelegate:queue:options:
如:
myCentralManager =
[[CBCentralManager alloc] initWithDelegate:self queue:nil options:nil];```
在上面的例子中,self设置为中央管理器的代理,它将接收来自`中央管理器`的事件回调,queue设置为nil,表示为主队列.当你创建一个中心管理器时,就会调用它代理的`centralManagerDidUpdateState:` 方法,你必须实现这个代理方法来确保你的设备支持蓝牙4.0.
####2. 扫描外部设备
[myCentralManager scanForPeripheralsWithServices:nil options:nil];
1. `注意`:如果第一个参数传入nil,`中央管理器` 返回全部找到的外设,忽略它们所支持的服务,你可以传入一个有独特UUID的`服务`数组,当你指定服务的时候,`中央管理器` 只返回具拥有这些服务的外设.
2. 在你调用` scanForPeripheralsWithServices:options: `方法之后,`中央管理器`就会调用它代理的` centralManager:didDiscoverPeripheral:advertisementData:RSSI:`,没发现一个外设就会调用一次,发现的外部设备通过` CBPeripheral `对象传入.你可以实现这个方法列出所发现的外设.
```
- (void)centralManager:(CBCentralManager *)central
didDiscoverPeripheral:(CBPeripheral *)peripheral
advertisementData:(NSDictionary *)advertisementData
RSSI:(NSNumber *)RSSI {
NSLog(@"Discovered %@", peripheral.name);
...
当你找到你需要的外设后,你需要停止搜索.
3. 连接外部设备
当你找到自己需要的外设后,你应该请求连接外部设备,通过调用BCentralManager
的connectPeripheral:options:
方法.如:
[myCentralManager connectPeripheral:peripheral options:nil];
假如连接外设成功,中央管理器
就会调用它代理的centralManager:didConnectPeripheral:
方法,
- (void)centralManager:(CBCentralManager *)central
didConnectPeripheral:(CBPeripheral *)peripheral {
NSLog(@"Peripheral connected");
...```
在与外设进行交互之前你应该首先设置外设的代理
####4. 发现已经连接设备上的服务.
当你连接上一个外设,你就可以开始检索数据了,第一步,检索一个外设上都提供什么服务,通过下面的方法你可以检索出,所有的外设提供的所有的服务
[peripheral discoverServices:nil];```
注意
:尽管你这么做可以反问这个外设
上的所有服务
,但是在一个真实的App
中你通常不传入一个nil
,因为一个外设可能非常多的服务,这些服务并不是你需要的,发现他们全部可能缩短电池的使用时间并且浪费时间.更多情况你需要制定服务
的UUID
来检索你感兴趣的服务
.
但发现指定的服务后,将会调用CBPeripheral
对象的代理方法peripheral:didDiscoverServices:
,核心蓝牙框架会把所发现的服务放到一个数组中,设置给这个外设对象.你可以实现这个代理方法,访问这些服务
- (void)peripheral:(CBPeripheral *)peripheral
didDiscoverServices:(NSError *)error {
for (CBService *service in peripheral.services) {
NSLog(@"Discovered service %@", service);
...
}
...```
####5. 发现一个服务上的特征.
假设你已经找到了你需要的服务,下一步就是检索该服务上的特征,检索服务上的所有特征你只需要调用` CBPeripheral` 方法 ` discoverCharacteristics:forService: ` 并指定服务
NSLog(@"Discovering characteristics for service %@", interestingService);
[peripheral discoverCharacteristics:nil forService:interestingService];```
注意
: 尽管你这么做可以反问这个服务
上的所有特征
,但是在一个真实的App
中你通常不要出入一个nil,因为一个服务
可能非常多的特征
,这些特征
并不是你需要的,发现他们全部可能会缩短电池的使用时间并且浪费时间.更多情况你需要制定特征
的UUID
来检索你感兴趣的特征
.
当外设检索到指定服务的特征后,就会调用代理对象的peripheral:didDiscoverCharacteristicsForService:error:
核心蓝牙会把所发现的特征放到数组中设置给服务的characteristics
属性,你可以实现这个代理方法,获取检索到的特征
- (void)peripheral:(CBPeripheral *)peripheral
didDiscoverCharacteristicsForService:(CBService *)service
error:(NSError *)error {
for (CBCharacteristic *characteristic in service.characteristics) {
NSLog(@"Discovered characteristic %@", characteristic);
...
}
...
6. 取出一个特征的值
一个特征
包含一个单独的值
,这个代表着外设提供的服务的详细信息.例如在一个体温计中的一个温度的特征
有一个值代表着摄氏度的温度.你可以可以直接读取这个值或订阅这个值
1. 读出一个特征的值
当你找到需要的服务的一个特征后,你可以读取这个特征的值,通过调用CBPeripheral
的readValueForCharacteristic:
传入那个特征.像这样
NSLog(@"Reading value for characteristic %@", interestingCharacteristic);
[peripheral readValueForCharacteristic:interestingCharacteristic];```
当你试图读取一个特征的值的时候,外设就会调用它代理的`peripheral:didUpdateValueForCharacteristic:error: ` 方法,如果这个被成功的获取,你就可访问`特征`的`value`属性获取这个值,像这样
-
(void)peripheral:(CBPeripheral *)peripheral
didUpdateValueForCharacteristic:(CBCharacteristic *)characteristic
error:(NSError *)error {NSData *data = characteristic.value;
// parse the data as needed
...```
注意:
并不是所有的特征都有读的权限,你要检测这个特征是否有读的权限可以通过特征的properties
属性中CBCharacteristicPropertyRead
Key ,如果你试图读取一个不可度的特征值,那么在peripheral:didUpdateValueForCharacteristic:error:
方法中将会传入一个合适的错误
2. 订阅一个特征的值
尽管在某些情况下你可以通过readValueForCharacteristic:
很方便的读取一个特征的值,但是对于一个经常变化的值这不是一中高效
的方式.大部分特征的值的变化的--例如心率是每时每刻都在变化,此时你应该订阅它.当你订阅一个特征的值的时候,你将会收到一个通知,当外设的值改变的时候
你可以订阅一个特征的值,通过调用CBPeripheral
的setNotifyValue:forCharacteristic:
第一个参数传入YES
,像这样
[peripheral setNotifyValue:YES forCharacteristic:interestingCharacteristic];```
当你尝试订阅(或取消订阅)一个特征的值时,外设的代理方法`peripheral:didUpdateNotificationStateForCharacteristic:error: ` 就会被调用.如果订阅请求因任何原因失败,这个代理方法中都会通过`error`告诉你错误的原因.例如:
-
(void)peripheral:(CBPeripheral *)peripheral
didUpdateNotificationStateForCharacteristic:(CBCharacteristic *)characteristic
error:(NSError *)error {if (error) {
NSLog(@"Error changing notification state: %@",
[error localizedDescription]);
}
...
> `注意:` 不是所有特征都可以订阅他们的值,你可以通过` Characteristic ` 的`Properties` 属性来判断这个特征是否支持订阅.
当你成功订阅一个特征的值后,外设将会在它的值改变的时候通知你.每次值的改变都会调用代理的`peripheral:didUpdateValueForCharacteristic:error: `方法,为了获取这个这你需要实现这个代理方法.
####7.写入一个特征的值
有些时候可能需要需要写入一个特征的值,比如你app和基于蓝牙4.0的自动温度调节器交互,你可能需要提供一个值来设置室内温度,如果这个特征值是可写的,你通过`CBPeripheral ` 的 ` writeValue:forCharacteristic:type: ` 方法,第一个参数传入一个`NSData`对象,像这样:
NSLog(@"Writing value for characteristic %@", interestingCharacteristic);
[peripheral writeValue:dataToWrite forCharacteristic:interestingCharacteristic
type:CBCharacteristicWriteWithResponse];
当你写入特征的值时,你需要指定按照什么类型写入,在上面的例子中指定是`CBCharacteristicWriteWithResponse` 它告诉外设需要让你的app知道是否写入成功.
外设通过调用代理对象的` peripheral:didWriteValueForCharacteristic:error: ` 来响应指定类型参数`CBCharacteristicWriteWithResponse`写入请求.任何原因导致的写入失败,你都会收到一个错误对象,它描述了错误的原因,例如
- (void)peripheral:(CBPeripheral *)peripheral
didWriteValueForCharacteristic:(CBCharacteristic *)characteristic
error:(NSError *)error {
if (error) {
NSLog(@"Error writing characteristic value: %@",
[error localizedDescription]);
}
...
> `注意:`特征可能只允许以特定的类类型写入,想知道特征都支持那种类型的写入可以遍历`Characteristic`的 `properties` 属性.
####附录. 中心设备流程
![中心设备流程.jpg](http:https://img.haomeiwen.com/i321489/76d3201f640ad14e.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
网友评论