SuperAPI AI 工具集

accessorysetupkit

安全与审计

查看项目

更新于 10-15 21:12

技能介绍

用途:在 iOS 18+ 应用中使用系统配件选择器,以保护隐私的方式发现并授权蓝牙或 Wi-Fi 配件,完成配对后再交给 CoreBluetooth 或 NetworkExtension 进行通信。

主要能力:通过 ASDiscoveryDescriptor 定义匹配规则(蓝牙服务 UUID、名称子串、公司标识、制造商/服务数据、蓝牙范围,或 Wi-Fi 的 ssid/ssidPrefix);用 ASPickerDisplayItem 呈现系统选择器,支持重命名、授权确认、应用内完成等设置;通过 ASAccessorySession 的事件回调处理激活、添加、变更、移除、失效及选择器呈现/关闭等状态;支持用 ASMigrationDisplayItem 从 CoreBluetooth 迁移已有配件。

必要用法:在 Info.plist 中声明 NSAccessorySetupSupports(Bluetooth 和/或 WiFi)及对应的蓝牙服务、名称、公司标识,且必须与描述符一致,否则发现时崩溃。创建并激活 ASAccessorySession,等待 .activated 后再读取 session.accessories 或调用 showPicker。选择器在独立系统进程中运行,匹配多个设备时以横向轮播展示。配件添加后,用 ASAccessory 的 bluetoothIdentifier 映射 CBPeripheral,或用 ssid 配合 NEHotspotConfiguration 加入网络。

适用场景:需要向用户展示隐私友好的配件选择界面、避免标准蓝牙/Wi-Fi 权限弹窗、或从 CoreBluetooth 迁移到新授权体系的 iOS 应用。

限制:仅适用于 iOS 18+;ssid 与 ssidPrefix 只能二选一,同时设置会崩溃;迁移完成前不得初始化 CBCentralManager;失效的会话不可复用;选择器应仅在用户操作时呈现。文档未提供具体收费、价格或平台支持范围等信息。