Adds a visual or audio track. It goes on top by default; position bottom, above or below another track places it elsewhere. The first track in the order is the top layer.
Arguments#
| Argument | Type | Required | Description |
|---|---|---|---|
above | string | no | Place the track directly over this track. |
below | string | no | Place the track directly under this track. |
id | string | no | |
kind | visual, audio | yes | |
name | string | no | |
position | top, bottom | no | top (default) or bottom. |
Example#
As one operation of an edit batch (the edit tool of MCP, vukem-video edit --ops, or POST /api/v1/projects/{id}/edit):
{
"op": "track.add",
"args": {
"id": "trk_a1b2c3d4e5",
"kind": "visual",
"name": "Captions"
}
}Errors#
E_VALIDATION, E_NOT_FOUND, E_ID_EXISTS, E_LIMIT
Scope and phase#
Scope edit, phase prototype. Run vukem-video command:help track.add for the same description from the binary.