CoreBluetooth系列教程(二):蓝牙常用API

上篇讲了蓝牙相关的基本概念,现在结合代码讲讲具体实现。首先需要创建一个CBCentralManager对象,检查蓝牙的状态,只有蓝牙为poweredOn状态,才可进行下一步连接动作。

CBCentralManager初始化

先导入`CoreBluetooth` 框架
 var centralManager: CBCentralManager!
    //设置deleagte、queue、可选参数options,options可以为nil,也可设置CBCentralManagerOptionShowPowerAlertKey蓝牙提醒弹窗和CBCentralManagerOptionRestoreIdentifierKey字符串(一个唯一的标识符,用来恢复蓝牙连接的,在后台的长连接中可能用到)
    override init() {
        super.init()
        
        self.centralManager = CBCentralManager(delegate: self, queue: nil)
    }
    
    init(stateRestoreIdentifier: String) {
        super.init()
        
        self.centralManager = CBCentralManager(delegate: self, queue: nil, options: [CBCentralManagerOptionRestoreIdentifierKey: stateRestoreIdentifier])
    }

主要API的使用

  // 获取已连接的设备
    open func retrieveConnectedPeripherals(withServices serviceUUIDs: [CBUUID]) -> [CBPeripheral]
  // 扫描设备(serviceUUIDs:需要扫描的设备serviceUUID数组,设置为nil,则扫描附近所有蓝牙设备,通常为了提高效率,填入特定的serviceUUID数组)
   open func scanForPeripherals(withServices serviceUUIDs: [CBUUID]?, options: [String : Any]? = nil)
  // 停止扫描
    open func stopScan()
  // 连接设备
    open func connect(_ peripheral: CBPeripheral, options: [String : Any]? = nil)
 // 断开连接
    open func cancelPeripheralConnection(_ peripheral: CBPeripheral)

CBCentralManagerDelegate的回调

基本所有的回调都在Delegate方法里处理

// 蓝牙状态变更
 func centralManagerDidUpdateState(_ central: CBCentralManager) {
        switch central.state.rawValue {
        case 0: // .unknown
            
        case 1: // .resetting
            
        case 2: // .unsupported
            
        case 3: // .unauthorized
            
        case 4: // .poweredOff(蓝牙关闭)
            
        case 5: // .poweredOn(蓝牙打开)
            
        default:
            fatalError("Unsupported BLE CentralState")
        }
    }

// 扫描到设备  advertisementData:广播包数据 RSSI:信号强度
  func centralManager(_ central: CBCentralManager,
                        didDiscover peripheral: CBPeripheral,
                        advertisementData: [String: Any],
                        rssi RSSI: NSNumber) {
        
    }
// 设备成功连接
 func centralManager(_ central: CBCentralManager, didConnect peripheral: CBPeripheral) {
       
    }

// 设备连接失败
optional func centralManager(_ central: CBCentralManager, didFailToConnect peripheral: CBPeripheral, error: Error?)  {

}
// 设备连接断开
 func centralManager(_ central: CBCentralManager, didDisconnectPeripheral peripheral: CBPeripheral, error: Error?) {

}

与设备连接成功后,会生成一个CBPeripheral对象,用来操作设备数据的读写和监听等。

CBPeripheral的使用

public enum CBPeripheralState : Int, @unchecked Sendable {

    
    case disconnected = 0 // 连接断开

    case connecting = 1 // 正在连接中

    case connected = 2 // 已连接

    @available(watchOS 2.0, *)
    case disconnecting = 3 //断开连接中
}
// 设备写入服务类型,注意要根据设备读取的特征值来写入,否则写入报错。
public enum CBCharacteristicWriteType : Int, @unchecked Sendable {

    
    case withResponse = 0

