SoundGame Dev
cc0f8c008d
- 新增 web/ 纯音频 HTML5 平台：共享引擎（手势/WebAudio 三层/设置/震动）、 Node 零依赖服务器（静态 + 注册登录 + 进度存档 API） - 游戏：剑与声(RPG 新作)、声命线、暗室(重设计)、音序回响(重设计)、 节拍行者(跟随领奏重构)、盲航(同向闪避重构)；声东击西删除 - 全局功能：男声/女声双套 TTS 资产、三档语速、BGM 音量三档、 震动反馈语言(10 种震型)、服务器进度同步 - 资产：899 ogg + 899 m4a（Qwen3-TTS 双性别语音、Stable Audio 3 音效、 Mureka BGM 4+3 首），终检零缺失 - 文档：docs/design/ 13 篇设计审查文档、docs/audio/ 资产管线、 web/server/README.md API 文档
95 lines
5.8 KiB
Markdown
95 lines
5.8 KiB
Markdown
# Mureka API 调用日志
|
||
|
||
计费规则：`POST /v1/instrumental/generate` 每条任务 $0.03（一次出 2 个候选）。
|
||
预算上限：$0.50。
|
||
|
||
## 2026-08-29
|
||
|
||
| # | task id | 用途 | prompt | 状态 | 花费 |
|
||
|---|---|---|---|---|---|
|
||
| 1 | 157913551339521 | storyline《声命线》dark_drone.ogg | dark ambient horror game background music, low drone, sparse piano notes, tense, seamless loop, instrumental | succeeded | $0.03 |
|
||
| 2 | 157913880461313 | escape《暗室》drone.ogg | claustrophobic suspense ambient game background music, low sub-bass pulse, faint metallic echoes and creaks, dark reverb, unsettling minimal texture, seamless loop, instrumental | succeeded | $0.03 |
|
||
|
||
**累计花费：$0.06 / $0.50**
|
||
|
||
## 候选与选用
|
||
|
||
- 任务 1（storyline）：候选 0 = 213.59s / mean -15.9dB（选用，choice 157913654165507）；
|
||
候选 1 = 185.95s / mean -17.0dB（备选未用）。下载 flac 存
|
||
`tools/mureka_out/storyline/`。
|
||
- 任务 2（escape）：候选 0 = 248.07s / mean -15.9dB（选用，choice 157913991806979）；
|
||
候选 1 = 224.63s / mean -15.2dB（备选未用）。下载 flac 存
|
||
`tools/mureka_out/escape/`。
|
||
|
||
两条任务一次成功，无重试。
|
||
|
||
## 后处理（两条相同参数）
|
||
|
||
ffmpeg：裁剪前 120s → 首尾 3s acrossfade（tri）无缝循环化 → loudnorm
|
||
I=-20/TP=-2/LRA=11 → aresample 44.1kHz 立体声 → libvorbis `-q:a 3`。
|
||
成品均 117.00s（storyline mean -22.3dB，escape mean -21.1dB），保持原文件名
|
||
直接替换 assets，游戏代码零改动。原合成版备份在 `tools/bgm_backup/`。
|
||
| 3 | 157922006990851 | rhythm《节拍行者》groove.ogg | constant tempo 120 bpm electronic dance music, steady four-on-the-floor kick drum beat, driving synth bass, crisp hi-hats, energetic, no tempo changes, seamless loop, instrumental | succeeded | $0.03 |
|
||
|
||
- 任务 3（rhythm）：候选 0 = 158.35s（choice 157922107719682）；候选 1 = 194.23s（choice 157922107719683）。flac 存 `tools/mureka_out/rhythm/`。
|
||
| 3 | 157922351054851 | space《盲航》engine.ogg | deep spaceship engine hum ambient, continuous low drone with subtle pulsing thruster texture, calm tension, dark sci-fi atmosphere, seamless loop, instrumental | succeeded | $0.03 |
|
||
|
||
space：选用候选 0（180.03s，choice 157922441101313），后处理同前（120s 裁剪+3s 首尾 crossfade+loudnorm -20LUFS），成品 117.00s mean -21.5dB。space 预算线：$0.03/$0.15。
|
||
|
||
simon：任务 157922504015873，一次成功（首次 429 重试 1 次），候选 0 = 202.7s 选用（choice 157922638299138），裁剪 117s 循环化 + loudnorm -20。估 $0.03。
|
||
|
||
## 2026-08-29 R3：rhythm《节拍行者》重构 BGM（track90/105/120）
|
||
|
||
预算线：本轮 $0.30；总预算 $2.00（5 轮）。
|
||
|
||
| # | task id | 用途 | 状态 | 花费 |
|
||
|---|---|---|---|---|
|
||
| 6 | 157963509563393 | track90 首提（2 候选） | succeeded | $0.03 |
|
||
| 7 | 157963652431875 | track105 首提（2 候选） | succeeded | $0.03 |
|
||
| 8 | 157963818106881 | track120 首提（2 候选） | succeeded | $0.03 |
|
||
| 9 | 157964073893889 | track90 重提（第 2 次，2 候选） | succeeded | $0.03 |
|
||
| 10 | 157964212305921 | track120 重提（第 2 次，2 候选） | succeeded | $0.03 |
|
||
|
||
**本轮花费：$0.15 / $0.30。累计：$0.30 / $2.00。**
|
||
|
||
### BPM 实测与选用（librosa 梳状扫描法 tools/bpm_precise.py，合成 105 点击轨校准=105.00 精确）
|
||
|
||
注意：`librosa.beat.beat_track` 在 22050/512 下按整帧量化（105 附近一档=4.3 BPM），
|
||
读数 103.36/107.67 均为量化伪影，不作为判据；以梳状扫描（0.05 BPM 步进+抛物线插值）为准。
|
||
|
||
- track90：首提 121.0 / 98.75，重提 80.0 / 120.0 —— 4 候选全部不达标。已达"每首最多重试 1 次"上限，
|
||
选用首提候选 1（98.75，choice 157963627134980）以 atempo=0.911392 拉伸至 90，
|
||
成品实测 **90.01 BPM**（循环 85.33s = 32 小节）。
|
||
- track105：首提候选 0 实测 **105.00 精确**（choice 157963780292611，168.03s），无需重提/拉伸；
|
||
成品实测 **104.99 BPM**（循环 73.14s = 32 小节）。
|
||
- track120：首提 123.05 / 117.45（beat_track 量化读数）不达标，重提候选 0 实测 **120.00 精确**
|
||
（choice 157964317097985，208.59s）；成品实测 **120.00 BPM**（循环 72.00s = 36 小节）。
|
||
|
||
### 后处理
|
||
|
||
强拍起点裁剪（首个强 onset 对齐小节头）→ 整数小节裁剪 + 末 2 拍与开头 acrossfade(tri)
|
||
无缝循环 → loudnorm I=-20/TP=-2/LRA=11 → 44.1kHz → ogg q:a 3 + m4a aac 128k。
|
||
成品：track90=85.33s / track105=73.14s / track120=72.00s，mean -21.2/-21.3/-19.9dB。
|
||
旧 `bgm/groove`（R2 的 120bpm 单曲）已删除。flac 原件存 `tools/mureka_out/rhythm_track*/`。
|
||
|
||
## 2026-08-29 R4：rpg《剑与声》BGM（village/battle/boss/ending，4 首）
|
||
|
||
预算线：本轮 $0.30；总预算 $2.00（5 轮）。addendum 裁定探索期无音乐（amb 走 sfx 层），bgm/explore 取消。
|
||
|
||
| # | task id | 用途 | 状态 | 花费 |
|
||
|---|---|---|---|---|
|
||
| 11 | 157968630808577 | rpg village（2 候选） | succeeded | $0.03 |
|
||
| 12 | 157968792551426 | rpg battle（2 候选） | succeeded | $0.03 |
|
||
| 13 | 157968932864001 | rpg boss（2 候选） | succeeded | $0.03 |
|
||
| 14 | 157969071407105 | rpg ending（2 候选） | succeeded | $0.03 |
|
||
|
||
**本轮花费：$0.12 / $0.30。累计：$0.42 / $2.00。**
|
||
|
||
选用：village=候选 1（choice 157968750477315，229.2s）；battle=候选 0（choice 157968893214722，212.8s）；
|
||
boss=候选 1（choice 157969029332994，178.2s）；ending=候选 1（choice 157969188913155，248.4s）。
|
||
一次成功无重试。RPG 无节拍网格玩法，BPM 不做硬校验（prompt 已带 70/100/120 bpm 特征词）。
|
||
|
||
后处理：首个强 onset 起点 → 90s 裁剪 + 首尾 3s acrossfade(tri) 无缝循环 → loudnorm I=-20/TP=-2/LRA=11
|
||
→ 44.1kHz → ogg q:a 3 + m4a 128k。成品均 90.00s（mean -23.0/-20.5/-22.6/-21.9dB）。
|
||
flac 原件存 tools/mureka_out/rpg_*/。
|