Ir para o conteúdo

Comandos

audio.mark_beats

Writes markers on a music item at the beats of its audio.

Última atualização:

Esta referência é gerada a partir do programa e está em inglês.

Places a marker at each beat of the visible part of the item, or at every nth beat, so that cuts and transitions can be aligned to the music. Beats are frames of the asset and come from the beat grid of the asset, supplied by the service in resolved; the command never starts a job. Markers have no effect on the picture or the sound.

Arguments#

ArgumentTypeRequiredDescription
everyintegernoMark every nth beat of the visible part, from the first; default 1. min 1; max 64
item_idstringyesAn audio item of an audio asset, or of a video asset with audio.
labelstringnoLabel of every marker, up to 60 characters; default none.
replacebooleannotrue (default) replaces the item's markers; false keeps them and adds the beats.
resolvedobjectnoFilled by the service from the beat grid of the asset; never sent by a caller.

Example#

As one operation of an edit batch (the edit tool of MCP, vukem-video edit --ops, or POST /api/v1/projects/{id}/edit):

JSON
{
  "op": "audio.mark_beats",
  "args": {
    "every": 2,
    "item_id": "itm_s6t7v8w9x0",
    "label": "beat"
  }
}

Errors#

E_VALIDATION, E_NOT_FOUND, E_TYPE_MISMATCH, E_INVALID_STATE, E_LIMIT

Scope and phase#

Scope edit, phase beta. Run vukem-video command:help audio.mark_beats for the same description from the binary.