必须先启用audio playback模块，否则音效静音；bgm可通过拖拽或手动注册导入并归类至audio/bgm；角色语音需规范命名、拖入audio/voice，并在角色编辑器中绑定触发条件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在HappyOyster中为场景添加背景音乐或角色语音，让交互更有沉浸感？必须先确认项目已启用音频支持模块，否则导入的音效文件不会被识别，播放时只会静音。
启用音频支持模块
打开项目设置 → 点击左侧「扩展功能」→ 找到「Audio Playback」选项 → 将开关切换为开启状态。
这一步不可跳过。未启用时，即使后续成功导入音频文件，【所有音轨在运行时均无声】，且控制台不会报错，极易误判为文件路径问题。
添加背景音乐（BGM）
方法一：拖拽导入
直接将MP3或WAV格式的BGM文件拖入资源管理器窗口空白处 → 系统自动完成注册并归类至「Audio/BGM」目录。
方法二：手动注册
点击资源管理器右上角「+」按钮 → 选择「Import Audio」→ 浏览本地文件 → 选中目标BGM → 点击「Open」→ 在弹出的元数据面板中勾选「Is Background Music」→ 点击「Confirm」。
注意：BGM文件体积建议控制在10MB以内。超过该大小可能导致加载卡顿，尤其在低端设备上首次进入场景时会出现明显延迟。
为角色添加语音音效
第一步：准备语音素材
确保每段语音命名清晰，例如「npc_elder_say_hello.wav」「player_jump_grunt.mp3」，避免使用空格或中文标点。
第二步：导入并绑定
将语音文件拖入「Audio/Voice」子目录 → 在角色编辑器中选中目标角色 → 展开「Audio Triggers」面板 → 点击「Add Clip」→ 从下拉列表中选择对应语音文件 → 设置触发条件（如「On Dialogue Start」或「On State Enter: Idle」）。
第三步：测试播放逻辑
进入预览模式 → 触发对应事件（如点击对话框、切换角色状态）→ 听辨语音是否准时播放、无破音、无延迟。若出现杂音，检查原始文件是否含压缩伪影，建议用Audacity重导出为44.1kHz/16bit PCM WAV。
