播放

Playback 从 LoweringResult 编译播放计划。它与 Layout 使用相同的输入：Layout 计算页面几何，Playback 生成与设备无关、可转换为 MIDI 的定时事件。

编译入口与输出

使用 compilePlayback 编译播放计划：

compilePlayback(lowering, options?): PlaybackPlan

options.maxFlowSteps 限制反复、房子等控制流访问时间列的次数，默认 65,536，必须是正安全整数。超过上限时抛出 E_PLAYBACK_FLOW_LIMIT，不返回部分计划。

PlaybackPlan 包含 events、scoreMap、tracks、performanceDuration、durationSeconds 和 diagnostics。

演奏时间（performance）和记谱时间（score）都以 QN 为单位，使用精确的 Fraction 表示。Tempo 只决定 QN 到秒的积分，不改变事件的 QN 位置。

secondsToScoreTime(plan, seconds) 将秒数映射到记谱时间，并把输入限制在计划的演奏时长内。播放结束后的时钟值始终映射到计划终点，不向谱面之外外推。

Web Audio、Web MIDI 和 Standard MIDI File 适配器都使用这份事件计划。设备选择、PPQ 量化、实时调度和文件编码由适配器处理，不属于 core playback 编译器。

事件与轨道

音符用事件对表示，不另存一份 start + duration。一个有时长的音符对应两个共享 noteId 的事件：

NoteOn(at, noteId, track, midi, velocity, percussion?)
NoteOff(at, noteId, track, midi)
TimeSignature(at, numerator, denominator)
ProgramChange(at, track, program)

PlaybackPlan.events 当前包含 tempo、time-signature、program-change、note-on、note-off。同一时刻按 tempo -> time-signature -> program-change -> note-off -> note-on 排序，同类事件保持来源顺序。拍号不参与 QN 到秒的积分，只供 MIDI、节拍显示等设备适配器使用。

普通 NoteOn 的 midi 保留核心按记谱语义计算出的逻辑音高；percussion: true 时则表示打击键号。播放编译器不限制其范围，也不将其整数化；MIDI 适配器负责转换为目标设备接受的表示。

编译期间，NoteOn 引用与布局相同的 Track 对象。lowering.tracks 完整描述视觉拓扑，可以包含 head 槽位、只含休止符的声部等无发声轨。

控制流、ornament、dash 和 tie 处理完成后，Playback 按 lowering.tracks 的稳定顺序筛选轨道，只保留最终事件中至少含一个 NoteOn 的 Track。输出的 tracks 从 0 开始连续编号，events[].track 是该数组的索引。head 等纯布局轨、只含休止符的轨和被控制流完全跳过的轨都不占播放通道。

编译流程

flowchart LR
    L[LoweringResult] --> F[linearizeColumns]
    F --> C[收集事件与控制]
    C --> S[扫描系统状态]
    S --> Q[按生成顺序发布音符与局部处理]
    Q --> R[tie 关系后处理]
    R --> V[校验并稳定排序]
    V --> P[PlaybackPlan]

编译器先扫描系统状态，建立完整的 Tempo 表，再按播放生成顺序发布音符。每个 Temporal 完整发布 NoteOn/NoteOff 后，立即执行为它保存的 transform 链；deferred hook 则在自身位置执行。

局部处理完成后，编译器整理事件，再执行 PlaybackRelation，最后校验并稳定排序。这个顺序保证 ornament 先展开，紧随其后的 dash 能找到颤音最后一个子音；dash 移动 NoteOff 后，tie 再根据最终边界判断音符是否连续。

局部 transform 和 deferred hook 都可以查询完整 Tempo 表，但只能访问截至当前位置已发布的音符事件。需要查看完整音符计划的功能应使用 PlaybackRelation。

控制流

linearizeColumns 输出实际访问的列号序列。反复可能让同一列出现多次，房子可能跳过某些列。每次节点访问都有独立的 origin 对象，同一个 Temporal 在反复中也会生成不同的事件和 noteId。

反复结束线回到此前最近的反复开始线。例如 |: 1 |: 2 :| 3 :| 展开为 1 2 2 3 2 3，与 MuseScore 一致。

playbackMarks 只能由进入时间流、拥有列位置的 Temporal 声明。attachment 可以通过 playbackFlow(columnOf) 用自身端点声明区间，但不能单独声明标记。

显式 flow 的 range 必须是时间列内的升序闭区间，jump 目标必须位于 0..columns.length，其中 columns.length 表示跳到文末。不符合要求时分别抛出 E_PLAYBACK_FLOW_RANGE 或 E_PLAYBACK_FLOW_JUMP。

