BabyBluetooth 是一個最簡單易用的藍牙庫,基于CoreBluetooth的封裝,并相容ios和mac osx。
特色:
- 基于原生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