Transformationen und Aufträge in Media Services

  • Artikel

Media Services-Logo v3

Warnung

Azure Media Services wird am 30. Juni 2024 eingestellt. Weitere Informationen finden Sie im Leitfaden zur Einstellung von AMS.

Tipp

Möchten Sie Miniaturansichten generieren, zwei Videos zusammenfügen, Subclips für ein Video erstellen, das Video drehen oder andere Aktionen ausführen? Sie finden Media Services-Beispielcode auf der Seite Beispiele.

In diesem Thema werden Details zu Transformationen und Aufträgen erläutert und die Beziehung zwischen diesen Entitäten erläutert.

Typischer Workflow

Eine Transformation ist wie ein Rezept. Es hilft Ihnen, das Rezept zu erstellen (Schritt 1) und dann Aufträge mithilfe dieses Rezepts zu übermitteln (Schritt 2).

  1. Erstellen Sie eine Transformation.
  2. Übermitteln Sie Aufträge unter dieser Transformation.
  3. Listen Sie Transformationen auf.
  4. Löschen Sie eine Transformation, wenn Sie nicht vorhaben, sie zukünftig zu verwenden.

Beispiel

Angenommen, Sie möchten jeweils den ersten Frame aller Ihrer Videos als Miniaturbild extrahieren. Dazu müssen Sie die folgenden Schritte ausführen:

  1. Legen Sie die Konfiguration oder Regel für die Verarbeitung Ihrer Videos fest: „den ersten Frame des Videos als Miniaturbild verwenden“.
  2. Für jedes Video würden Sie dem Dienst Folgendes mitteilen:
    1. Wo dieses Video zu finden ist
    2. Wohin die Ausgabe (das Miniaturbild) geschrieben werden soll

Hinweis

Eigenschaften von Transform und Job, die den Datetime-Typ haben, sind immer im UTC-Format angegeben.

Transformationen

Verwenden Sie Transformationen, um allgemeine Aufgaben zur Codierung oder Analyse von Videos zu konfigurieren. Jede Transformation beschreibt eine Vorgehensweise oder einen Workflow von Aufgaben zur Verarbeitung Ihrer Video- oder Audiodateien. Eine einzelne Transformation kann mehrere Regeln anwenden. Eine Transformation kann z.B. angeben, dass jedes Video in eine MP4-Datei mit einer festgelegten Bitrate codiert und eine Miniaturansicht aus dem ersten Bild im Video generiert werden soll. Sie würden für jede Regel, die Sie in die Transformation einfügen möchten, einen TransformOutput-Eintrag hinzufügen. Sie verwenden Voreinstellungen, um der Transformation mitzuteilen, wie die Eingabemediendateien verarbeitet werden sollen.

Anzeigen des Schemas

In Media Services v3 sind Voreinstellungen stark typisierte Entitäten in der API selbst. Die „Schema“-Definition für diese Objekte finden Sie in Offene API-Spezifikation (oder Swagger). Sie finden die voreingestellten Definitionen (wie StandardEncoderPreset) auch in der Referenzdokumentation der REST-API, des .NET SDKs oder eines anderen Media Services v3 SDKs.

Erstellen von Transformationen

Sie können Transformationen mit REST, CLI oder einem der veröffentlichten SDKs erstellen. Die Media Services-v3-API wird von Azure Resource Manager gesteuert. Deshalb können Sie auch Resource Manager-Vorlagen verwenden, um Transformationen in Ihrem Media Services-Konto zu erstellen und bereitzustellen. Mithilfe der rollenbasierten Zugriffssteuerung von Azure können Sie den Zugriff auf Transformationen sperren.

Aktualisieren von Transformationen

Wenn Sie Ihre Transformation aktualisieren müssen, verwenden Sie den Aktualisierungsvorgang. Er ist für das Vornehmen von Änderungen an der Beschreibung oder den Prioritäten der zugrundeliegenden TransformOutputs vorgesehen. Aktualisierungen sollten Sie erst nach Abschluss aller laufenden Aufträge ausführen. Wenn Sie die Konfiguration umschreiben möchten, müssen Sie eine neue Transformation erstellen.

Aufträge

Ein Auftrag ist die eigentliche Anforderung an Media Services, die erstellte Transformation auf ein bestimmtes Eingabevideo oder auf einen Audioinhalt anzuwenden. Nachdem die Transformation erstellt wurde, können Sie mithilfe von Media Services-APIs oder der veröffentlichten SDKs Aufträge übermitteln. Der Auftrag gibt Informationen wie den Speicherort des Eingabevideos und den Speicherort für die Ausgabe an. Sie können den Speicherort Ihres Eingabevideos über HTTPS-URLs, SAS-URLs oder Medienobjekte.

Auftragseingabe über HTTPS

Verwenden Sie eine Auftragseingabe über HTTPS, wenn Ihr Inhalt bereits über eine URL zugänglich ist und Sie die Quelldatei nicht in Azure speichern müssen (z. B. Import von S3). Diese Methode ist auch geeignet, wenn sich der Inhalt im Azure Blob Storage befindet, die Datei aber nicht in einem Medienobjekt gespeichert werden muss. Derzeit unterstützt diese Methode nur eine einzelne Datei für die Eingabe.

Medienobjekt als Auftragseingabe

Verwenden Sie ein Medienobjekt als Auftragseingabe, wenn sich der eingegebene Inhalt bereits in einem Medienobjekt befindet oder der Inhalt in einer lokalen Datei gespeichert ist. Es ist auch eine gute Option, wenn Sie planen, das Eingabemedienobjekt für Streaming oder Download zu veröffentlichen (z. B. wenn Sie die MP4-Datei zum Herunterladen veröffentlichen möchten, aber auch eine Sprach- oder Gesichtserkennung erfolgen soll). Diese Methode unterstützt Medienobjekte mit mehreren Dateien (z. B. MBR-Streamingsätze, die lokal verschlüsselt wurden).

Überprüfen des Auftragsfortschritts

Fortschritt und Status von Aufträgen können abgerufen werden, indem die Ereignisse mit Event Grid überwacht werden. Weitere Informationen finden Sie unter Überwachen von Ereignissen mit EventGrid.

Aktualisieren von Aufträgen

Der Updatevorgang für den Auftrag (Job-Entität) kann verwendet werden, um die Eigenschaften description und priority nach dem Übermitteln des Auftrags zu ändern. Eine Änderung an der priority-Eigenschaft wird nur wirksam, wenn sich der Auftrag noch in der Warteschlange befindet. Wenn die Verarbeitung des Auftrags gestartet oder bereits beendet wurde, hat das Ändern der Priorität keine Auswirkungen.

Codierungsbeispiele

Sehen Sie sich die ausführliche Liste der Codierungsbeispiele für eine Codierung an.

Anfordern von Hilfe und Support

Sie können Media Services mit Fragen kontaktieren oder unsere Updates mit einer der folgenden Methoden verfolgen: