蓝牙客户端-中心设备
本节主要内容
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];
注意
:如果第一个参数传入nil,中央管理器
返回全部找到的外设,忽略它们所支持的服务,你可以传入一个有独特UUID的服务
数组,当你指定服务的时候,中央管理器
只返回具拥有这些服务的外设.-
在你调用
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
属性.总之整个过程都是再找东西!!