Files
AIGame/Doc/Design/Sound/MainMenu/ProductionBrief.md
T

3.7 KiB
Raw Blame History

主界面背景音乐:糖果营地

制作日期:2026-10-20。用途:Candy 风格营地主界面,伙伴收集与轻策略游戏的日常停留背景。

风格依据为 GameDesign.md、Doc/Design/UI/UI_Themes.md 与 Doc/Design/UI/Home/home_generation.json:阳光、奶油色小屋、绿色原野、喷泉和可爱动物伙伴。配器目标为柔和马林巴/木琴短旋律、木吉他分解和弦、拨弦、温暖低音、轻木管与少量铃音,情绪欢迎、轻松、有准备出发的探索感。完整英文提示词保存在 generation.json 的 prompt。

成品

文件 用途与规格
AIClient/Assets/Bundles/Sound/BGM/CandyCamp_MainMenu_Loop.ogg 主界面循环候选成品,90.9秒、48000 Hz、立体声 Vorbis,1,621,586字节
CandyCamp_MainMenu_Source.mp3 未修改的DGX原曲,94秒、48000 Hz、立体声、128 kbps,留档及试听
server_metadata.json 服务返回的原始生成元数据,含实际种子、caption与LM规划
generation.json 风格提示词、生成参数、循环处理参数、音频验证与SHA-256
unity_validation.json Pipeline验证后的AudioClip规格、导入设置与资源收集信息

生成

严格按 D:/UD/AI/XModel/DGX音乐_AI调用指南.md 调用局域网DGXA音乐服务。模型 acestep-v15-xl-sft,LM acestep-5Hz-lm-4B;50步、CFG 7、思考开启、批量1、空歌词、无人声提示词。用户未指定时长与BPM,保持时长 -1、BPM null,交由LM规划;未更换权重或启动参数。

服务种子为 1430014797,LM规划200 BPM、C major、三拍、94秒。BPM及拍号为服务规划值,尚未人工确认实际节拍。服务元数据中的 instrumental: false 为其内部默认标记;调用接口按指南不额外添加纯音乐字段,无人声意图通过空歌词与提示词表达,实际人声有无仍以试听为准。

生成入口为 Tools/generate_main_menu_music.py,原始请求、队列事件、返回和下载记录保留在 Tools/output/main_menu_music/。任务ID 89793b8b202341b0944499ce482d1124。首次SSE订阅在会话创建前返回session_not_found;脚本恢复到同一session与event_id读取结果,只提交了一次生成请求,没有重复排队。

循环处理与验证

python Tools/prepare_main_menu_music.py 在Unity外处理原始音频:按LM规划的小节长度裁至92.7秒,去掉尾部明显衰减,首尾以1.8秒(两个规划小节)等功率交叉淡化,并旋转接缝到连续波形处。全局降低约1.34 dB后输出Vorbis质量5,得到90.9秒。OGG容器避免MP3编码填充影响循环长度;并未宣称已通过人工听感的无缝音乐衔接。

完整解码成功,采样有限且无削波;OGG解码峰值约-3.17 dBFS,RMS约-20.90 dBFS;循环边界采样差约0.00797,小于内部相邻采样差的99百分位0.05113。上述为技术检查,不能替代旋律、节奏及有无人声的人工试听。

Unity导入与验证使用项目的 unity-pipeline 技能:import_asset 导入,然后执行 AIClient/AgentScripts/ImportMainMenuMusic.cs 的 ConfigureAndVerify。AudioClip实际为4,363,200采样帧、90.9秒、双声道、48000 Hz。导入设置为Vorbis质量0.7、CompressedInMemory、保留采样率、后台加载、不预加载,避免启动即展开整首PCM。Art包新增Sound组,仅收集 Assets/Bundles/Sound/BGM,按文件名寻址、单独打包;原有收集项保留。本轮Console游标558之后无新增错误。

本次完成生成、循环处理、Unity入库、收集配置与资源登记;未添加AudioSource或运行时播放代码,未接入设置页音乐开关,未构建Bundle、发布CDN或进行微信真机验证。音乐听感和最终循环衔接待试听确认。