Transformeringar och jobb i Media Services

  • Artikel

Media Services-logotyp v3

Varning

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

Tips

Vill du skapa miniatyrbilder, sammanfoga två videor, underordna en video eller rotera den (bland annat)? Du hittar Media Services-exempelkod på sidan Exempel .

Det här avsnittet innehåller information om transformeringar och jobb och förklarar relationen mellan dessa entiteter.

Typiskt arbetsflöde

En transformering är som ett recept. Det hjälper dig att skapa receptet en gång (steg 1) och skicka jobb med det receptet (steg 2).

  1. Skapa en transformering.
  2. Skicka jobb under transformen.
  3. Lista transformeringar.
  4. Ta bort en transformering om du inte planerar att använda den i framtiden.

Exempel

Anta att du vill extrahera den första bildrutan i alla dina videor som en miniatyrbild – stegen du skulle vidta är:

  1. Definiera receptet eller regeln för bearbetning av videor: "använd den första bildrutan i videon som miniatyrbild".
  2. För varje video skulle du berätta för tjänsten:
    1. Var du hittar videon.
    2. Var du skriver miniatyrbilden för utdata.

Anteckning

Egenskaperna för Transformering och Jobb för Datetime-typen är alltid i UTC-format.

Transformering

Använd transformeringar för att konfigurera vanliga uppgifter för att koda eller analysera videor. Varje transformering beskriver ett recept eller ett arbetsflöde med uppgifter för bearbetning av video- eller ljudfiler. En enda transformering kan tillämpa mer än en regel. En transformering kan till exempel ange att varje video ska kodas till en MP4-fil vid en viss bithastighet och att en miniatyrbild ska genereras från videons första bildruta. Du lägger till en TransformOutput-post för varje regel som du vill inkludera i din transformering. Du använder förinställningar för att berätta för Transformera hur indatamediefilerna ska bearbetas.

Visa schema

I Media Services v3 är förinställningar starkt typifierade entiteter i själva API:et. Du hittar definitionen "schema" för dessa objekt i Open API Specification (eller Swagger). Du kan också visa förinställda definitioner (till exempel StandardEncoderPreset) i REFERENSdokumentationen för REST API, .NET SDK eller andra Media Services v3 SDK.

Skapa transformeringar

Du kan skapa transformeringar med hjälp av REST, CLI eller någon av de publicerade SDK:erna. Media Services v3-API:et drivs av Azure Resource Manager, så du kan också använda Resource Manager mallar för att skapa och distribuera transformeringar i ditt Media Services-konto. Rollbaserad åtkomstkontroll i Azure kan användas för att låsa åtkomsten till transformeringar.

Uppdatera transformeringar

Om du behöver uppdatera din transformering använder du uppdateringsåtgärden . Den är avsedd att göra ändringar i beskrivningen eller prioriteringarna för de underliggande TransformOutputs. Du bör slutföra uppdateringar när alla pågående jobb har slutförts. Om du tänker skriva om receptet måste du skapa en ny transformering.

Jobb

Ett jobb är den faktiska begäran till Media Services om att tillämpa transformering på ett angivet indatavideo- eller ljudinnehåll. När transformering har skapats kan du skicka jobb med Media Services-API:er eller någon av de publicerade SDK:erna. Jobbet anger information som platsen för indatavideon och platsen för utdata. Du kan ange platsen för din indatavideo med hjälp av: HTTPS-URL:er, SAS-URL:er eller tillgångar.

Jobbindata från HTTPS

Använd jobbindata från HTTPS om ditt innehåll redan är tillgängligt via en URL och du inte behöver lagra källfilen i Azure (till exempel importera från S3). Den här metoden är också lämplig om du har innehållet i Azure Blob Storage, men inte har något behov av att filen finns i en tillgång. Den här metoden stöder för närvarande endast en enda fil för indata.

Tillgång som jobbindata

Använd en tillgång som jobbindata om indatainnehållet redan finns i en tillgång eller om innehållet lagras i en lokal fil. Det är också ett bra alternativ om du planerar att publicera indatatillgången för direktuppspelning eller nedladdning (anta att du vill publicera mp4 för nedladdning men även vill göra tal till text eller ansiktsidentifiering). Den här metoden stöder tillgångar med flera filer (till exempel MBR-strömningsuppsättningar som har kodats lokalt).

Kontrollera jobbstatus

Jobbens förlopp och tillstånd kan hämtas genom övervakning av händelser med Event Grid. Mer information finns i Övervaka händelser med EventGrid.

Uppdaterar jobb

Åtgärden Uppdatera på entiteten Jobb kan användas för att ändra beskrivningen och prioritetsegenskaperna efter att jobbet har skickats. En ändring av prioritetsegenskapen gäller endast om jobbet fortfarande är i kötillstånd. Om jobbet har börjat bearbetas eller har slutförts har ändringsprioritet ingen effekt.

Kodningsexempel

Se den omfattande listan över kodningsexempel för en kodning.

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: