Script Inputs

Overview

Script inputs are persisted in animationData.scripts[].inputs and validated by AnimationScriptInputSchema.

Supported input types:

  • boolean
  • number (finite values only)
  • trigger (boolean pulse)
  • string

Authoring API

Use editor.animation methods:

  • addScriptInput(scriptId, input)
  • updateScriptInput(scriptId, inputId, updates)
  • removeScriptInput(scriptId, inputId)

Input IDs must be unique per script.

Runtime Input API

  • setScriptInput(scriptId, inputId, value)
  • getScriptInputValue(scriptId, inputId)
  • fireScriptTrigger(scriptId, inputId)

fireScriptTrigger emits script-input-changed as true then false for deterministic trigger pulse behavior.

Validation Rules

  • number defaults and runtime values must be finite.
  • trigger defaults and runtime values must be boolean.
  • string defaults and runtime values must be string.
  • Invalid writes throw and do not mutate runtime state.