ios蓝牙Bluetooth库和示例app

# BabyBluetooth The easiest way to use Bluetooth (BLE )in ios,even bady can use . 一个非常容易使用的蓝牙库，当前版本v0.1 。 - 基于原生CoreBluetooth框架封装的轻量级的开源库，可以帮你更简单地使用CoreBluetooth API。 - CoreBluetooth所有方法都是通过委托完成，代码冗余且顺序凌乱。BabyBluetooth使用block方法，可以重新按照功能和顺序组织代码，并提供许多方法减少蓝牙开发过程中的代码量。 - 链式方法体，代码更简洁、优雅。 # Contents * [用法示例](#用法示例) * [Quick Example](#Quick Example) * [初始化](#初始化) * [搜索设备](#搜索设备) * [搜索并连接设备](#搜索并连接设备) * [直接连接设备](#直接连接设备) * [断开连接和取消扫描](#断开连接和取消扫描) * [services_characteristic_description](#services_characteristic_description) * [获取一个characteristic的value和全部description及description的value](#获取一个characteristic的value和全部description及description的value) * [通知方式监听一个characteristic的值](#通知方式监听一个characteristic的值) * [取消通知](#取消通知) * [委托设置](#委托设置) * [示例](#示例) * [支持的委托方法](#支持的委托方法) * [委托方法的频道channel](#委托方法的频道channel) * [默认频道](#默认频道) * [链式方法](#链式方法) * [谓词](#谓词) * [链式方法的顺序](#链式方法的顺序) * [如何安装](#如何安装) * [示例程序说明](#示例程序说明) * [程序结构](#程序结构) * [兼容性](#兼容性) * [后期更新](#后期更新) * [期待](#期待) # 用法示例 ## Quick Example ```objc //导入.h文件和系统蓝牙库的头文件 #import <CoreBluetooth/CoreBluetooth.h> #import "BabyBluetooth.h" -(void)viewDidLoad { [super viewDidLoad]; //初始化BabyBluetooth 蓝牙库 baby = [BabyBluetooth shareBabyBluetooth]; //设置蓝牙委托 [self babyDelegate]; __weak typeof(baby) weakBaby = baby; //因为蓝牙设备打开需要时间，所以只有监听到蓝牙设备状态打开后才能安全的使用蓝牙 [baby setBlockOnCentralManagerDidUpdateState:^(CBCentralManager *central) { if (central.state == CBCentralManagerStatePoweredOn) { //开始扫描设备 weakBaby.scanForPeripherals().begin(); } }]; } //蓝牙网关初始化和委托方法设置 -(void)babyDelegate{ //设置扫描到设备的委托 [baby setBlockOnDiscoverToPeripherals:^(CBCentralManager *central, CBPeripheral *peripheral, NSDictionary *advertisementData, NSNumber *RSSI) { NSLog(@"搜索到了设备:%@",peripheral.name); }]; } ``` ## 初始化 ```objc //单例初始化 推荐 BabyBluetooth *baby = [BabyBluetooth shareBabyBluetooth]; //常规初始化 BabyBluetooth *baby = [[BabyBluetooth alloc]init]; ``` ## 搜索设备 ```objc //搜索设备 baby.scanForPeripherals().begin(); //搜索设备10秒后停止 baby.scanForPeripherals().begin().stop(10); //设置搜索设备的过滤器 [baby setFilterOnDiscoverPeripherals:^BOOL(NSString *peripheralName) { //设置查找规则是名称大于1 ， the search rule is peripheral.name length > 2 if (peripheralName.length >2) { return YES; } return NO; }]; ``` ## 搜索并连接设备 ```objc /* *搜索设备后连接设备：1:先设置连接的设备的filter 2进行连接 */ //1：设置连接的设备的过滤器 __block BOOL isFirst = YES; [baby setFilterOnConnetToPeripherals:^BOOL(NSString *peripheralName) { //这里的规则是：连接第一个AAA打头的设备 if(isFirst && [peripheralName hasPrefix:@"AAA"]){ isFirst = NO; return YES; } return NO; }]; //2 扫描、连接 baby.scanForPeripherals().connectToPeripherals().begin() ``` ## 直接连接设备 ````objc baby.having(self.currPeripheral).connectToPeripherals().begin(); ```` ## 断开连接和取消扫描 ````objc //断开单个peripheral的连接 [baby cancelPeripheralConnection:peripheral];//peripheral是一个CBPeripheral的实例 //断开所有peripheral的连 [baby cancelAllPeripheralsConnection]; //取消扫描 [baby cancelScan]; ```` ## services_characteristic_description 获取设备的services、characteristic、description以及value ````objc //设置peripheral 然后读取services,然后读取characteristics名称和值和属性，获取characteristics对应的description的名称和值 //self.peripheral是一个CBPeripheral实例 baby.having(self.peripheral).connectToPeripherals().discoverServices().discoverCharacteristics() .readValueForCharacteristic().discoverDescriptorsForCharacteristic().readValueForDescriptors().begin(); ```` ## 获取一个characteristic的value和全部description及description的value ````objc //self.peripheral是一个CBPeripheral实例,self.characteristic是一个CBCharacteristic实例 baby.characteristicDetails(self.peripheral,self.characteristic); ```` ## 通知方式监听一个characteristic的值 ````objc //self.peripheral是一个CBPeripheral实例,self.characteristic是一个CBCharacteristic实例 [baby notify:self.currPeripheral characteristic:self.characteristic block:^(CBPeripheral *peripheral, CBCharacteristic *characteristics, NSError *error) { //接收到值会进入这个方法 NSLog(@"new value %@",characteristics.value); }]; ```` ## 取消通知 ````objc //self.peripheral是一个CBPeripheral实例,self.characteristic是一个CBCharacteristic实例 [baby cancelNotify:self.peripheral characteristic:self.characteristic]; ```` # 委托设置 > 每次调用方法后，都会进入到相应的委托方法。 ## 示例 ````objc //设置扫描到设备的委托 [baby setBlockOnDiscoverToPeripherals:^(CBCentralManager *central, CBPeripheral *peripheral, NSDictionary *advertisementData, NSNumber *RSSI) { NSLog(@"搜索到了设备:%@",peripheral.name); }]; //设置设备连接成功的委托 [baby setBlockOnConnected:^(CBCentralManager *central, CBPeripheral *peripheral) { //设置连接成功的block NSLog(@"设备：%@--连接成功",peripheral.name); }]; ```` 设置委托方法后执行 ````objc baby.scanForPeripherals().begin(); ```` 每当发现perihperal和连接成功后就会进入相应的委托方法。 ## 支持的委托方法 ````objc //====================================设置默认的委托方法====================================== //设备状态改变的委托 -(void)setBlockOnCentralManagerDidUpdateState:(void (^)(CBCentralManager *central))block; //找到Peripherals的委托 -(void)setBlockOnDiscoverToPeripherals:(void (^)(CBCentralManager *central,CBPeripheral *peripheral,NSDictionary *advertisementData, NSNumber *RSSI))block; //连接Peripherals成功的委托 -(void)setBlockOnConnected:(void (^)(CBCentralManager *central,CBPeripheral *peripheral))block; //设置查找服务回叫 -(void)setBlockOnDiscoverServices:(void (^)(CBPeripheral *peripheral,NSError *error))block; //设置查找到Characteristics的block -(void)setBlockOnDiscoverCharacteristics:(void (^)(CBPeripheral *peripheral,CBService *service,NSError *error))block; //设置获取到最新Characteristics值的block -(void)setBlockOnReadValueForCharacteristic:(void (^)(CBPeripheral *peripheral,CBCharacteristic *characteristic,NSError *error))block; //设置查找到Descriptors名称的block -(void)setBlockOnDiscoverDescriptorsForCharacteristic:(void (^)(CBPeripheral *peripheral,CBCharacteristic *characteristic,NSError *error))block; //设置读取到Descriptors