.pulse 格式与交付要求

本文面向准备交付 .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。