Playback lifecycle

play, loop, dedupe, cooldown и cleanup sound handles.

Практическая схема

• Документация: NovaUIKit.
• Раздел: Motion и Sound.
• Тема страницы: Playback lifecycle.
• Переключатель TypeScript / DSL находится в панели навигации; вкладка Код в примере показывает файлы выбранного подхода.

Исполняемый примерSound mixerИнтерактивные pads и Sound Engine lifecycle.

import { Nova, NovaNode, type NovaSchema } from '@endge/nova'

// Документационный сценарий: nova-sound-mixer
class ExampleNode extends NovaNode<Record<string, Event>> {
  render(): void {
    const schema: NovaSchema = [
      {
        type: 'rect',
        x: 24,
        y: 24,
        width: this.width - 48,
        height: this.height - 48,
        styles: { background: '#0d2745' },
      },
      {
        type: 'text',
        x: 44,
        y: 44,
        width: this.width - 88,
        height: 32,
        text: 'Sound mixer',
        styles: { color: '#e8f5ff' },
      },
    ]

    this.renderer.schema(schema)
    this.setRenderBoundsFromSchema(schema)
  }
}

export function mountExample(canvas: HTMLCanvasElement) {
  const app = Nova.createApp({
    target: canvas,
    size: { width: canvas.clientWidth, height: canvas.clientHeight, maxDpr: 2 },
    scheduler: { loop: false },
  })
  const surface = app.surface({ id: 'sound-mixer' })
  surface.createNode(ExampleNode)

  return () => app.destroy()
}

interface · @endge/nova

NovaSoundPlayOptions

Runtime overrides одного playback: mix, rate, pan, loop, dedupe и limits.

interface NovaSoundPlayOptions

Mix

Поле	Тип	Описание
volume	number	Громкость конкретного playback.
category	string	Переопределяет descriptor category.
pan	number	Stereo pan от -1 до 1, если backend поддерживает StereoPannerNode.

Behavior

Поле	Тип	Описание
rate	number1	Playback rate/pitch для коротких feedback sounds.
loop	boolean	Запускает loop playback, который нужно остановить handle/scope lifecycle.
dedupeKey	string	Останавливает предыдущий active playback того же key.
cooldownMs	number	Локальный cooldown для rapid hover/click.
priority	number	Приоритет вытеснения из maxVoices pool.

Как применять

Используйте страницу как короткую рабочую заметку: сначала определите границу ответственности, затем откройте пример и сравните TypeScript-реализацию с DSL-описанием. Runtime-код остается в Nova-слое, а Vue отвечает только за mount, layout shell и cleanup.