Delen via

Transformaties en taken in Media Services

  • Artikel

Media Services-logo v3

Waarschuwing

Azure Media Services wordt op 30 juni 2024 buiten gebruik gesteld. Zie de handleiding voor buitengebruikstelling van AMS voor meer informatie.

Tip

Wilt u miniaturen genereren, twee video's aan elkaar plakken, een video subclip maken of deze draaien (onder andere)? U vindt voorbeeldcode voor Media Services op de pagina Voorbeelden .

In dit onderwerp vindt u meer informatie over transformaties en taken en wordt de relatie tussen deze entiteiten uitgelegd.

Standaardwerkstroom

Een transformatie is als een recept. Hiermee kunt u het recept eenmaal maken (stap 1) en taken verzenden met behulp van dat recept (stap 2).

  1. Een transformatie maken.
  2. Verzend taken onder die transformatie.
  3. Lijst met transformaties.
  4. Verwijder een transformatie als u deze in de toekomst niet meer wilt gebruiken.

Voorbeeld

Stel dat u het eerste frame van al uw video's wilt extraheren als een miniatuurafbeelding. De stappen zijn:

  1. Definieer het recept of de regel voor het verwerken van uw video's: 'gebruik het eerste frame van de video als miniatuur'.
  2. Voor elke video vertelt u de service het volgende:
    1. Waar vind je die video?
    2. Waar moet ik de miniatuurafbeelding van de uitvoer schrijven.

Notitie

Eigenschappen van transformatie en taak van het type Datum/tijd zijn altijd in UTC-indeling.

Transformaties

Gebruik Transformaties om algemene taken te configureren voor het coderen of analyseren van video's. Elke transformatie beschrijft een recept of een werkstroom van taken voor het verwerken van uw video- of audiobestanden. Eén transformatie kan meer dan één regel toepassen. Een transformatie kan bijvoorbeeld opgeven dat elke video met een bepaalde bitsnelheid wordt gecodeerd in een MP4-bestand en dat een miniatuurafbeelding wordt gegenereerd op basis van het eerste frame van de video. U voegt één TransformOutput-vermelding toe voor elke regel die u wilt opnemen in uw transformatie. U gebruikt voorinstellingen om de Transformatie te vertellen hoe de invoermediabestanden moeten worden verwerkt.

Schema weergeven

In Media Services v3 zijn voorinstellingen sterk getypte entiteiten in de API zelf. U vindt de definitie van het 'schema' voor deze objecten in Open API Specification (of Swagger). U kunt ook de vooraf ingestelde definities (zoals StandardEncoderPreset) weergeven in de REST API, .NET SDK of andere media services v3 SDK-referentiedocumentatie.

Transformaties maken

U kunt transformaties maken met behulp van REST, CLI of een van de gepubliceerde SDK's. De Media Services v3-API wordt aangestuurd door Azure Resource Manager, dus u kunt ook Resource Manager sjablonen gebruiken om transformaties te maken en implementeren in uw Media Services-account. Op rollen gebaseerd toegangsbeheer van Azure kan worden gebruikt om de toegang tot transformaties te vergrendelen.

Transformaties bijwerken

Als u de transformatie wilt bijwerken, gebruikt u de bewerking Bijwerken . Het is bedoeld voor het aanbrengen van wijzigingen in de beschrijving of de prioriteiten van de onderliggende TransformOutputs. U moet updates voltooien wanneer alle actieve taken zijn voltooid. Als u het recept wilt herschrijven, moet u een nieuwe transformatie maken.

Taken

Een taak is de daadwerkelijke aanvraag aan Media Services om de transformatie toe te passen op een bepaalde invoer van video- of audio-inhoud. Zodra de transformatie is gemaakt, kunt u taken verzenden met behulp van Media Services-API's of een van de gepubliceerde SDK's. De taak bevat informatie zoals de locatie van de invoervideo en de locatie voor de uitvoer. U kunt de locatie van uw invoervideo opgeven met behulp van: HTTPS-URL's, SAS-URL's of Assets.

Taakinvoer van HTTPS

Gebruik taakinvoer van HTTPS als uw inhoud al toegankelijk is via een URL en u het bronbestand niet hoeft op te slaan in Azure (bijvoorbeeld importeren vanuit S3). Deze methode is ook geschikt als u de inhoud in Azure Blob Storage hebt, maar het bestand niet in een asset hoeft te bevinden. Op dit moment ondersteunt deze methode slechts één bestand voor invoer.

Asset as Job-invoer

Gebruik een asset als taakinvoer als de invoerinhoud zich al in een asset bevindt of als de inhoud is opgeslagen in een lokaal bestand. Het is ook een goede optie als u van plan bent om de invoerasset te publiceren voor streaming of downloaden (stel dat u de mp4 wilt publiceren om te downloaden, maar ook spraak-naar-tekst- of gezichtsdetectie wilt uitvoeren). Deze methode ondersteunt assets met meerdere bestanden (bijvoorbeeld MBR-streamingsets die lokaal zijn gecodeerd).

Taakvoortgang controleren

De voortgang en status van taken kunnen worden verkregen door gebeurtenissen te bewaken met Event Grid. Zie Gebeurtenissen bewaken met EventGrid voor meer informatie.

Taken bijwerken

De bewerking Bijwerken op de entiteit Taak kan worden gebruikt om de beschrijving en de prioriteitseigenschappen te wijzigen nadat de taak is verzonden. Een wijziging in de eigenschap Prioriteit is alleen van kracht als de taak zich nog in een wachtrijstatus bevindt. Als de taak is begonnen met verwerken of is voltooid, heeft het wijzigen van de prioriteit geen effect.

Voorbeelden van codering

Zie de uitgebreide lijst met coderingsvoorbeelden voor een codering.

Help en ondersteuning

U kunt contact opnemen met Media Services als u vragen hebt of onze updates op een van de volgende manieren volgen: