SuperAPI AI 工具集

accessory-setup-kit

编程与开发

查看项目

更新于 10-16 07:23

技能介绍

用途:AccessorySetupKit 用于以保护隐私的方式发现和设置蓝牙、Wi-Fi 或 Wi-Fi Aware 配件,适用于发现会话与基于选择器的配对流程。

主要能力:通过 ASAccessorySession 创建并激活会话,在指定队列上处理事件;使用 ASDiscoveryDescriptor 描述配件(蓝牙标识符或 Wi-Fi SSID/SSID 前缀);用 ASPickerDisplayItem 呈现选择器;处理 .accessoryAdded 连接所选设备,以及 .accessoryRemoved、.accessoryChanged。支持自定义过滤:启用 filterDiscoveryResults,处理 .accessoryDiscovered 并创建 ASDiscoveredDisplayItem,再调用 updatePicker(showing:completionHandler:)。若需无限时间,可设 discoveryTimeout = .unbounded 并用 finishPickerDiscovery(completionHandler:) 结束。还支持用 ASMigrationDisplayItem 迁移已配置配件,以及在选择器项上提供重命名或完成设置选项。

使用方式:先判断配件使用蓝牙、Wi-Fi 还是 Wi-Fi Aware,并设置匹配的发现属性;声明 AccessorySetupKit 及蓝牙标识符所需的 Info.plist 键;创建并激活 ASAccessorySession,处理事件;呈现包含匹配 ASPickerDisplayItem 的选择器;处理 .accessoryAdded 等事件。蓝牙过滤至少提供 service UUID 或 company identifier,可选名称子串或制造商/服务数据掩码对。Wi-Fi Aware 需在发现前于 ASDiscoveryDescriptor 上设置相应属性。

限制与注意:发现描述符应保持具体,避免过宽的蓝牙访问;需通过会话事件流保持应用状态与用户操作同步。详细 API 与键名见 accessory-setup-kit/accessorysetupkit.md,BLE 行为细节见 accessory-setup-kit/AccessorySetupKitEverythingBLEDevelopersNeedToKnow.md。