scoreMap 记录控制流展开后的 performance QN 到原始 score QN 的映射。相邻点之间两者以 1:1 前进；反复和房子只表现为映射点处的 score 跳转。

PlaybackEmitter

Temporal 通过 emitPlayback(emitter) 定义自身的播放行为：

interface PlaybackEmitter {
    readonly start: Fraction;
    readonly end: Fraction;
    readonly track: Track;

    nextNoteId(): number;
    emit(event: PlaybackEventInput): void;
    control(at: Fraction, apply: PlaybackControl): void;
    affectFollowing(transform: PlaybackTransform): void;
    defer(hook: PlaybackHook): void;
    play(child: TemporalNodeBase, start?: Fraction, duration?: Fraction): void;
}

• emit 发布系统定义的输出事件；note 通过它发布 NoteOn 和 NoteOff。
• control 在指定时刻修改播放系统状态。
• affectFollowing 为同一 play frame 中后续的音符事件添加局部变换。
• defer 在当前节点的 transform 完成后，于当前位置执行事件 hook。dash 使用它修改前一个音符。
• play 递归发布折叠成员；未指定区间时继承当前区间。

每个 play frame 维护一条局部 transform 链。同一 frame 内的兄弟节点共享这条链；子 frame 继承链的副本，在子 frame 中新增的 transform 不影响父级。

系统状态与控制事件

速度通过系统状态生成。onTimeState 先将记谱位置上的基础 BPM 保存到 Temporal.playbackState；每次实际访问 Temporal 时，编译器将这个快照同步到 PlaybackSystemState。tempo 函数本身不直接发布速度事件。

控制事件用函数描述状态修改，由系统调度执行：

type PlaybackControl = (state: PlaybackSystemState) => void;

有效速度为：

$$effectiveBpm = baseBpm \times bpmScale$$

fermata 在附属音符的首尾发布两个控制：

emitter.control(emitter.start, state => state.bpmScale.div(2));
emitter.control(emitter.end, state => state.bpmScale.mul(2));

这两个控制将覆盖区间的实际速度减半，不移动 NoteOn/NoteOff，也不暂停谱面进度。不同声部中部分重叠的音符只在重叠部分变慢；多个 fermata 重叠时，倍率相乘。

系统按时刻合并基础状态同步与控制函数，并在 effective BPM 改变时生成最终的 tempo 事件。反复回跳后，实际访问到的 Temporal 继续按自身 playbackState 更新系统。

program 同样先由 onTimeState 保存到记谱位置，默认值为 0。它按 Track 流动，不进入全局 PlaybackSystemState。编译器按实际访问顺序维护每轨当前 program，只在变化时生成 program-change。

反复回跳时，目标音符的快照会恢复对应音色，无需在全局系统状态中增加每轨状态表或跳转快照。目前尚不支持 ControlChange 和 PitchBend。

Origin 与局部变换

每次调用 play(node) 都会创建一个独立的 origin 对象：

interface PlaybackOrigin {
    node: TemporalNodeBase;
}

同一个 Temporal 在反复中的不同访问通过对象身份区分，不使用额外的 occurrence 数字。编译期事件保存 origin lineage：ornament 替换事件时继承 lineage，tie 合并事件时取并集。

目标音完整发布后，局部 transform 接收这次访问产生的事件：

type PlaybackTransform = (
    context: PlaybackHookContext,
    events: PlaybackDraftEvent[],
) => PlaybackDraftEvent[] | void

accent 原地修改 events；ornament 返回替换后的事件数组，下一层 transform 继续处理这个结果。因此，局部修饰只需处理传入的事件，无需扫描完整事件计划。

context.stateAt(time) 按时刻查询 BPM 快照。defer 和 relation 需要跨节点访问事件时，使用 context.events：defer 执行时其中只有已发布的事件前缀，relation 执行时则包含完整音符计划。

tr、dash、tie 使用上述变换和关系接口，不定义专用的事件 kind。播放编译器也没有 Patch、Visitor 或 handler registry。

各函数的播放行为

Note

note 根据已保存的音高、力度和 Track 发布一对 NoteOn/NoteOff。休止符 0/Z 和占位符 8 不发声，但仍推进 performance QN。

节拍记号 9/X 在 lowering 中没有旋律音高，在发布 NoteOn 时指定 midi=37 和 percussion: true。此时 midi 表示 GM 打击键，而不是旋律音高。普通 NoteOn 不携带该标记；NoteOff 仍通过 noteId 配对。它保留原 Track 和力度，不提供调内移调函数，所以重音生效、颤音和波音不展开。tie 只合并同种类的同键号音符。

