Dela via

Media Services spårar API

  • Artikel

Media Services-logotyp v3

Varning

Azure Media Services dras tillbaka den 30 juni 2024. Mer information finns i AMS Pensionsguide.

En Media Services-tillgång innehåller mediefiler i det associerade Azure-lagringskontot. Dessa filer innehåller data för ljud-, video- och textspår. Med API:et Tracks kan du förstå och hantera spåren som finns i tillgången. Spåren används av en DASH- eller HLS-videospelare för att presentera ljud, video och undertexter eller undertexter (text) för publiken. En Media Services-slutpunkt för direktuppspelning kommunicerar information om spåren till en spelare via DASH-manifest eller HLS-spellistor på begäran.

Med API:et Tracks kan du:

  • Hämta listan över ljud-, video- och textspår i en tillgång.
  • Lägg till eller ta bort textspår.
  • Lägg till eller ta bort ljudspår.
  • Ange hjälpmedelsattribut för text- eller ljudspåren.
  • Redigera spåret i Azure Portal eller ladda ned det och ladda sedan upp det till tillgången igen.
  • Visa eller dölj ett textspår i en videospelare.

Anteckning

Du kan bara lägga till eller uppdatera ett textspår på en VOD-tillgång (video-on-demand). Dessutom stöds inte sen bindning av ljud för liveuppspelningstillgångar.

Textspår

Använda textspår med lokalt producerade media

När du har skapat en video lokalt och exporterat undertexter kan du ladda upp dessa undertexter till den tillgång som innehåller dina media på begäran.

Allmänt arbetsflöde för att använda textspår med lokalt producerad text:

  1. Skapa en video och exportera undertexter till en fil som är i VTT- eller TTML-format.
  2. Översätta eller på annat sätt redigera VTT- eller TTML-filen och spara kopior för:
    1. Ett spår för ytterligare ett språk med beskrivande text för att uppfylla tillgänglighetskraven.
    2. Ett spår för ytterligare text för regissörens kommentarer.
  3. VIKTIGT! Du måste lägga till språkdesignaren i VTT-huvudet för att rätt språk ska visas i klientspelaren. Exempel:
    WEBVTT
Language: en-us
  4. Ladda upp videon till Media Services.
  5. Skapa en transformering och ett jobb för att koda videon.
  6. Ladda upp de ytterligare textspåren.

Använda textspår med live-transkription

När live-transkription är aktiverat för en livehändelse skapas ytterligare ett WebVTT-textspår utöver live-transkriptionsspåret i realtid som tittarna ser på livevideospelaren. Den här WebVTT-filen innehåller den bästa versionen av liveavskriften som innehåller fullständiga meningar i stället för de partiella realtidsresultaten. Du kan ladda ned VTT-filen när hela avskriften är tillgänglig och liveutdata tas bort.

Varning

De slutliga VTT-filerna för automatisk genererad live-transkription fördröjs för bearbetning. Om du inte väntar i flera minuter innan du tar bort liveutdata trunkeras innehållet i filen. Dessutom är live-transkription inte tillgängligt för användning med flera indataströmmar för en livehändelse.

Allmänt arbetsflöde för att använda textspår för live-transkription:

  1. Skapa en livehändelse med live-transkription aktiverat och med källspråket valt.
  2. När livehändelsen är över väntar du i flera minuter och tar sedan bort liveutdata. Den arkiverade tillgången kommer att vara tillgänglig för direktuppspelning på begäran. Giltiga direktuppspelnings-URL:er är fortfarande tillgängliga för dina tittare.
  3. Visa spåren i den arkiverade tillgången eller visa dem i portalen. Det kommer att finnas en WebVTT-fil som innehåller NBest-transkriptionen. Det kommer att ha ett VTT-tillägg. Filen heter auto-generated-best_XXX.vtt.
  4. Redigera VTT-filen i Azure Portal eller ladda ned och redigera den.
  5. Om du vill visa textspåret på flera språk översätter du källtextspåret till dessa språk och sparar dem som separata filer för varje språk med tillägget .vtt.
  6. Ladda upp källspråkspåret och textspåren för varje språk.
  7. Om du inte använder Azure Portal för att ladda upp filen redigerar du (eller uppdaterar) .ism-filen för att tala om för spelaren vilka textspår som ska användas samt deras etikettering och synlighet genom att:
    1. Använda API:et Tracks för att uppdatera manifestet programmatiskt med någon av SDK:erna eller CLI:
      1. Node.js
      2. Python
      3. .Net
      4. CLI

Viktigt

När du uppdaterar .ism-filen kontrollerar du att du döljer textspåret för live-transkription och visar textspåret på det språk som är lämpligt för visningsprogrammet.

Ljudspår

Du kan lägga till ytterligare ljudspår till en tillgång för att ge tittarna ljud på olika språk, lägga till beskrivande ljud för tillgänglighet eller lägga till regissörens kommentarer.

Allmänt arbetsflöde för ljudspår

  1. Skapa ytterligare ljudspår för livehändelsen. De kan vara ljud på olika språk eller beskrivande ljud som används för hjälpmedel. Du kan också använda ett ljudspår för regissörens kommentarer.
  2. Ladda upp ljudspåren till den arkiverade tillgången.
  3. Uppdatera spårningsdata genom att redigera manifestfilen i portalen eller genom att uppdatera spårningsdata med hjälp av REST eller en SDK.

Anteckning

När ett ljud- eller textspår tas bort tas inte den underliggande filen bort från lagringscontainern. Media Services anger att den dynamiska paketeraren (slutpunkten för direktuppspelning) inte ska visa informationen om spåret i manifestet eller spellistan som videospelaren begär.

Detaljerade steg för spårar API:et finns i Exemplen nedan.

Exempel

Instruktioner, självstudier och snabbstarter

Få hjälp och support

Du kan kontakta Media Services med frågor eller följa våra uppdateringar med någon av följande metoder: