SuperAPI AI 工具集

audioaccessorykit

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:让第三方音频配件参与 Apple 的音频生态,实现自动音频切换、音频路由协调以及头部/耳内佩戴位置检测。目标环境为 Swift 6.3 / iOS 26+。

前提条件:配件必须先通过 AccessorySetupKit 完成配对与授权,之后才能用 AudioAccessoryKit 配置。

主要能力:

  1. 注册配件控制设备:把已授权的配件包装为 AccessoryControlDevice 并注册,使用蓝牙标识符和 AccessoryControlDevice.Configuration。
  2. 设备能力与配置:声明硬件能力(如 earDetection、noiseControl、spatialAudio),并更新监听模式(ListeningMode)。
  3. 监测佩戴状态:上报耳内/耳外(Placement 的 .inEar / .outOfEar)等位置变化,触发系统自动音频切换。
  4. 音频路由协调:耳机入耳后,在用户于设置中开启自动切换的前提下,iOS 会自动激活音频路由。

使用方式:先用 AccessorySetupKit 的 ASAccessorySession 发现并配对硬件,取得蓝牙标识符;随后调用 AccessoryControlDevice.register(identifier:configuration:) 注册,配置 capabilities,并通过 updateListeningMode、updatePlacement 等方法上报状态。

常见错误:在未经 AccessorySetupKit 授权前调用 AudioAccessoryKit;在没有硬件确认的情况下上报佩戴状态(会干扰通话或媒体播放);未在 Configuration.capabilities 中声明支持的能力(如空间音频、ANC 不会出现在控制中心);假设可在模拟器运行。

限制:音频配件硬件集成需在受支持的实体设备上测试,模拟器无法验证。资料未提供价格、收费、平台支持范围之外的信息及具体使用步骤细节。