SuperAPI AI 工具集

realitykit-audio-spatial

智能体与模型

查看项目

更新于 10-16 05:47

技能介绍

用途:本技能面向 RealityKit 音频实现与调试,覆盖实体定位的空间音频、环境音频、声道音频、可复用音频库、音频混组、混响、分组播放与声学模拟等主题。开始前需先判断任务属于哪一类,再只加载匹配的参考文件。

主要能力与参考文档对应:references/spatialaudiocomponent.md 用于把声音放到 RealityKit 实体的 3D 空间位置;ambientaudiocomponent.md 用于非定位环境音频;channelaudiocomponent.md 用于面向声道的播放控制;audiolibrarycomponent.md 用于可复用音频库;audiomixgroupscomponent.md 用混组组织播放;reverbcomponent.md 用于添加或调整混响;audio-groups-and-acoustics.md 用于分组播放或模拟房间声学。

使用方式与路由:音频资源加载保持异步,实体归属要明确。实体加载、锚定、交互或挂载相关设置交由 realitykit-visionos-developer;由角色、碰撞、物理、粒子或布料行为触发的音频交由 realitykit-animation-physics;需要自定义逐帧查询逻辑时交由 realitykit-ecs-systems。

限制与验证:音频资源与文件加载不得放在同步 UI 路径上;添加组件前先确定音频是定位、环境、声道、分组还是声学模拟;visionOS 27 的音频分组与声学新增接口视为 beta API,需对照已安装 SDK 复核符号;当空间化、声学或输出路由重要时,必须在真机上验证。

输出期望:需给出音频类别、所用参考文件、所选组件或资源归属路径、空间化/分组/声学约束,以及下一步设备或运行时验证步骤。官方文本暂未提供。