天天看點

ios藍牙開發(四)BabyBluetooth藍牙庫

​​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