自定义音源

将 soundfont.json 和音频文件打包成 ZIP，在「设置 → 音源 → 导入」中打开。音源仅保存在当前账户的本机浏览器中，不随谱库同步。

soundfont.json
samples/
  E2.mp3
  A2.mp3
  …

{
  "schema": "guitar-soundfont/v1",
  "name": "我的吉他",
  "gain": 1,
  "samples": [
    { "pitch": 40, "string": 6, "file": "samples/E2.mp3" },
    { "pitch": 45, "string": 5, "file": "samples/A2.mp3" }
  ]
}

字段	含义
`schema`	固定为 `guitar-soundfont/v1`
`name`	音源名称，1–60 字
`instrument`	可省略，默认 `guitar`。设为 `piano` 时，滑音、击弦、勾弦按普通音符播放，延音线与琶音保留
`gain`	音源增益，0.05–4；可省略，默认 1
`pitch`	录音的 MIDI 音高，0–127；E2=40，A2=45，D3=50，G3=55，B3=59，E4=64
`file`	ZIP 内相对路径，支持 WAV、MP3、OGG，不支持网络地址
`string`	可省略。1 为最细的高音弦，6 为最粗的低音弦
`velocity`	可省略，默认 [1,127]。力度层例：[1,48]、[49,96]、[97,127]；同音高、同琴弦的范围不能重叠

播放器优先选择对应琴弦，再选择最近音高和匹配力度层；缺少音高时会移调。为获得自然的音色，建议每根弦录制多个音高。

ZIP 上限 64 MB，解压后 128 MB，最多 1024 个采样；每个文件不超过 16 MB、30 秒、双声道和 96 kHz，整套解码后不超过 512 MB。最多保存 12 套自定义音源。

请保留原 ZIP 用于备份；清除浏览器数据会移除本机音源。仅导入你有权使用的录音。

内置音源来源

Meta Open Sound：钢弦与尼龙吉他，CC0。本站将官方 OGG 预览转为 MP3，保留分弦和力度层。

Salamander Grand Piano v3：Alexander Holm，CC BY 3.0。本站从无损录音转为高质量立体声 MP3，保留四档采样力度，不加载踏板和击槌噪声。处理与署名记录。

FreePats / FlameStudios FSS Steel String Guitar：GPL-3.0-or-later，附音频例外。本站使用未修改的精简版 WAV。下载原音源及许可。

GeneralUser GS：S. Christian Collins 的 Steel Guitar（钢弦吉他），Bank 0 / Program 25（零基，GM 第 26 项）。保留原网页由 FluidSynth 渲染的 29 个 WAV 采样。

模板使用 Meta 钢弦的六根空弦录音，CC0。模板用于说明格式，完整音源应补充更多音高。