Sdílet prostřednictvím

Rozhraní API pro sledování služby Media Services

  • Článek

Logo Media Services v3

Upozornění

Služba Azure Media Services bude vyřazena 30. června 2024. Další informace najdete v průvodci vyřazením AMS.

Prostředek Media Services obsahuje multimediální soubory v přidruženém účtu úložiště Azure. Tyto soubory obsahují data pro zvukové stopy, video a textové stopy. Rozhraní API pro sledování umožňuje pochopit a spravovat stopy, které jsou v prostředku. Skladby používají videopřehrávač DASH nebo HLS k prezentování zvuku, videa a titulků nebo titulků (textu) cílové skupině. Koncový bod streamování Media Services na vyžádání předává informace o stopách přehrávači prostřednictvím manifestů DASH nebo seznamů stop HLS.

Pomocí rozhraní API pro sledování můžete:

  • Získejte seznam zvukových stop, videí a textových stop v assetu.
  • Umožňuje přidat nebo odebrat textové stopy.
  • Přidejte nebo odeberte zvukové stopy.
  • Zadejte atributy přístupnosti textu nebo zvukových stop.
  • Upravte skladbu v Azure Portal nebo si ji stáhněte a pak ji nahrajte zpátky do prostředku.
  • Umožňuje zobrazit nebo skrýt textovou stopu v přehrávači videa.

Poznámka

Textovou stopu můžete přidat nebo aktualizovat jenom u prostředku videa na vyžádání. Kromě toho se u prostředků živého streamování nepodporuje zvuková pozdní vazba.

Textové stopy

Použití textových stop s místně vytvořenými multimédii

Po vytvoření videa místně a exportu titulků můžete tyto titulky nahrát do prostředku, který obsahuje vaše médium na vyžádání.

Obecný pracovní postup pro použití textových stop s místně vytvořeným textem:

  1. Vytvořte video a exportujte titulky do souboru ve formátu VTT nebo TTML.
  2. Soubor VTTT nebo TTML můžete přeložit nebo jinak upravit a uložit kopie pro:
    1. Stopa pro další jazyk s popisným textem, který splňuje požadavky na přístupnost.
    2. A track for additional text for director's komentář.
  3. DŮLEŽITÉ: Pokud chcete v klientském přehrávači zobrazit správný jazyk, musíte do záhlaví VTTT přidat jazyk. Příklad:
    WEBVTT
Language: en-us
  4. Nahrajte video do Media Services.
  5. Vytvořte transformaci a úlohu pro kódování videa.
  6. Nahrajte další textové stopy.

Použití textových stop s živým přepisem

Když je pro živou událost zapnutý živý přepis, vytvoří se další textová stopa WebVTT společně se stopou živého přepisu v reálném čase, kterou vidí diváci v živém přehrávači videa. Tento soubor WebVTT obsahuje nejlepší verzi živého přepisu, která obsahuje celé věty místo částečných výsledků v reálném čase. Po zpřístupnění celého přepisu a odstranění živého výstupu si můžete soubor .vtt stáhnout.

Upozornění

Konečné automaticky generované soubory VTTT s dynamickým přepisem se zpožďují. Pokud před odstraněním živého výstupu nečekáte několik minut, obsah v souboru se zkrátí. Živý přepis navíc není k dispozici pro použití s více vstupními datovými proudy pro živou událost.

Obecný pracovní postup pro použití textových stop živého přepisu:

  1. Vytvořte živou událost s povoleným živým přepisem a vybraným zdrojovým jazykem.
  2. Po skončení živé události počkejte několik minut a pak odstraňte živý výstup. Archivovaný prostředek bude k dispozici pro streamování na vyžádání. Platné adresy URL streamování budou i nadále přístupné vašim divákům.
  3. Vypište stopy v archivovaného prostředku nebo je zobrazte na portálu. K dispozici bude soubor WebVTT, který bude obsahovat přepis NBest. Bude mít příponu .vtt. Soubor má název auto-generated-best_XXX.vtt.
  4. Upravte soubor VTT v Azure Portal nebo ho stáhněte a upravte.
  5. Chcete-li prezentovat textovou stopu ve více jazycích, přeložte zdrojovou textovou stopu do těchto jazyků a uložte je jako samostatné soubory pro každý jazyk pomocí přípony .vtt.
  6. Nahrajte stopu zdrojového jazyka a textové stopy pro každý jazyk.
  7. Pokud k nahrání souboru nepoužíváte Azure Portal, upravte (nebo aktualizujte) soubor .ism, abyste přehrávači řekli, které textové stopy se mají použít, a jejich popisky a viditelnost:
    1. Použití rozhraní API pro sledování k programové aktualizaci manifestu pomocí jedné ze sad SDK nebo rozhraní příkazového řádku:
      1. Node.js
      2. Python
      3. .Čisté
      4. Rozhraní příkazového řádku

Důležité

Při aktualizaci souboru .ism se ujistěte, že skryjete textovou stopu živého přepisu a zobrazíte textovou stopu v jazyce, který je vhodný pro prohlížeč.

Zvukové stopy

K prostředku můžete přidat další zvukové stopy a poskytnout tak divákům zvuk v různých jazycích, přidat popisný zvuk pro usnadnění přístupu nebo přidat komentář režiséra.

Obecný pracovní postup pro zvukové stopy

  1. Vytvořte další zvukové stopy pro živou událost. Může to být zvuk v různých jazycích nebo popisný zvuk, který se používá pro usnadnění přístupu. Můžete také použít zvukovou stopu pro komentář režiséra.
  2. Nahrajte zvukové stopy do archivovaného prostředku.
  3. Aktualizujte data sledování úpravou souboru manifestu na portálu nebo aktualizací dat sledování pomocí restu nebo sady SDK.

Poznámka

Při odebrání zvukové nebo textové stopy se z kontejneru úložiště neodebere podkladový soubor. Služba Media Services nastaví dynamický packager (koncový bod streamování) tak, aby v manifestu nebo seznamu stop požadovaných přehrávačem videa nezobzoroval informace o stopě.

Podrobné kroky rozhraní API pro sledování najdete v následujících ukázkách.

Ukázky

Postupy, kurzy a rychlá zprovoznění

Získání nápovědy a podpory

Media Services můžete kontaktovat s dotazy nebo sledovat naše aktualizace jedním z následujících způsobů: