tool Camera and media
Control named audio playback channels.
| Field | Type | Requirement | Description |
|---|---|---|---|
operation | string | Required | Logical operation listed below. A dotted canonical action is also accepted. |
value | number | Optional · 0 | Operation-specific scalar. |
values | number[] | null | Optional · null | Operation-specific numeric vector. |
token | string | null | Optional · null | Operation-specific named value. |
aux | string | null | Optional · null | Operation-specific secondary value. |
Choose an operation below. Its required payload and a complete call stay together—there is no second table to cross-reference.
playCanonical action: audio.play
Start a clip. group is 0=sfx, 1=music, or 2=ui; end_ms 0 means the whole clip.
{ operation: "play", token: clip_name, aux?: channel_id, values?: [start_ms, end_ms, volume, loop, pan, pitch, group] }gatos.audio_control({"operation":"play","token":"launch.wav","aux":"mission","values":[0,0,1,0,0,1,0]})update / pause / resume / seekCanonical action: audio.set
Patch a live channel using flat numeric key/value pairs. pause/resume/seek map to this same action.
{ operation, token: channel_id_or_clip, values: [key, value, ...] // 0=volume, 1=pan, 2=pitch, 3=paused, 4=seek_ms }gatos.audio_control({"operation":"update","token":"mission","values":[0,0.25,3,1]})stopCanonical action: audio.stop
Stop one matching channel/clip, or all channels.
{ operation: "stop", token: "all" | channel_id | clip_name }gatos.audio_control({"operation":"stop","token":"mission"})gatos.audio_control({"operation":"play","token":"launch.wav","aux":"mission","value":1})Audio command outcome with freshness metadata.