Partager via

Recommandations en matière de migration basées sur un scénario d’encodage

  • Article

logo du guide de migration

étapes de migration 2

Important

Il n’est plus nécessaire de migrer d’Azure Media Service v2 vers v3, car la dépréciation de l’API V2 s’alignera sur la mise hors service d’Azure Media Services. Pour plus d’informations, consultez le guide de mise hors service d’Azure Media Services .

Cet article fournit des conseils basés sur un scénario d’encodage qui vous aideront à migrer d’Azure Media Services v2 vers v3.

Prérequis

Avant de commencer à modifier votre flux de travail d’encodage, vous devez comprendre les différences dans la façon dont le stockage est géré. Dans AMS v3, l’API de Stockage Azure est utilisée pour gérer les comptes de stockage associés à votre compte Media Services.

Notes

Les travaux et tâches créés dans v2 n’apparaissent pas dans v3, car ils ne sont pas associés à une transformation. Il est recommandé de basculer vers des transformations et travaux v3.

Comparaison du flux de travail d’encodage

Prenez quelques minutes pour examiner les organigrammes ci-dessous, qui présentent une comparaison visuelle des flux de travail d’encodage pour les versions v2 et v3.

Flux de travail d’encodage v2

Cliquez sur l’image ci-dessous pour afficher une version plus volumineuse.

Flux de travail d’encodage pour V2

  1. Configuration
    1. Créez un ressource ou utilisez une ressource existante. Si vous utilisez une nouvelle ressource, chargez le contenu vers celle-ci. Si vous utilisez une ressource existante, vous devez encoder des fichiers qui existent déjà dans la ressource.
    2. Copiez les valeurs des éléments suivants :
      • ID ou objet de processeur multimédia ;
      • chaîne d’encodeur (nom) de l’encodeur que vous souhaitez utiliser ;
      • ID de ressource de la nouvelle ressource ou de la ressource existante.
    3. Pour la surveillance, créez un travail, un abonnement aux notifications de niveau tâche ou un gestionnaire d’événements SDK.
  2. Créez le travail contenant les tâches. Chaque tâche doit inclure les éléments ci-dessus et :
    • une directive stipulant qu’une ressource de sortie doit être créée, que créée système ;
    • Nom facultatif pour la ressource de sortie.
  3. Envoyez le travail.
  4. Surveillez la tâche.

Flux de travail d’encodage v3

Flux de travail d’encodage pour v3

  1. Configurer
    1. Créez une ressource ou utilisez une ressource existante. Si vous utilisez une nouvelle ressource, chargez le contenu vers celle-ci. Si vous utilisez une ressource existante, vous devez encoder des fichiers qui existent déjà dans la ressource. Vous ne devez pas charger plus de contenu dans cette ressource.
    2. Créez une ressource de sortie. La ressource de sortie est l’emplacement où seront stockés les fichiers encodés et les métadonnées d’entrée et de sortie.
    3. Obtenez les valeurs pour la transformation :
      • présélection d’encodeur Standard ;
      • groupe de ressources AMS ;
      • nom du compte AMS.
    4. Créez la transformation ou utilisez une transformation existante. Les transformations sont réutilisables. Il n’est pas nécessaire de créer une transformation chaque fois que vous souhaitez soumettre un travail.
  2. Créer un travail
    1. Pour le travail, obtenez les valeurs pour les éléments suivants :
      • nom de la transformation ;
      • URI de base de l’URL SAS de votre ressource, chemin d’accès source HTTPs de votre partage de fichiers ou chemin d’accès local des fichiers ; La JobInputAsset peut également utiliser un nom de ressource en guise d’entrée.
      • nom(s) de fichier ;
      • ressource(s) de sortie ;
      • Un groupe de ressources
      • nom du compte AMS.
  3. Utilisez Event Grid pour surveiller votre travail.
  4. Envoyez le travail.

Présélections personnalisées de l’encodage v2 à l’encodage V3

Si votre code V2 a appelé l’encodeur Standard avec une présélection personnalisée, vous commencez par créer une transformation avec la présélection d’encodeur Standard personnalisé avant de soumettre un travail.

Les présélections personnalisées sont désormais JSON et ne sont plus basées sur XML. Recréez votre présélection en JSON, en suivant le schéma de présélection personnalisée, tel que défini dans la documentation de l’API Transform Open (Swagger).

Fichiers de métadonnées d’entrée et de sortie d’une tâche d’encodage

Dans la v2, les fichiers XML de métadonnées entrants et sortants sont générés à la suite d’un travail d’encodage. Dans la v3, le format de métadonnées est passé de XML à JSON. Pour plus d’informations sur les métadonnées, consultez Métadonnées d’entrée et Métadonnées de sortie.

D’encodeur Premium à encodeur Standard v3 ou solutions basées sur les partenaires

L’API v2 ne prend plus en charge l’encodeur Premium. Si vous avez précédemment utilisé l’encodeur Premium basé sur un flux de travail pour HEVC, l’encodage doit opérer une migration vers le nouvel encodeur Standard v3 avec prise en charge de l’encodage HEVC.

Si vous avez besoin des fonctionnalités de flux de travail avancées de l’encodeur Premium, il est recommandé de commencer à utiliser une solution de partenaire d’encodage avancé Azure de Imagine Communications, Telestream ou Bitmovin.

Travaux avec des entrées qui se trouvent sur des URL hébergées HTTPS

Vous pouvez à présent soumettre des travaux dans v3 à partir de fichiers stockés dans Stockage Azure, localement, ou sur des serveurs Web externes à l’aide de la prise en charge d’entrée de travail HTTP(S).

Si vous avez précédemment utilisé des flux de travail pour copier des fichiers à partir de fichiers d’objets blob Azure dans des ressources vides avant de soumettre des travaux, vous pouvez simplifier votre flux de travail en passant une URL SAS pour le fichier dans le Stockage Blob Azure directement dans le travail.

Transcription audio d’indexeur v1 au nouveau « mode de base » AudioAnalyzer

Pour les clients qui utilisent le processeur indexeur v1 dans l’API v2, vous devez créer une transformation qui appelle le nouvel AudioAnalyzer en mode de base avant de soumettre un travail.

Concepts, tutoriels et guides pratiques concernant l’encodage, les transformations et les travaux

Obtenir de l’aide et du support

Vous pouvez contacter Media Services pour vous poser des questions ou suivre nos mises à jour en suivant l’une des méthodes suivantes :