    case withoutResponse = 1
}
open class CBPeripheral : CBPeer {
  // 蓝牙名称
    open var name: String? { get }
 // 信号强度
    open var rssi: NSNumber? { get }
// 连接状态
    open var state: CBPeripheralState { get }
// 扫描到的设备服务
    open var services: [CBService]? { get }
// 写入方式是withResponse还是withoutResponse
    open var canSendWriteWithoutResponse: Bool { get }
// 连接成功,检索当前连接的信号强度,回调方法:peripheral:didReadRSSI:error:
    open func readRSSI()
// 扫描设备可用的服务,serviceUUIDs 需要扫描的设备的服务的id,如果为nil,则扫描所有的服务,回调方法:peripheral:didDiscoverServices:
    open func discoverServices(_ serviceUUIDs: [CBUUID]?)
// includedServiceUUIDs  需要发现的服务service中的服务id列表,如果为nil,则扫描服务内所有的服务,较慢,不推荐使用。回调方法:peripheral:didDiscoverIncludedServicesForService:error:
    open func discoverIncludedServices(_ includedServiceUUIDs: [CBUUID]?, for service: CBService) 
//  characteristicUUIDs  数组,内含需要被发现的所有特征值类型,如果为nil,则为所有特征值。回调方法为:peripheral:didDiscoverCharacteristicsForService:error:
    open func discoverCharacteristics(_ characteristicUUIDs: [CBUUID]?, for service: CBService)
// characteristic   需要读取的服务特征值,回调方法:  peripheral:didUpdateValueForCharacteristic:error:
    open func readValue(for characteristic: CBCharacteristic)
// 获取向一个写服务可发送的最大字节数
    open func maximumWriteValueLength(for type: CBCharacteristicWriteType) -> Int
//   data:需要写入的数据 characteristic:写服务特征  type: 写服务的 类型(有/无响应),需要注意的是,传入的type是根据characteristic!.properties.rawValue & CBCharacteristicProperties.writeWithoutResponse.rawValue 来决定,否则随意传入type会导致写入失败。
    open func writeValue(_ data: Data, for characteristic: CBCharacteristic, type: CBCharacteristicWriteType)
// 根据characteristic的properties来设置,若为true,说明只要有数据更新就会回调新数据。
    open func setNotifyValue(_ enabled: Bool, for characteristic: CBCharacteristic)
}

CBPeripheralDelegate的回调

// 设备名称更新
optional func peripheralDidUpdateName(_ peripheral: CBPeripheral) {

}
// peripheral :需要更新的设备 invalidatedServices:失效的服务
    optional func peripheral(_ peripheral: CBPeripheral, didModifyServices invalidatedServices: [CBService]) {

}
// peripheral :需要更新的设备 error:出现错误的原因。readRSSI的回调方法。
    optional func peripheralDidUpdateRSSI(_ peripheral: CBPeripheral, error: Error?) {

}
// peripheral :需要更新的设备 RSSI:设备的RSSI。readRSSI的回调方法
    optional func peripheral(_ peripheral: CBPeripheral, didReadRSSI RSSI: NSNumber, error: Error?) {

}
// peripheral:扫描到的设备  error :错误原因。discoverServices的回调方法。
    optional func peripheral(_ peripheral: CBPeripheral, didDiscoverServices error: Error?) {

}
// peripheral:当前设备 service : 设备服务  error:错误原因。 discoverIncludedServices:forService的回调
    optional func peripheral(_ peripheral: CBPeripheral, didDiscoverIncludedServicesFor service: CBService, error: Error?) {

}
// peripheral:当前设备 service: 设备服务 error:错误原因。discoverCharacteristics:forService的回调
    optional func peripheral(_ peripheral: CBPeripheral, didDiscoverCharacteristicsFor service: CBService, error: Error?) {

}
//  peripheral:当前设备 characteristic:设备特征 error:错误原因。当前设备特征值有更新就回调。
    optional func peripheral(_ peripheral: CBPeripheral, didUpdateValueFor characteristic: CBCharacteristic, error: Error?) {

}
// peripheral:当前设备 characteristic:设备特征 error:错误原因。writeValue:forCharacteristic:type的回调
    optional func peripheral(_ peripheral: CBPeripheral, didWriteValueFor characteristic: CBCharacteristic, error: Error?) {

}
// peripheral:当前设备 characteristic:设备特征 error:错误原因。setNotifyValue:forCharacteristic的回调。
    optional func peripheral(_ peripheral: CBPeripheral, didUpdateNotificationStateFor characteristic: CBCharacteristic, error: Error?) {

}

一个设备有多个service,每个service都有多个characteristic,一层层找下来找到我们需要操作的characteristic,然后按硬件的要求进行读写和监听等操作。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,496评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,407评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,632评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,180评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,198评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,165评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,052评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,910评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,324评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,542评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,711评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,424评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,017评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,668评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,823评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,722评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,611评论 2 353

推荐阅读更多精彩内容