Media Services Tracks API

  • Cikk

Media Services embléma v3

Figyelmeztetés

Az Azure Media Services 2024. június 30-án megszűnik. További információkért lásd az AMS kivezetési útmutatót.

A Media Services-objektumok médiafájlokat tartalmaznak a társított Azure Storage-fiókban. Ezek a fájlok tartalmazzák a hang-, video- és szövegsávok adatait. A Tracks API lehetővé teszi az objektumban található zeneszámok megértését és kezelését. A zeneszámokat egy DASH vagy HLS videolejátszó használja a hang, a videó és a feliratok vagy feliratok (szöveg) közönségnek való bemutatására. A Media Services streamelési végpontja kérésre DASH-jegyzékekkel vagy HLS-lejátszási listákkal továbbítja a zeneszámokkal kapcsolatos információkat a lejátszónak.

A Tracks API-val a következőket teheti:

  • Lekérheti az eszköz hang-, video- és szöveges sávjainak listáját.
  • Szövegsávok hozzáadása vagy eltávolítása.
  • Hangsávok hozzáadása vagy eltávolítása.
  • Adja meg a szöveg- vagy hangsávok akadálymentességi attribútumait.
  • Szerkessze a pályát a Azure Portal, vagy töltse le, majd töltse fel újra az objektumba.
  • Szövegsáv megjelenítése vagy elrejtése egy videolejátszóban.

Megjegyzés

Csak igény szerinti videó (VOD) objektumhoz adhat hozzá vagy frissíthet szövegkövetést. Emellett a késői hangkötés nem támogatott az élő streamelési eszközök esetében.

Szövegsávok

Szövegsávok használata helyileg előállított adathordozóval

Miután helyileg készített egy videót, és feliratokat exportált, feltöltheti ezeket a feliratokat az igény szerinti adathordozót tartalmazó objektumba.

Általános munkafolyamat a szövegsávok helyileg előállított szöveggel való használatához:

  1. Hozzon létre egy videót, és exportálja a feliratokat egy VTT vagy TTML formátumú fájlba.
  2. Fordítsa le vagy más módon szerkessze a VTT- vagy TTML-fájlt, és mentse a másolatokat a következőre:
    1. Egy további, leíró szöveggel ellátott nyelv nyomon követése az akadálymentességi követelményeknek való megfelelés érdekében.
    2. A rendező kommentárjának további szövegét tartalmazó szám.
  3. FONTOS: Hozzá kell adnia a nyelvtervezőt a VTT fejlécéhez ahhoz, hogy a megfelelő nyelv jelenjen meg az ügyféllejátszóban. Például:
    WEBVTT
Language: en-us
  4. Töltse fel a videót a Media Services szolgáltatásba.
  5. Hozzon létre egy átalakítást és feladatot a videó kódolásához.
  6. Töltse fel a további szövegsávokat.

Szövegsávok használata élő átírással

Ha egy élő esemény élő átírása be van kapcsolva, a rendszer egy további WebVTT-szövegsávot hoz létre az élő videólejátszón látható valós idejű élő átírási sáv mellett. Ez a WebVTT-fájl az élő átirat legjobb verzióját tartalmazza, amely teljes mondatokat tartalmaz a részleges, valós idejű eredmények helyett. A .vtt fájlt a teljes átirat rendelkezésre állása és az élő kimenet törlése után töltheti le.

Figyelmeztetés

Az automatikusan létrehozott végleges élő átírási VTT-fájlok feldolgozása késik. Ha nem vár néhány percet az élő kimenet törlése előtt, a fájl tartalma csonkul. Emellett az élő átírás nem használható több bemeneti streamhez egy élő eseményhez.

Általános munkafolyamat élő átírási szövegsávok használatához:

  1. Hozzon létre egy élő eseményt, amelyen engedélyezve van az élő átírás, és a forrásnyelv van kiválasztva.
  2. Ha az élő esemény véget ért, várjon néhány percet, majd törölje az élő kimenetet. Az archivált objektum igény szerinti streameléshez lesz elérhető. Az érvényes streamelési URL-címek továbbra is elérhetők lesznek a megtekintők számára.
  3. Listázhatja az archivált objektumban lévő számokat, vagy megtekintheti őket a portálon. Lesz egy WebVTT-fájl, amely tartalmazza az NBest átírást. .vtt kiterjesztéssel fog rendelkezni. A fájl neve auto-generated-best_XXX.vtt.
  4. Szerkessze a VTT-fájlt a Azure Portal, vagy töltse le és szerkessze.
  5. Ha több nyelven szeretné megjeleníteni a szövegsávot, fordítsa le a forrásszöveget ezekre a nyelvekre, és mentse őket külön fájlként az egyes nyelvekhez a .vtt kiterjesztéssel.
  6. Töltse fel a forrásnyelvi pályát és az egyes nyelvekhez tartozó szövegsávokat.
  7. Ha nem használja a Azure Portal a fájl feltöltéséhez, szerkessze (vagy frissítse) az .ism fájlt, hogy tájékoztassa a lejátszót a használni kívánt szövegről, valamint a címkézésükről és láthatóságukról:
    1. A Tracks API használatával programozott módon frissítheti a jegyzékfájlt az egyik SDK-val vagy a parancssori felülettel:
      1. Node.JS
      2. Python
      3. .Nettó
      4. Parancssori felület

Fontos

Az .ism fájl frissítésekor győződjön meg arról, hogy elrejti az élő átírási szövegsávot, és a szövegsávot a megtekintőnek megfelelő nyelven jeleníti meg.

Hangsávot

Hozzáadhat további hangsávokat egy objektumhoz, hogy a nézők különböző nyelveken hallhassák a hangjukat, leíró hangokat adhatnak hozzá az akadálymentességhez, vagy hozzáadhatják a rendező megjegyzéseit.

Hangsávok általános munkafolyamata

  1. Hozzon létre további hangsávokat az élő eseményhez. Ezek lehetnek különböző nyelveken vagy leíró hanganyagok, amelyeket akadálymentességhez használnak. A rendezői kommentárhoz hangsávot is használhat.
  2. Töltse fel a hangsávokat az archivált objektumba.
  3. A nyomkövetési adatok frissítéséhez szerkessze a jegyzékfájlt a portálon, vagy frissítse az adatkövetést a REST vagy egy SDK használatával.

Megjegyzés

Hang- vagy szövegsáv eltávolításakor a mögöttes fájl nem lesz eltávolítva a tárolóból. A Media Services úgy állítja be a dinamikus csomagolót (streamvégpontot), hogy ne jelenítse meg a zeneszámra vonatkozó információkat a videolejátszó által kért jegyzékben vagy lejátszási listán.

A Tracks API részletes lépéseit az alábbi mintákban találja.

Példák

Útmutatók, oktatóanyagok és rövid útmutatók

Súgó és támogatás

Kérdéseket tehet fel a Media Serviceshez, vagy kövesse a frissítéseket az alábbi módszerek egyikével: