SuperAPI AI 工具集

core-bluetooth

编程与开发

查看项目

更新于 10-15 23:34

技能介绍

用途:在 iOS 应用中实现蓝牙低功耗(BLE)通信,包括中心角色(扫描并连接外设)与外设角色(广播本地服务),并处理后台运行与状态恢复。目标为 Swift 6.3 / iOS 26+。

主要能力:创建 CBCentralManager 扫描、连接外设;发现服务与特征;读取、写入与订阅通知;用 CBPeripheralManager 发布服务并广播;配置后台 BLE;实现状态恢复。文档还列出常见错误与审查清单。

必要用法:在 Info.plist 添加 NSBluetoothAlwaysUsageDescription;后台扫描需 UIBackgroundModes 的 bluetooth-central,后台广播需 bluetooth-peripheral。创建管理器后必须等待 centralManagerDidUpdateState 返回 .poweredOn 再扫描。扫描应指定服务 UUID,生产环境避免传 nil。发现外设后需用强引用保留,否则会被释放导致连接静默失败。设置 CBPeripheralDelegate 后再调用 discoverServices。读写或订阅前检查特征属性。写入类型需匹配 .withResponse 或 .withoutResponse。状态恢复需在创建管理器时传入恢复标识符,并实现 willRestoreState。

适用场景:心率、电池、设备信息等标准服务交互,或自定义 BLE 服务通信。

限制:资料未提供收费、价格、平台支持范围或效果数据;后台广播仅保留服务 UUID,本地名称不包含;后台扫描忽略重复项选项并批量回调。