
BabyBluetooth 是目前最為直覺易上手的藍牙庫之一,它在 CoreBluetooth 之上做了一層封裝,同時兼容 iOS 與 Mac OS X。
它的幾個特點
輕量級開源庫,建立在原生 CoreBluetooth 框架之上,讓你調用 CoreBluetooth API 時更省心。
CoreBluetooth 的全部能力都靠 delegate 回呼完成,程式碼既冗長又順序散亂。BabyBluetooth 改用 block 風格,可以依功能和執行次序重新組織程式碼,並提供大量便捷方法減少樣板程式碼。
支援鏈式語法,寫起來更簡潔優雅。
透過 channel 機制切分 delegate 回呼的作用範圍,切換起來很方便。
緣起
過去幾個月我一直在做藍牙相關的專案,用原生 CoreBluetooth 的感覺是程式碼滿地都是、一點也不優雅。完整跑一條鏈路要經手十幾個 delegate 方法,而且得在一個 delegate 裡呼叫方法、再鑽進下一個 delegate,程式碼被切得零零散散。於是我就想:能不能讓 CoreBluetooth 用起來更輕鬆、語法更漂亮?BabyBluetooth 就是這樣誕生的。
剛起步的時候,我腦中並沒有清晰的實現路徑,只能一邊朝目標摸索、一邊踩坑。遇到的問題不少,但也都慢慢找到了解法。一路折騰到 9 月 7 日清晨,第一個真正能跑的版本才算成形。藍牙在 App 裡並不算高頻功能,那時 GitHub 上 iOS 藍牙類庫的 star 數普遍也就一百上下;而 BabyBluetooth 上線兩天就收穫了 15 個 star 和 10 個 fork,這個成績已經相當不錯。此後參與者越來越多,issues、pull request 絡繹不絕——這些都是個人與專案成長過程中彌足珍貴的養分。
更新於 2015 年 9 月 16 日:BabyBluetooth 此時已累計 96 個 star。
期待
寫一個藍牙庫著實辛苦,希望大家多多支持、點個 star。BabyBluetooth 主頁
使用中若遇到 BUG,或發現功能不夠用,歡迎直接提 Issues 告訴我。
也期待更多朋友一起來提交程式碼。我在這裡只是開了個頭,可以增強和優化的地方還多得是,歡迎透過 Pull Request 一起交流、一起成長。
快速上手示例
//導入.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; }]; }在原生 CoreBluetooth 裡,要完成「掃描 → 連接 → 發現服務 → 發現 characteristic 及其值」這一整條流程,呼叫關係繁瑣又零散,大致是這樣一路跳下去的:centralManager 啟動 → 狀態回呼 → 呼叫掃描方法 → 進入掃描到設備的回呼 → 呼叫連接方法 → 進入連接成功的回呼 → 呼叫發現服務 → 進入服務回呼 → 呼叫發現 characteristic → 進入回呼 → 讀取 characteristic 的 value → 進入讀值回呼 → 讀取 description 及其 value → ……回呼無窮無盡。
而換成 BabyBluetooth,上面這一切只需要一句話。
//掃描設備 然後讀取服務,然後讀取characteristics名稱和值和屬性,獲取characteristics對應的description的名稱和值 baby.scanForPeripherals().connectToPeripheral().discoverServices() .discoverCharacteristics().readValueForCharacteristic().discoverDescriptorsForCharacteristic() .readValueForDescriptors().begin();
另一方面,BabyBluetooth 把所有 delegate 方法集中排放在一處,閱讀起來輕鬆不少。此外,上面的快速示例並未展示 channel 的用法;一旦用上 channel,同一個 App 中多個頁面或組件的藍牙呼叫模組就能寫在一起,可讀性會更好。
關於 BabyBluetooth 更完整的介紹、使用示例與 API 說明,歡迎移步專案主頁查看。
iOS 藍牙開發(一)藍牙相關基礎知識
iOS 藍牙開發(二)iOS 連接外設的程式碼實現
iOS 藍牙開發(三)App 作為外設被連接的實現