
BabyBluetooth 是一個基於 CoreBluetooth 封裝的輕量級藍牙庫,同時兼容 iOS 與 Mac OS X,目標只有一個:讓藍牙開發變簡單。
原生 CoreBluetooth 全靠 delegate 串流程,一段完整鏈路往往要散落在十幾個回調方法裡,代碼冗余且順序凌亂。BabyBluetooth 改用 block,可以按功能與執行順序重新組織代碼,並提供大量便捷方法減少樣板。
支持鏈式調用,寫法更緊湊優雅。
通過 channel 機制隔離不同頁面或組件的回調,多處藍牙邏輯互不干擾,也能隨時切換。
作者當時連續幾個月都在做藍牙項目,越寫越覺得原生 API 的語句分佈得四處都是,一整條鏈路下來要在回調裡不停調用再進入下一個回調,可讀性很差。於是他動手封裝了 BabyBluetooth,讓 CoreBluetooth 的使用變得更直觀。項目上線後關注度持續攀升,從最初的 96 star 一路增長到 880 star。
藍牙庫寫起來不容易,希望社區多多支持、多多 star。
使用中遇到 BUG 或功能缺失,歡迎直接提 Issues。
這只是開了個頭,可優化空間還很大,歡迎通過 Pull Request 一起交流成長。
導入頭文件後,初始化、設置回調、直接開始掃描,三步行完:
#import "BabyBluetooth.h"
- (void)viewDidLoad {
[super viewDidLoad];
baby = [BabyBluetooth shareBabyBluetooth];
[self babyDelegate];
// 設置完回調即可使用,無需等待 CBCentralManagerStatePoweredOn
baby.scanForPeripherals().begin();
}回調部分按「掃描到設備 → 連接成功 → 發現服務 → 發現特征值 → 讀取值 → 讀描述」的順序集中書寫,每個環節都是一個 block,讀起來就是一遍藍牙交互流程:
[baby setBlockOnDiscoverToPeripherals:^(CBCentralManager *central, CBPeripheral *peripheral, NSDictionary *advertisementData, NSNumber *RSSI) {
NSLog(@"搜索到了設備:%@", peripheral.name);
}];
[baby setBlockOnConnected:^(CBCentralManager *central, CBPeripheral *peripheral) {
NSLog(@"設備:%@--連接成功", peripheral.name);
}];
[baby setBlockOnDiscoverServices:^(CBPeripheral *peripheral, NSError *error) {
for (CBService *service in peripheral.services) {
NSLog(@"搜索到服務:%@", service.UUID.UUIDString);
}
}];
[baby setBlockOnDiscoverCharacteristics:^(CBPeripheral *peripheral, CBService *service, NSError *error) {
for (CBCharacteristic *c in service.characteristics) {
NSLog(@"charateristic name is :%@", c.UUID);
}
}];如果只想連特定設備,還可以掛上過濾器,比如「名稱長度大於 1」或者「只連第一個以 AAA 開頭的設備」:
[baby setDiscoverPeripheralsFilter:^BOOL(NSString *peripheralsFilter) {
return peripheralsFilter.length > 1;
}];
__block BOOL isFirst = YES;
[baby setFilterOnConnetToPeripherals:^BOOL(NSString *peripheralName) {
if (isFirst && [peripheralName hasPrefix:@"AAA"]) {
isFirst = NO;
return YES;
}
return NO;
}];原生 CoreBluetooth 要走完「啟動 → 狀態回調 → 掃描 → 掃描回調 → 連接 → 連接回調 → 發現服務 → 服務回調 → 發現特征值 → 特征值回調 → 讀值 → 讀值回調 → 讀描述……」,層層嵌套。而 BabyBluetooth 一句話搞定:
// 掃描 → 連接 → 發現服務 → 發現特征值並讀名/值/屬性 → 讀描述
baby.scanForPeripherals()
.connectToPeripheral()
.discoverServices()
.discoverCharacteristics()
.readValueForCharacteristic()
.discoverDescriptorsForCharacteristic()
.readValueForDescriptors()
.begin();除此之外,所有回調都緊湊地聚在一起,維護時不必在多個文件位置之間來回跳。快速示例中未涉及 channel,一旦引入 channel,多個頁面或組件的藍牙模塊就能各自獨立、互不干擾,實際項目裡體會會更明顯。更多 API 與示例可移步項目主頁。
iOS 藍牙開發(三):App 作為外設被連接的實現
iOS 藍牙開發(二):iOS 連接外設的代碼實現
iOS 藍牙開發(一):藍牙相關基礎知識