BabyBluetooth 是一個最簡單易用的藍牙庫,基於CoreBluetooth的封裝,並兼容iOS和Mac OS X。
特色:
基於原生CoreBluetooth框架封裝的輕量級的開源庫,可以幫你更簡單地使用CoreBluetooth API。
CoreBluetooth所有方法都是通過委托完成,代碼冗余且順序凌亂。BabyBluetooth使用block方法,可以重新按照功能和順序組織代碼,並提供許多方法減少藍牙開發過程中的代碼量。
鏈式方法體,代碼更簡潔、優雅。
通過channel切換區分委托調用,並方便切換
來源
最近幾個月都在做藍牙項目,用CoreBluetooch感覺語句寫的到處都是,不優雅。一整條鏈下來要近10幾個委托方法,並且不斷的在委托方法中調用方法再進入其他的委托,導致 代碼很零散。因此我就想讓coreBlueTooth使用更簡單,語法更優雅,所以開始寫這個BabyBluetooch藍牙庫。
剛開始寫BabyBluetooth時,只有目標,也不值得如何實現,於是一步步安裝目標去實現,也遇到過很多問題,慢慢的也想出了解決方案,並一步步直到9月7日早晨,才算完成了 第一個可以用的版本。對於藍牙這種在app中亮相率不高的功能,github上ios使用的操作藍牙的庫最多就100來個star,然後BabyBluetooch2天的時間內已經有了15個star和10個fork, 已經相當不錯了,很快就有越來越多的人參與到項目中,issues,pull request等等。這些都是個人成長和項目成長非常寶貴的資源。
更新於:20150916,現在BabyBluetooth 已經有了96個star
期待
藍牙庫寫起來很辛苦,希望大家可以多多支持,多多star。BabyBluetooth主頁
如果在使用過程中遇到BUG,或發現功能不夠用,希望你能Issues我,謝謝
期待大家也能一起為BabyBluetooth輸出代碼,這裡我只是給BabyBluetooth開了個頭,他可以增加和優化的地方還是非常多。也期待和大家在Pull Requests一起學習,交流,成長。
Quick Example
//導入.h文件和系統藍牙庫的頭文件 #import "BabyBluetooth.h" -(void)viewDidLoad { [super viewDidLoad]; //初始化BabyBluetooth 藍牙庫 baby = [BabyBluetooth shareBabyBluetooth]; //設置藍牙委托 [self babyDelegate]; //設置委托後直接可以使用,無需等待CBCentralManagerStatePoweredOn狀態 baby.scanForPeripherals().begin() } //藍牙網關初始化和委托方法設置 -(void)babyDelegate{ //設置掃描到設備的委托 [baby setBlockOnDiscoverToPeripherals:^(CBCentralManager *central, CBPeripheral *peripheral, NSDictionary *advertisementData, NSNumber *RSSI) { NSLog(@"搜索到了設備:%@",peripheral.name); }]; //設置設備連接成功的委托 [baby setBlockOnConnected:^(CBCentralManager *central, CBPeripheral *peripheral) { NSLog(@"設備:%@--連接成功",peripheral.name); }]; //設置發現設備的Services的委托 [baby setBlockOnDiscoverServices:^(CBPeripheral *peripheral, NSError *error) { for (CBService *service in peripheral.services) { NSLog(@"搜索到服務:%@",service.UUID.UUIDString); } }]; //設置發現設service的Characteristics的委托 [baby setBlockOnDiscoverCharacteristics:^(CBPeripheral *peripheral, CBService *service, NSError *error) { NSLog(@"===service name:%@",service.UUID); for (CBCharacteristic *c in service.characteristics) { NSLog(@"charateristic name is :%@",c.UUID); } }]; //設置讀取characteristics的委托 [baby setBlockOnReadValueForCharacteristic:^(CBPeripheral *peripheral, CBCharacteristic *characteristics, NSError *error) { NSLog(@"characteristic name:%@ value is:%@",characteristics.UUID,characteristics.value); }]; //設置發現characteristics的descriptors的委托 [baby setBlockOnDiscoverDescriptorsForCharacteristic:^(CBPeripheral *peripheral, CBCharacteristic *characteristic, NSError *error) { NSLog(@"===characteristic name:%@",characteristic.service.UUID); for (CBDescriptor *d in characteristic.descriptors) { NSLog(@"CBDescriptor name is :%@",d.UUID); } }]; //設置讀取Descriptor的委托 [baby setBlockOnReadValueForDescriptors:^(CBPeripheral *peripheral, CBDescriptor *descriptor, NSError *error) { NSLog(@"Descriptor name:%@ value is:%@",descriptor.characteristic.UUID, descriptor.value); }]; //過濾器 //設置查找設備的過濾器 [baby setDiscoverPeripheralsFilter:^BOOL(NSString *peripheralsFilter) { //設置查找規則是名稱大於1 , the search rule is peripheral.name length > 1 if (peripheralsFilter.length >1) { return YES; } return NO; }]; //設置連接的設備的過濾器 __block BOOL isFirst = YES; [baby setFilterOnConnetToPeripherals:^BOOL(NSString *peripheralName) { //這裡的規則是:連接第一個AAA打頭的設備 if(isFirst && [peripheralName hasPrefix:@"AAA"]){ isFirst = NO; return YES; } return NO; }]; }
CoreBluetooch中實現上掃描,連接,發現服務和characteristic以及它的值相關方法調用是很麻煩啰嗦凌亂的。如下: centralManager啟動->狀態委托->調用掃描方法->進入掃描到設備的委托->調用連接設備方法->進入連接到設備的委托->發現服務方法->發現服務委托-> 發現characteristic方法->發現characteristic委托->讀characteristic的value->讀characteristic的value的委托->讀description,讀description的value-> ....的委托
而BabyBluetooth只需要一句話就執行了上面的內容。
//掃描設備 然後讀取服務,然後讀取characteristics名稱和值和屬性,獲取characteristics對應的description的名稱和值 baby.scanForPeripherals().connectToPeripheral().discoverServices() .discoverCharacteristics().readValueForCharacteristic().discoverDescriptorsForCharacteristic() .readValueForDescriptors().begin();
另一方面,BabyBluetooth所有的委托方法都緊湊的聚在了一起。此外,快速示例中沒有包括channel的使用,如果包括了channel,那麼ios幾個頁面或者組件的藍牙 調用模塊都可以寫在一起,看起來就覺得很方便。
關於更多BabyBluetooth的介紹和使用示例已經api,請移步到BabyBluetooth主頁查看
iOS 藍牙開發(一)藍牙相關基礎知識
iOS 藍牙開發(二)iOS 連接外設的代碼實現
iOS 藍牙開發(三)app作為外設被連接的實現