游戏开发者：5 分钟接入 .pulse

这份指南只面向 Web / HTML5 游戏开发者。目标只有一个：让制作好的 .pulse 音乐包开始播放，并跟随游戏切换音乐状态。

你不需要理解素材、片段、Layer、DSP 或转场编排。第一次接入只需要三个动作：① 加载音乐包 → ② 播放 → ③ 切换游戏音乐状态。

如果你负责制作音乐包，请改看 Pulse Designer 手册。不确定角色时，从文档入口开始。

TL;DR：30 秒速览（熟手版）

从 Pulse Desktop 帮助页复制 pulseContract，然后：

pnpm add @clxgame/pulse-game

const music = await loadPulseGame("/packs/forest-combat.pulse"); // 加载，不自动播放
await music.play();                                              // 必须由用户点击触发
music.setGameState(pulseContract.states.combat);                 // 游戏事件里切状态

只调用合同公开的 ID；场景销毁时 。细节和陷阱见下文。