[git] BabyBluetooth

阅读量：5878 次

发布时间：2019-06-19

本文共 5151 字，大约阅读时间需要 17 分钟。

https://github.com/coolnameismy/BabyBluetooth.git

The easiest way to use Bluetooth (BLE )in ios,even bady can use. 简单易用的蓝牙库，基于CoreBluetooth的封装，并兼容ios和mac osx.

为什么使用它？

1：基于原生CoreBluetooth框架封装的轻量级的开源库，可以帮你更简单地使用CoreBluetooth API。

2：CoreBluetooth所有方法都是通过委托完成，代码冗余且顺序凌乱。BabyBluetooth使用block方法，可以重新按照功能和顺序组织代码，并提供许多方法减少蓝牙开发过程中的代码量。

3:链式方法体，代码更简洁、优雅。

4:通过channel切换区分委托调用，并方便切换

5:便利的工具方法

6:完善的文档，且项目处于活跃状态，不断的更新中

7:github上star最多的纯Bluetooch类库

8:包含多种类型的demo和ios蓝牙开发教程

9:同时支持蓝牙设备中心模式和外设模式（central model and peripheral model）

当前版本 0.5.0

详细文档请参考wiki The full documentation of the project is available on its wiki.

english readme link,please click it!

Table Of Contents

QuickExample

如何安装

如何使用

示例程序说明

兼容性

后期更新

蓝牙学习资源

期待

QuickExample

中心模式 central model

app作为中心，连接其他BLE4.0外设

//导入.h文件和系统蓝牙库的头文件

import "BabyBluetooth.h"

//定义变量

BabyBluetooth *baby;

-(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 setFilterOnDiscoverPeripherals:^BOOL(NSString *peripheralName) {    //设置查找规则是名称大于1 ， the search rule is peripheral.name length > 1    if (peripheralName.length >1) {        return YES;    }    return NO;}];//.......

}

更多蓝牙操作方法和委托请参考wiki

中心模式使用示例请参考:BabyBluetoothAppDemo

外设模式 peripheral model

app模拟一个，BLE4.0外设，可以被其他设备连接和使用

模拟一个有2个service和6个characteristic的外设

//导入.h文件和系统蓝牙库的头文件

import "BabyBluetooth.h"

//定义变量

BabyBluetooth *baby;

-(void)viewDidLoad {

[super viewDidLoad];

//配置第一个服务s1CBMutableService *s1 = makeCBService(@"FFF0");//配置s1的3个characteristicmakeCharacteristicToService(s1, @"FFF1", @"r", @"hello1");//读makeCharacteristicToService(s1, @"FFF2", @"w", @"hello2");//写makeCharacteristicToService(s1, genUUID(), @"rw", @"hello3");//可读写,uuid自动生成makeCharacteristicToService(s1, @"FFF4", nil, @"hello4");//默认读写字段makeCharacteristicToService(s1, @"FFF5", @"n", @"hello5");//notify字段//配置第一个服务s2CBMutableService *s2 = makeCBService(@"FFE0");makeStaticCharacteristicToService(s2, genUUID(), @"hello6", [@"a" dataUsingEncoding:NSUTF8StringEncoding]);//一个含初值的字段，该字段权限只能是只读//实例化babybaby = [BabyBluetooth shareBabyBluetooth];//配置委托[self babyDelegate];//启动外设baby.bePeripheral().addServices(@[s1,s2]).startAdvertising();

}

//设置蓝牙外设模式的委托

-(void)babyDelegate{

//设置添加service委托 | set didAddService block[baby peripheralModelBlockOnPeripheralManagerDidUpdateState:^(CBPeripheralManager *peripheral) {    NSLog(@"PeripheralManager trun status code: %ld",(long)peripheral.state);}];//设置添加service委托 | set didAddService block[baby peripheralModelBlockOnDidStartAdvertising:^(CBPeripheralManager *peripheral, NSError *error) {    NSLog(@"didStartAdvertising !!!");}];//设置添加service委托 | set didAddService block[baby peripheralModelBlockOnDidAddService:^(CBPeripheralManager *peripheral, CBService *service, NSError *error) {    NSLog(@"Did Add Service uuid: %@ ",service.UUID);}];//.....

}

更多蓝牙外设模式委托请参考wiki

中心模式使用示例请参考:BluetoothStubOnIOS

如何安装

1 手动安装

step1:将项目Classes/objc 文件夹中的文件直接拖入你的项目中即可

step2:导入.h文件

import "BabyBluetooth.h"

2 cocoapods

step1:add the following line to your Podfile:

pod 'BabyBluetooth','~> 0.5.0'

step2:导入.h文件

import "BabyBluetooth.h"

如何使用

用法请见wiki

示例程序说明

BabyBluetoothExamples/BabyBluetoothAppDemo :一个类似lightblue的程序，蓝牙操作全部使用BabyBluetooth完成。功能：

1：扫描周围设备

2：连接设备，扫描设备的全部services和characteristic

3：显示characteristic，读取characteristic的value，和descriptors以及Descriptors对应的value

4：写0x01到characteristic

5：订阅/取消订阅 characteristic的notify

BabyBluetoothExamples/BluetoothStubOnIOS : 一个iOS程序，启动后会用手机模拟一个外设，提供2个服务和若干characteristic。该程序作为Babybluetooth 外设模式使用的示例程序

BabyBluetoothExamples/BabyBluetoothOSDemo :一个mac os程序，因为os和ios的蓝牙底层方法都一样，所以BabyBluetooth可以ios/os通用。但是os程序有个好处就是直接可以在mac上跑蓝牙设备，不像ios，必须要真机才能跑蓝牙设备。所以不能真机调试时可以使用os尝试蓝牙库的使用。

功能：

1：扫描周围设备、连接设备、显示characteristic，读取characteristic的value，和descriptors以及Descriptors对应的value的委托设置，并使用nslog打印信息。

BabyBluetoothExamples/BluetoothStubOnOSX :一个mac os程序，该程序可以作为蓝牙外设使用，解决学习蓝牙时没有外设可用的囧境，并且可以作为peripheral model模式的学习示例。改程序用swift编码。

功能：

1：作为蓝牙外设使用，可以被发现，连接，读写，订阅

2：提供1个service，包含了3个characteristic，分别具有读、读写、订阅功能

兼容性

蓝牙4.0，也叫做ble，ios6以上可以自由使用。

os和ios通用

蓝牙设备相关程序必须使用真机才能运行。如果不能使用真机调试的情况，可以使用os程序调试蓝牙。可以参考示例程序中的BabyBluetoothOSDemo

本项目和示例程序是使用ios 8.3开发，使用者可以自行降版本，但必须大于6.0

后期更新