交付PULSE · 交付要求 · 对应 PULS v1 / v0.1
.pulse 格式与交付要求
更新于 2026-07-19
本文面向准备交付 .pulse 音乐包的 Pulse 设计师，说明一个合格的交付物需要满足什么要求。制作过程中的具体操作请看 Pulse Designer 手册。
💡 本文是设计师视角的交付要求摘要。
.pulse二进制容器的完整技术规范（字节布局、双解析器一致性测试等）面向格式实现者，见上游 PULSE_FORMAT.md。
一个 .pulse 文件里有什么
.pulse 是一个自包含的互动音乐包，一个文件带齐运行所需的全部内容：
- 音频数据：内嵌的 wav / mp3 / ogg 音频字节；
- 音乐结构：状态、片段、Layer、转场和参数定义；
- 元数据（可选）：授权信息、兼容性说明和开发者接入合同。
也就是说，交付时只需要交付一个 .pulse 文件，不需要附带散装音频或额外的配置文件。
三项交付要求
一个 Pulse Module 不是普通音乐包，也不是一组孤立的音频文件。合格的交付物必须同时满足三项要求：
1. 可运行（Runnable）
- 模块能直接在 Pulse Desktop 中加载；
- 能通过状态块播放和切换状态；
loop、layer和transition行为正确。
注意：当前版本没有真正的叠加式 Stinger，交付说明中不要把它宣传为已有能力。
2. 可试听（Previewable）
- 模块能导出 Web Preview，购买者不需要接入游戏就能试听状态切换；
- 预览必须展示状态按钮、当前状态和当前激活的 Layer。