SuperAPI AI 工具集

audioaccessorykit

通用与其它

查看项目

更新于 10-15 21:12

技能介绍

用途:AudioAccessoryKit 为第三方音频配件提供自动音频切换与智能音频路由输入。配套 App 可向系统注册音频配件配置,App 扩展可上报佩戴位置和已连接音源变化,帮助系统决定音频输出设备。

前提与平台:配件须先通过 AccessorySetupKit 完成蓝牙配对,得到 ASAccessory 对象后才能注册音频功能。最低支持 iOS 26.4+ / iPadOS 26.4+。当前 Xcode 26.6 工具链中该框架存在于设备 SDK,但不在 iPhone Simulator 26.5 SDK,需使用真机目标;若其余代码需在模拟器构建,可用 #if canImport(AudioAccessoryKit) 隔离并做桩。

主要能力:核心类型为 AccessoryControlDevice。容器 App 通过 AccessoryControlDevice.register(accessory, configuration) 注册 Configuration,声明 deviceCapabilities(如 .audioSwitching、.placement)与初始 devicePlacement。App 扩展用 current(for:) 获取设备,用 update(_:) 推送配置变更。Placement 含 .inEar、.onHead、.overTheEar、.offHead。多设备配件可设置 primaryAudioSourceDeviceIdentifier 与 secondaryAudioSourceDeviceIdentifier(蓝牙地址 Data),在连接状态变化时更新。

使用方式:注册后,扩展按 current→复制 configuration→修改→try await update(_:) 的流程更新;仅更新注册时已声明的能力字段。错误由 AccessoryControlDevice.Error 表示,含 .accessoryNotCapable、.invalidRequest、.invalidated、.unknown,需全部处理(含 @unknown default)。.invalidated 应丢弃句柄并通知容器 App 重新评估注册。

限制:该框架为 iOS 26.4 新增,属测试敏感内容,依赖具体 API 前应重新核对苹果官方文档。未声明 .placement 时不应上报位置;声明后须持续更新。资料未提供收费、价格或更多平台信息。