gatos.camera_track

tool Camera and media

Manage structured JSON camera tracks and their playback.

Use when: Uploading, inspecting, deleting, or playing a cinematic camera program.
Availability: camera_enabled; play/update/stop also use the schedule player.

Input

Field	Type	Requirement	Description
`operation`	`string`	Required	list, read, upload, delete, play, update, or stop.
`name`	`string \| null`	Optional · null	Track name for all operations except list.
`json`	`string \| null`	Optional · null	Structured camera-track JSON chunk for upload.
`offset`	`integer`	Optional · 0	Byte offset for an upload chunk.
`complete`	`boolean`	Optional · true	Finalize and validate the uploaded track.
`value`	`number`	Optional · 0	Playback operation scalar.
`token`	`string \| null`	Optional · null	Fallback track/player token.

Choose an operation below. Its required payload and a complete call stay together—there is no second table to cross-reference.

List stored track names and metadata.

{ operation: "list" }

gatos.camera_track({"operation":"list"})

Return one track's complete JSON.

{ operation: "read", name }

gatos.camera_track({"operation":"read","name":"launch"})

Write a UTF-8 JSON chunk; complete=true validates and commits the track.

{ operation: "upload", name, json, offset?: byte_offset, complete?: boolean }

gatos.camera_track({"operation":"upload","name":"launch","json":"{\"version\":1,\"shots\":[]}","offset":0,"complete":true})

Remove one stored track.

{ operation: "delete", name }

gatos.camera_track({"operation":"delete","name":"launch"})

Canonical action: camera.play / camera.set / camera.stop

Control the camera player.

{ operation, name?, value?, token? }

gatos.camera_track({"operation":"play","name":"launch"})

gatos.camera_track({"operation":"upload","name":"launch","offset":0,"complete":true,"json":"{\"version\":1,\"shots\":[]}"})

Store metadata, track JSON, or playback command outcome.

ENOENT for missing tracks; EEXIST/ENOSPC/EFBIG for store constraints; EINVAL for invalid JSON or operation fields.