SuperAPI AI 工具集

test-audio

测试与质量

查看项目

更新于 10-15 21:40

技能介绍

用途:在 IWSDK 的 audio 示例工作区中,通过 iwsdk CLI 验证音频系统(AudioSource 加载、播放状态、停止、空间音频)的行为,共 6 个测试套件。

主要能力:套件1 音频加载(查找含 AudioSource 的实体,校验 src、_loaded、_loading、_isPlaying、volume、positional 及 _pool);套件2 播放触发(设置 _playRequested,验证被消费并进入播放态,可先设 loop:true 观察持续 _isPlaying);套件3 停止(设置 _stopRequested,验证 _isPlaying 变 false);套件4 系统注册(AudioSystem 优先级 0、配置键 enableDistanceCulling 与 cullingDistanceMultiplier、audioEntities>=1);套件5 组件 schema(核心、空间、行为、控制、状态字段);套件6 稳定性(检查 error/warn 日志)。

使用方式:在 $IWSDK_REPO_ROOT/examples/audio 下依次执行 npm run fresh:install、后台运行 npm run dev,用 npx @iwsdk/cli dev status 轮询就绪,npx @iwsdk/cli ecs systems 验证连通,再按套件执行 browser reload、xr enter、ecs find/query/set-component、browser logs 等命令。每条命令单独运行并解析 stdout 的 JSON({ok, workspaceRoot, operation, result}),长操作加 --timeout 20000。结束后用 npx @iwsdk/cli dev down 关闭服务并输出结果表。

限制:请求标志为一次性,一帧内被消费;短音效可能在查询前播完;_stopRequested 与 _playRequested 同时设置时停止优先;布尔值须为 JSON 布尔而非字符串;实体索引在重载后会变化,不可缓存;MCP 工具只能验证 ECS 状态,无法确认实际音频输出;audio 示例实体来自 scenes/audio.iwsdk.scene.json。