← Cloudflare Stream / stream / edit-videos

Přidání dalších zvukových stop

Než lze k videu připojit další zvukové stopy, musí být video nahrané. V následujících příkladech URL adres se na UID videa odkazuje jako na VIDEO_UID.

Chcete-li přidat zvukovou stopu k videu, je potřeba Cloudflare API Token ↗ je povinné.

API se pokusí co nejlépe vyrovnat případný nesoulad mezi délkou nahraného zvukového souboru a délkou videa, doporučujeme však nahrávat zvukové soubory se stejnou délkou jako video. Je-li zvukový soubor delší než video, přebytečná část zvukové stopy se ořízne na délku videa. Je-li zvukový soubor kratší než video, na konec zvukové stopy se doplní ticho tak, aby odpovídala délce videa.

Pokud máte zvukové soubory uložené v cloudovém úložišti, stačí předat HTTP odkaz na soubor. Stream soubor stáhne a zpřístupní jej pro streamování.

label je povinné a musí jednoznačně identifikovat stopu mezi ostatními popisky zvukových stop pro dané video.

curl -X POST \
 -H 'Authorization: Bearer <API_TOKEN>' \
 -d '{"url": "https://www.examplestorage.com/audio_file.mp3", "label": "Example Audio Label"}' \
https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/<VIDEO_UID>/audio/copy

{
 "result": {
   "uid": "<AUDIO_UID>",
   "label": "Example Audio Label",
   "default": false
   "status": "queued"
 },
 "success": true,
 "errors": [],
 "messages": []
}

uid jednoznačně identifikuje zvukovou stopu a lze ho použít k její úpravě nebo smazání. Postup těchto operací najdete v pokynech níže.

default pole určuje, zda bude zvuková stopa v přehrávači přehrávána ve výchozím nastavení. Další zvukové stopy mají false výchozí stav, ale lze jej upravit podle níže uvedených pokynů.

status pole se změní na ready po úspěšném nahrání a zakódování zvukové stopy. Pokud během tohoto procesu dojde k chybě, stav bude označovat error.

Vytvořte HTTP požadavek a zvukový soubor přiložte jako vstup s názvem nastaveným na file.

Nahrávané zvukové soubory nesmí překročit velikost 200 MB. Pokud je váš zvukový soubor větší, před nahráním jej zkomprimujte.

Vstup formuláře label je povinné a musí jednoznačně identifikovat stopu mezi ostatními popisky zvukových stop pro dané video.

Všimněte si, že cURL -F příznak automaticky nakonfiguruje hlavičku content-type a namapuje audio_file.mp3 na vstup formuláře s názvem file.

curl -X POST \
 -H 'Authorization: Bearer <API_TOKEN>' \
 -F file=@/Desktop/audio_file.mp3 \
 -F label='Example Audio Label' \
https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/<VIDEO_UID>/audio

{
 "result": {
   "uid": "<AUDIO_UID>",
   "label": "Example Audio Label",
   "default": false
   "status": "queued"
 },
 "success": true,
 "errors": [],
 "messages": []
}

Chcete-li zobrazit doplňkové zvukové stopy přidané k videu:

curl \
 -H 'Authorization: Bearer <API_TOKEN>' \
https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/<VIDEO_UID>/audio

{
  "result": {
    "audio": [
      {
        "uid": "<AUDIO_UID>",
        "label": "Example Audio Label",
        "default": false,
        "status": "ready"
      },
      {
        "uid": "<AUDIO_UID>",
        "label": "Another Audio Label",
        "default": false,
        "status": "ready"
      }
    ]
  },
  "success": true,
  "errors": [],
  "messages": []
}

Všimněte si, že toto API nevrátí informace o zvuku připojeném k nahranému videu.

Chcete-li upravit default stav nebo label další zvukové stopy:

curl -X PATCH \
 -H 'Authorization: Bearer <API_TOKEN>' \
 -d '{"label": "Edited Audio Label", "default": true}' \
https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/<VIDEO_UID>/audio/<AUDIO_UID>

Úprava default stav zvukové stopy na true označí všechny ostatní zvukové stopy videa jako default stav na false.

{
  "result": {
    "uid": "<AUDIO_UID>",
    "label": "Edited Audio Label",
    "default": true
    "status": "ready"
  },
  "success": true,
  "errors": [],
  "messages": []
}

Chcete-li odstranit doplňkovou zvukovou stopu přiřazenou k vašemu videu:

curl -X DELETE \
 -H 'Authorization: Bearer <API_TOKEN>' \
https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/stream/<VIDEO_UID>/audio/<AUDIO_UID>

Odstranění default zvuková stopa není povolena. Jinou zvukovou stopu musíte nastavit jako default před odstraněním.

Pokud existuje záznam v errors pole v odpovědi, zvuková stopa nebyla odstraněna.

{
  "result": "ok",
  "success": true,
  "errors": [],
  "messages": []
}