浏览器用 tinySynth 的一个私有音色槽合成短促木击近似，仍走原声部通道和调度，服从音量、静音和独奏，但忽略 program 和旋律移调。MIDI 导出时另建一条 channel 10 的打击轨，原声部身份不变；各声部打击音量折算到 velocity，旋律通道在每个 port 中避开 channel 10。当前 MIDI/MusicXML 导入仍跳过鼓通道，导出后再导入不会保留这些节拍音。

力度和 program 在 TimeState 中按音轨各自流动（见 lowering 文档），所以 $p、$f、@dyn 和 @program 都只影响自己所在的声部，新声部则继承分叉处的状态；速度和调性仍整篇共享。

Program

@program(0..127) 产生不可见的零时值 Temporal。它在 lowering 时修改当前 Track 的 program，后续音符保存各自位置的快照。播放编译同时使用 program 声明和音符快照，使顺序演奏与控制流跳转得到相同的音色结果。

Meter

meter 发布 TimeSignature。与其他 Temporal 一样，事件按实际控制流访问生成，因此反复段内的拍号每遍都会出现，反复段外的拍号只出现一次。

core 保留任意正整数分母。Standard MIDI File 只能表示以 2 为幂的分母，MIDI 适配器在导出时检查这一限制。

Up 与 Grace

up 按附属成员到宿主的顺序调用 play。grace 在宿主区间内计算借时，再用显式 start/duration 发布倚音和宿主。

Accent 与 Ornament

accent、tr 和波音使用 affectFollowing。目标 Temporal 完整发布 NoteOn/NoteOff 后，立即依次执行为它保存的 transform 链：accent 修改 velocity，tr/波音将目标事件对替换为多对子音事件。

后一个 transform 继续处理前一个 transform 的派生事件，因此书写顺序会影响结果。

ornament 用 stateAt(NoteOn.at).effectiveBpm 决定极端速度下的密度。

Dyn

@dyn(from, to, dv) 在 Lowering 阶段计算力度，不生成运行期 relation。所有 onTimeState 完成后，Lowering 遍历 astToTemporal，为普通音符以及 up/grace 的折叠成员累计力度增量。

区间内，增量按记谱时间从 0 线性变化到 dv；区间后保持完整增量，直到下一次原始力度变化。增量叠加在每个音符已保存的力度上，dyn 不识别 $p、$f 或其他具体函数。因此，区间内的力度记号仍独立生效，多条 dyn 的贡献按数值加法累计。

播放编译只根据 note 的 playbackState.velocity 发布 NoteOn。反复访问相同 Temporal 时，会重放同一条记谱力度曲线。

Dash

dash 用 defer 捕获自身的 Track、start 和 end。顺序流执行到 dash 时，它从当前位置附近向前查找同轨且恰好位于 start 的 NoteOff，并将该事件移动到 end。

dash 本身有正时值，因此会在 lowering 时保存所在位置的 BPM。即使控制流直接跳到 dash，秒数积分仍使用该记谱位置的速度。

• 1 - - 的 NoteOff 逐段移动到最后；
• 9 - - 同样延长 NoteOff，但短促打击音的包络自然衰减，不重复敲击；
• 1^3 - 同时移动和弦的全部 NoteOff；
• 1^$tr - 只移动颤音最后一个子音的 NoteOff。

Tie

tie 通过 attachment 的 PlaybackRelation 在所有节点 hook 之后执行。只有同轨、同音且前一个 NoteOff 与后一个 NoteOn 同时的事件才会合并。

合并时删除中间的 NoteOff/NoteOn，将最终 NoteOff 的 noteId 改为首音的 noteId，并合并 source spans 与 origin lineage。反复中的每次访问独立匹配，交叉声明的 tie 链也能沿 lineage 找到合并后保留的事件。

工作台与设备适配

playground 在以下情况下调用 compilePlayback，相同源码版本复用计划：

• 首次激活播放标签；
• 播放标签保持激活，且源码重新排版成功；
• 用户明确请求 MIDI 导出。

tinySynth 适配器将 NoteOn/NoteOff 配对后按 Tempo 积分成秒，并在调度 NoteOn 前应用该音符位置的 program。PlaybackTrackSettings.program 始终有值；overrideProgram 单独表示混音器是否对整轨覆盖谱面音色。

MIDI 适配器固定使用 480 PPQ，在文件导出时完成整数化与设备范围检查。

这两个适配器都直接使用编译后的计划，不重新解释反复、房子、倚音或装饰音。