用途:为 Three.js 游戏准备可直接使用的音频,包括音效(跳跃、命中、武器、爆炸、拾取、碰撞、UI 点击)、音乐(菜单与玩法循环、Boss 主题、强度分层、胜负音效)、环境音(风、雨、城市底噪、引擎声、房间氛围)、语音(播报、Boss 台词、教程提示、菜单旁白),以及从临时表演做声音转换、转换前的降噪隔离和 Web Audio 集成。
主要能力:通过脚本 threejs_audio_asset.py 提供 sfx、music、tts、isolate、voice-change 等子命令,支持时长、循环、提示影响度、乐器化、作曲计划等参数。API 密钥读取 --api-key 或 ELEVENLABS_API_KEY,可用 probe 检查是否设置,加 --validate 调用 GET /user 验证有效性;密钥不得写入技能文件、游戏代码或报告。
使用方式:在游戏项目目录运行,例如 python3 <this-skill-dir>/scripts/threejs_audio_asset.py sfx --prompt "..." --duration 1.2 --prompt-influence 0.65 --out assets/audio/sfx/boost-pickup.mp3;环境音加 --loop,音乐用 music 子命令,语音用 tts 或 voice-change。生成后通过 Web Audio 加载,处理加载、循环、清单、音量分组、暂停恢复与手势解锁。
限制:API 无循环标志,循环与分层需按参考文档策略处理;有效密钥仍可能受额度或套餐限制,表现为生成时的 HTTP 4xx,应报告为套餐阻塞;一次性命令不支持任务续传,重试前需核对不确定的付费请求;密钥不得进入浏览器代码;未提供具体价格、平台支持范围与效果保证。