SuperAPI AI 工具集

core-bluetooth

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:在 iOS 上实现蓝牙低功耗(BLE)通信,可用 CBCentralManager 连接外设(中心角色),或用 CBPeripheralManager 对外广播(外设角色)。目标平台为 Swift 6.3 / iOS 26+。

主要能力:包含权限与后台模式、中心与外设角色、核心通信约定、状态恢复与 MTU、按任务路由、常见错误与审查清单。中心角色负责扫描、连接并消费 GATT 服务;外设角色负责发布服务、广播并响应请求。数据读写使用 readValue(for:)/writeValue(:for:type:) 与外设的 respond(to:withResult:),通知用 setNotifyValue(true, for:) 与 updateValue(:for:onSubscribedCentrals:)。

必要用法:Info.plist 声明 NSBluetoothAlwaysUsageDescription;后台执行需配置 UIBackgroundModes 的 bluetooth-central 或 bluetooth-peripheral。中心角色扫描用 scanForPeripherals(withServices:options:),外设角色用 startAdvertising(:)。必须在 centralManagerDidUpdateState(:) 报告 .poweredOn 后再调用扫描、连接或广播;发现的 CBPeripheral 需强引用,否则连接会立即断开;后台扫描必须带服务 CBUUID 过滤;discoverServices 与 discoverCharacteristics 应传具体 [CBUUID] 而非 nil;写入类型需与特征属性匹配。状态恢复通过 CBCentralManagerOptionRestoreIdentifierKey 与 centralManager(_:willRestoreState:) 处理;发送大量数据前用 peripheral.maximumWriteValueLength(for:) 检查;默认 BLE MTU 为 23 字节(有效载荷 20 字节)。

限制与说明:资料未提供价格、平台支持以外的信息或具体安装步骤;其余细节(如 L2CAP、重连策略、写流控等)在关联文档中展开。