SuperAPI AI 工具集

accessorysetupkit

智能体与模型

查看项目

更新于 10-16 05:52

技能介绍

用途:在 iOS 18+ 上使用 AccessorySetupKit 发现并配置蓝牙与 Wi-Fi 配件,通过系统级隐私保护选择器完成授权,避免大范围的系统蓝牙授权提示;授权后将通信交给 CoreBluetooth 或 NetworkExtension 处理。

主要能力:ASAccessorySession 管理会话与配件事件;ASDiscoveryDescriptor 定义扫描匹配条件(蓝牙服务 UUID、名称子串、公司标识、范围;Wi-Fi 的 ssid 或 ssidPrefix);ASPickerDisplayItem 配置系统选择器的展示项。蓝牙需在 Info.plist 声明 NSAccessorySetupSupports(含 Bluetooth 和/或 WiFi)、NSAccessorySetupBluetoothServices、NSAccessorySetupBluetoothNames、NSAccessorySetupBluetoothCompanyIdentifiers,且必须与描述符严格一致,否则运行时崩溃。

使用方式:先在 Info.plist 添加匹配的配置键;定义蓝牙或 Wi-Fi 描述符;激活 ASAccessorySession 并调用 showPicker(for:) 呈现系统选择器;选择完成后,蓝牙用 CBCentralManager.retrievePeripherals(withIdentifiers:) 获取外设,Wi-Fi 用 NEHotspotConfigurationManager 连接。不需要通用蓝牙扫描权限提示,至少授权一个配件后 CBCentralManager 进入 poweredOn。

限制与常见错误:未在 Info.plist 声明的 UUID、名称或公司 ID 会导致崩溃;Wi-Fi 描述符只能设置 ssid 或 ssidPrefix 之一;不应调用 scanForPeripherals();需处理 .sessionReset 以应对守护进程重启;选择器完成仅表示授权而非已连接,需再发起连接。资料未提供价格、平台版本细节或完整扩展模式代码,仅给出参考文件说明。