Szenariobasierter Migrationsleitfaden für die Codierung

  • Artikel

Logo des Migrationsleitfadens

Schritte bei der Migration 2

Wichtig

Es ist nicht mehr erforderlich, von Azure Media Service v2 zu v3 zu migrieren, da die Veraltetkeit der V2-API mit der Einstellung von Azure Media Services übereinstimmt. Weitere Informationen finden Sie im Leitfaden zur Einstellung von Azure Media Services .

Dieser Artikel enthält Codierungsszenario-basierte Anleitungen, die Sie bei der Migration von Azure Media Services v2 zu v3 unterstützen.

Voraussetzungen

Bevor Sie mit dem Ändern des Codierungsworkflows beginnen, sollten Sie sich mit den Unterschieden in der Speicherverwaltung vertraut machen. In AMS V3 erfolgt die Verwaltung der Speicherkonten, die Ihrem Media Services Konto zugeordnet sind, über die Azure Storage-API.

Hinweis

In V2 erstellte Aufträge und Aufgaben werden in V3 nicht angezeigt, da sie keiner Transformation zugeordnet sind. Es wird empfohlen, zu V3-Transformationen und -Aufträgen zu wechseln.

Vergleich der Codierungsworkflows

Nehmen Sie sich einige Minuten Zeit, und sehen Sie sich die unten aufgeführten Flussdiagramme an, in denen die Codierungsworkflows in V2 und V3 verglichen werden.

V2-Codierungsworkflow

Klicken Sie auf das Bild unten, um eine größere Version anzuzeigen.

Codierungsworkflow für V2

  1. Einrichtung
    1. Erstellen Sie ein Medienobjekt, oder verwenden Sie ein vorhandenes Objekt. Wenn Sie ein neues Medienobjekt verwenden, laden Sie Inhalt in dieses Medienobjekt hoch. Bei einem vorhandenen Medienobjekt sollten Sie Dateien codieren, die bereits im Medienobjekt vorhanden sind.
    2. Rufen Sie die Werte der folgenden Elemente ab:
      • Medienprozessor-ID oder Objekt
      • Codierungszeichenfolge (Name) des Encoders, den Sie verwenden möchten
      • Objekt-ID des neuen Medienobjekts ODER Objekt-ID des vorhandenen Medienobjekts
    3. Erstellen Sie für die Überwachung ein Benachrichtigungsabonnement auf Auftrags- oder auf Aufgabenebene oder einen SDK-Ereignishandler.
  2. Erstellen Sie den Auftrag, der die Aufgaben enthält. Jede Aufgabe sollte die oben genannten Elemente und dazu noch Folgendes enthalten:
    • Eine Anweisung, dass ein Ausgabemedienobjekt erstellt werden muss. Das Ausgabemedienobjekt wird vom System erstellt.
    • Den optionalen Namen für das Ausgabemedienobjekt
  3. Übermitteln des Auftrags.
  4. Überwachen Sie den Auftrag.

V3-Codierungsworkflow

Codierungsworkflow für V3

  1. Einrichten
    1. Erstellen Sie ein Objekt, oder verwenden Sie ein bereits vorhandenes Objekt. Wenn Sie ein neues Medienobjekt verwenden, laden Sie Inhalt in dieses Medienobjekt hoch. Bei einem vorhandenen Medienobjekt sollten Sie Dateien codieren, die bereits im Medienobjekt vorhanden sind. Sie sollten keine weiteren Inhalte in das Medienobjekt hochladen.
    2. Erstellen eines Ausgabemedienobjekts Im Ausgabemedienobjekt werden die codierten Dateien sowie die Eingabe- und Ausgabemetadaten gespeichert.
    3. Rufen Sie die Werte für die Transformation ab:
      • Voreinstellungen für den Media Encoder Standard
      • AMS-Ressourcengruppe
      • AMS-Kontoname
    4. Erstellen Sie eine Transformation, oder verwenden Sie eine vorhandene Transformation. Transformationen sind wiederverwendbar. Es ist nicht erforderlich, jedes Mal für jede Übermittlung eines Auftrags eine neue Transformation zu erstellen.
  2. Erstellen eines Auftrags
    1. Rufen Sie für den Auftrag die Werte der folgenden Elemente ab:
      • Transformationsname
      • Basis-URI für die SAS-URL für Ihr Medienobjekt, HTTPS-Quellpfad der Dateifreigabe oder lokaler Pfad der Dateien. JobInputAsset kann auch einen Objektnamen als Eingabe verwenden.
      • Dateinamen
      • Ausgabemedienobjekte
      • Eine Ressourcengruppe
      • AMS-Kontoname
  3. Verwenden Sie für das Überwachen Ihres Auftrags Event Grid.
  4. Übermitteln des Auftrags.

Benutzerdefinierte Voreinstellungen für die Codierung bei V2 und V3

Wenn Ihr V2-Code den Media Encoder Standard mit einer benutzerdefinierten Voreinstellung aufgerufen hat, mussten Sie zunächst eine neue Transformation mit der benutzerdefinierten Voreinstellung für den Media Encoder Standard erstellen, bevor Sie einen Auftrag übermitteln konnten.

Die benutzerdefinierten Voreinstellungen basieren nun auf JSON und nicht mehr auf XML. Erstellen Sie Ihre Voreinstellung in JSON neu, und befolgen Sie dabei das Schema für benutzerdefinierte Voreinstellungen gemäß der Definition für die offene Transform-API (Swagger).

Metadatendateien für Ein- und Ausgabe für einen Codierungsauftrag

In v2 werden Eingabe- und Ausgabe-Metadatendateien als Ergebnis eines Codierungsauftrags generiert. In v3 wurde das Metadatenformat von XML in JSON geändert. Weitere Informationen zu Metadaten finden Sie unter Eingabemetadaten und Ausgeben von Metadaten.

Premium-Encoder zum V3-Media Encoder Standard oder zu Partnerlösungen

Der Premium-Encoder wird von der V2-API nicht mehr unterstützt. Wenn Sie zuvor den workflowbasierten Premium-Encoder für die HEVC-Codierung verwendet haben, sollten Sie zum neuen V3-Media Encoder Standard mit Unterstützung für die HEVC-Codierung migrieren.

Wenn Sie die erweiterten Workflowfunktionen des Premium-Encoders benötigen, sollten Sie eine der erweiterten Partnerlösungen für die Codierung in Azure von Imagine Communications, Telestream oder Bitmovin einsetzen.

Aufträge mit Eingaben von URLs über HTTPS

Sie können nun Aufträge in V3 aus Dateien übermitteln, die in Azure Storage, lokal oder auf externen Webservern gespeichert sind. Dies wird durch die Unterstützung für HTTP(S)-Auftragseingaben möglich.

Wenn Sie zuvor Workflows zum Kopieren von Dateien aus Azure-Blobdateien in leere Medienobjekte vor der Übermittlung von Aufträgen verwendet haben, können Sie Ihren Workflow nun vereinfachen, indem Sie direkt im Auftrag eine SAS-URL für die Datei in Azure Blob Storage übergeben.

Indexer V1-Audioaufzeichnung im neuen „einfachen Modus“ von AudioAnalyzer

Für Kunden, die den Indexer V1-Prozessor in der V2-API verwenden, müssen Sie vor dem Übermitteln eines Auftrags eine Transformation erstellen, die den neuen AudioAnalyzer im einfachen Modus aufruft.

Konzepte, Tutorials und Schrittanleitungen für Codierung, Transformationen und Aufträge

Anfordern von Hilfe und Support

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