SuperAPI AI 工具集

accessorysetupkit

安全与审计

查看项目

更新于 10-15 23:34

技能介绍

用途:AccessorySetupKit 用于蓝牙与 Wi-Fi 配件的隐私保护式发现和配置,以系统提供的选择器替代宽泛的蓝牙/Wi-Fi 权限提示,实现按配件授权。仅负责发现与授权,配对后应用仍用 CoreBluetooth 和 NetworkExtension 通信。适用于 iOS 18+ / Swift 6.3。

主要能力:通过 ASDiscoveryDescriptor 定义匹配条件(蓝牙服务 UUID、名称子串、厂商数据、服务数据、范围;Wi-Fi 的 ssid 或 ssidPrefix),用 ASPickerDisplayItem 展示选择器,ASMigrationDisplayItem 迁移已有 CoreBluetooth 配件。ASAccessorySession 管理生命周期并回调事件(activated、accessoryAdded、accessoryChanged、accessoryRemoved、invalidated、migrationComplete、pickerDidPresent/Dismiss、pickerSetupBridging/Pairing/Failed/Rename、accessoryDiscovered)。

使用方式:在 Info.plist 添加 NSAccessorySetupSupports(必填,含 Bluetooth/WiFi)及蓝牙相关键(NSAccessorySetupBluetoothServices、Names、CompanyIdentifiers),且必须与描述符值一致,否则发现时崩溃。创建并激活 ASAccessorySession,再调用 showPicker 展示选择器;选择器在独立系统进程中运行。配对后通过 ASAccessory 的 bluetoothIdentifier 映射 CBPeripheral,或用 ssid 配合 NEHotspotConfiguration 加入网络。

限制与注意:声明蓝牙支持后创建 CBCentralManager 不再触发系统蓝牙权限弹窗,其状态仅在已有配对配件时变为 poweredOn;扫描只返回经 AccessorySetupKit 配对的配件。ssid 与 ssidPrefix 不可同时设置,否则崩溃。迁移期间不得先初始化 CBCentralManager,需等待 migrationComplete。选择器应绑定用户操作,不可自动弹出;会话失效后需新建实例。产品图片建议使用透明背景与适配各屏幕倍率的高分辨率图。

适用场景:需要以最小权限、按配件授权方式接入蓝牙或 Wi-Fi 配件的 iOS 应用,以及从 CoreBluetooth 迁移到新授权模型的场景。

暂未提供:具体收费、价格、平台支持范围之外的信息未在资料中说明。