Conseils de migration pour le passage de Media Services v2 à Media Services v3Migration guidance for moving from Media Services v2 to v3

Soyez notifié de la disponibilité des mises à jour sur cette page en faisant un copier-coller de cette URL : https://docs.microsoft.com/api/search/rss?search=%22Migrate+from+Azure+Media+Services+v2+to+v3%22&locale=en-us dans votre lecteur de flux RSS.Get notified about when to revisit this page for updates by copying and pasting this URL: https://docs.microsoft.com/api/search/rss?search=%22Migrate+from+Azure+Media+Services+v2+to+v3%22&locale=en-us into your RSS feed reader.

Cet article décrit les changements introduits dans Azure Media Services v3, montre les différences entre les deux versions, et fournit des conseils en matière de migration.This article describes changes that were introduced in Azure Media Services v3, shows differences between two versions, and provides the migration guidance.

Si vous avez un service vidéo développé aujourd’hui sur la base des API héritées de Media Services v2, vous devez prendre en compte les instructions et considérations suivantes avant d’opérer une migration vers les API v3.If you have a video service developed today on top of the legacy Media Services v2 APIs, you should review the following guidelines and considerations prior to migrating to the v3 APIs. Les API v3 présentent un grand nombre d’avantages et de fonctionnalités nouvelles qui améliorent l’expérience de développement et les fonctionnalités de Media Services.There are many benefits and new features in the v3 API that improve the developer experience and capabilities of Media Services. Toutefois, comme mentionné dans la section Problèmes connus de cet article, il existe certaines limitations résultant de différences entre les versions d’API.However, as called out in the Known Issues section of this article, there are also some limitations due to changes between the API versions. Cette page sera actualisée à mesure que l’équipe Media Services apportera des améliorations continues aux API v3, et traitera des différences entre les versions.This page will be maintained as the Media Services team makes continued improvements to the v3 APIs and addresses the gaps between the versions.

Notes

Actuellement, vous ne pouvez pas utiliser le portail Azure pour gérer des ressources v3.Currently, you cannot use the Azure portal to manage v3 resources. Utilisez l’API REST, l’interface CLI ou l’un des kits SDK pris en charge.Use the REST API, CLI, or one of the supported SDKs.

Avantages de Media Services v3Benefits of Media Services v3

L’API est plus accessibleAPI is more approachable

  • v3 est basée sur une surface d’API unifiée qui expose des fonctionnalités de gestion et de fonctionnement qui s’appuient sur Azure Resource Manager.v3 is based on a unified API surface, which exposes both management and operations functionality built on Azure Resource Manager. Vous pouvez utiliser les modèles Azure Resource Manager pour créer et déployer des transformations, des points de terminaison de streaming, des événements en direct, etc.Azure Resource Manager templates can be used to create and deploy Transforms, Streaming Endpoints, Live Events, and more.
  • Document sur la spécification OpenAPI (anciennement Swagger).OpenAPI Specification (formerly called Swagger) document. Expose le schéma pour tous les composants de service, dont l’encodage basé sur un fichier.Exposes the schema for all service components, including file-based encoding.
  • Kits de développement logiciel (SDK) disponibles pour .NET, .NET Core, Node.js, Python, Java, Go et Ruby.SDKs available for .NET, .NET Core, Node.js, Python, Java, Go, and Ruby.
  • Intégration d’Azure CLI pour la prise en charge de scripts simples.Azure CLI integration for simple scripting support.

Nouvelles fonctionnalitésNew features

  • Pour le traitement de travaux basé sur un fichier, vous pouvez utiliser une URL HTTP(S) comme entrée.For file-based Job processing, you can use a HTTP(S) URL as the input.
    Vous n’avez pas besoin de contenu déjà stocké dans Azure, ou de créer des ressources.You do not need to have content already stored in Azure, nor do you need to create Assets.
  • Introduit le concept de transformations pour le traitement de travaux basé sur fichier.Introduces the concept of Transforms for file-based Job processing. Vous pouvez utiliser une transformation pour créer des configurations réutilisables, créer des modèles Azure Resource Manager, et isoler des paramètres de traitement entre plusieurs clients ou locataires.A Transform can be used to build reusable configurations, to create Azure Resource Manager Templates, and isolate processing settings between multiple customers or tenants.
  • Un actif multimédia peut avoir plusieurs localisateurs de streaming, chacun avec des paramètres différents d’empaquetage dynamique et de chiffrement dynamique.An Asset can have multiple Streaming Locators each with different Dynamic Packaging and Dynamic Encryption settings.
  • La protection du contenu prend en charge les fonctionnalités à plusieurs clés.Content protection supports multi-key features.
  • Vous pouvez diffuser des événements en direct d’une durée maximale de 24 heures quand vous utilisez Media Services pour transcoder un flux de contribution à une seule vitesse de transmission en un flux de sortie à vitesse de transmission multiple.You can stream Live Events that are up to 24 hours long when using Media Services for transcoding a single bitrate contribution feed into an output stream that has multiple bitrates.
  • Nouvelle prise en charge du streaming en direct à faible latence sur des événements en direct.New Low Latency live streaming support on Live Events. Pour plus d’informations, consultez latence.For more information, see latency.
  • L’aperçu des événements en direct prend en charge l’empaquetage dynamique et le chiffrement dynamique.Live Event Preview supports Dynamic Packaging and Dynamic Encryption. Ceci permet la protection du contenu sur l’aperçu, ainsi que l’empaquetage DASH et HLS.This enables content protection on Preview as well as DASH and HLS packaging.
  • La sortie en direct est plus simple à utiliser que l’entité Program dans les API v2.Live Output is simpler to use than the Program entity in the v2 APIs.
  • Prise en charge améliorée de RTMP (stabilité accrue et meilleure prise en charge de l’encodeur source).Improved RTMP support (increased stability and more source encoder support).
  • Ingestion sécurisée RTMPS.RTMPS secure ingest.
    Quand vous créez un événement en direct, vous obtenez 4 URL de réception.When you create a Live Event, you get 4 ingest URLs. Les 4 URL d’ingestion sont presque identiques, ont le même jeton de streaming (AppId) ; seule la partie du numéro de port est différente.The 4 ingest URLs are almost identical, have the same streaming token (AppId), only the port number part is different. Il existe deux URL principales et de secours pour RTMPS.Two of the URLs are primary and backup for RTMPS.
  • Vous disposez d’un contrôle d’accès en fonction du rôle (RBAC) sur vos entités.You have role-based access control (RBAC) over your entities.

Changements par rapport à la v2Changes from v2

  • Pour les ressources créées avec la version v3, Media Services prend en charge uniquement le chiffrement du stockage côté serveur de Stockage Azure.For assets created with v3, Media Services supports only the Azure Storage server-side storage encryption.
    • Vous pouvez utiliser des API v3 avec des ressources créées à l’aide d’API v2 qui disposaient d’un chiffrement de stockage (AES 256) fourni par Media Services.You can use v3 APIs with Assets created with v2 APIs that had storage encryption (AES 256) provided by Media Services.
    • Vous ne pouvez pas créer de ressources avec le chiffrement du stockage AES 256 hérité à l’aide d’API v3.You cannot create new Assets with the legacy AES 256 storage encryption using v3 APIs.
  • Si les propriétés de la ressource dans v3 sont différentes de celles de v2, voir comment les propriétés sont mappées.The Asset's properties in v3 differ to from v2, see how the properties map.
  • Les kits de développement logiciel (SDK) v3 sont dissociés du Storage SDK, ce qui vous offre davantage de contrôle sur la version de SDK Stockage à utiliser, et évite les problèmes de gestion de version.The v3 SDKs are now decoupled from the Storage SDK, which gives you more control over the version of Storage SDK you want to use and avoids versioning issues.
  • Dans les API v3, toutes les vitesses d’encodage sont exprimées en bits par seconde.In the v3 APIs, all of the encoding bit rates are in bits per second. Ceci diffère des préréglages de Media Encoder Standard v2.This is different than the v2 Media Encoder Standard presets. Par exemple, un débit en bits dans v2 exprimé sous la forme 128 Kbits/s, sera exprimé dans v3 sous la forme 128000 (bits/seconde).For example, the bitrate in v2 would be specified as 128 (kbps), but in v3 it would be 128000 (bits/second).
  • Les entités AssetFiles, AccessPolicies et IngestManifests n’existent pas dans v3.Entities AssetFiles, AccessPolicies, and IngestManifests do not exist in v3.
  • La propriété IAsset.ParentAssets n’existe pas dans la version 3.The IAsset.ParentAssets property does not exist in v3.
  • ContentKeys n’est plus une entité, mais une propriété du localisateur de streaming.ContentKeys is no longer an entity, it is now a property of the Streaming Locator.
  • La prise en charge de la grille d’événements remplace NotificationEndpoints.Event Grid support replaces NotificationEndpoints.
  • Les entités suivantes ont été renommées :The following entities were renamed
    • JobOutput remplace Task et fait désormais partie d’un travail.Job Output replaces Task, and is now part of a Job.
    • StreamingLocator remplace Locator.Streaming Locator replaces Locator.
    • LiveEvent remplace Channel.Live Event replaces Channel.
      La facturation des événements en direct est basée sur les compteurs de canal live.Live Events billing is based on Live Channel meters. Pour plus d’informations, consultez facturation et tarifs.For more information, see billing and pricing.
    • LiveOutput remplace Program.Live Output replaces Program.
  • Les sorties en direct démarrent dès leur création et s’arrêtent à leur suppression.Live Outputs start on creation and stop when deleted. Les programmes fonctionnaient différemment dans les API v2. Il fallait les démarrer après leur création.Programs worked differently in the v2 APIs, they had to be started after creation.
  • Pour obtenir des informations sur un travail, vous devez connaître le nom de la transformation sous lequel le travail a été créé.To get information about a job, you need to know the Transform name under which the job was created.
  • 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.In v2, XML input and output metadata files get generated as the result of an encoding job. Dans la v3, le format de métadonnées est passé de XML à JSON.In v3, the metadata format changed from XML to JSON.

Notes

Examinez les conventions d’affectation de noms appliquées aux ressources Media Services v3.Review the naming conventions that are applied to Media Services v3 resources. Voir également Attribution de noms à des objets blob.Also review naming blobs.

Différences de fonctionnalités par rapport aux API v2Feature gaps with respect to v2 APIs

Les API v3 présentent les différences de fonctionnalités suivantes par rapport aux API v2.The v3 API has the following feature gaps with respect to the v2 API. Le gommage de ces différences est en cours.Closing the gaps is work in progress.

  • L’Encodeur Premium et les processeurs d’analytique multimédia hérités (indexeur Azure Media Services 2 en préversion, Face Redactor, etc.) ne sont pas accessibles via v3.The Premium Encoder and the legacy media analytics processors (Azure Media Services Indexer 2 Preview, Face Redactor, etc.) are not accessible via v3.
    Les clients qui souhaitent migrer à partir de l’indexeur multimédia 1 ou 2 en préversion peuvent utiliser immédiatement l’AudioAnalyzer prédéfini dans l’API v3.Customers who wish to migrate from the Media Indexer 1 or 2 preview can immediately use the AudioAnalyzer preset in the v3 API. Cet nouveau préréglage contient davantage de fonctionnalités que l’ancien indexeur multimédia 1 ou 2.This new preset contains more features than the older Media Indexer 1 or 2.

  • La plupart des fonctionnalités avancées de Media Encoder Standard dans les API v2 ne sont actuellement pas disponibles dans v3, par exemple :Many of the advanced features of the Media Encoder Standard in v2 APIs are currently not available in v3, such as:

    • Combinaison de ressourcesStitching of Assets
    • SuperpositionsOverlays
    • RognageCropping
    • Sprites de miniaturesThumbnail Sprites
    • Insertion d’une piste audio en mode silencieux lorsque l’entrée ne produit pas de sonInserting a silent audio track when input has no audio
    • Insertion d’une piste vidéo lorsque l’entrée ne comporte aucune vidéoInserting a video track when input has no video
  • Les événements en direct avec transcodage ne gèrent actuellement pas l’insertion d’ardoise à mi-parcours ni l’insertion de marqueur publicitaire par le biais d’un appel d’API.Live Events with transcoding currently do not support Slate insertion mid-stream and ad marker insertion via API call.

Notes

Veuillez marquer cet article d’un signet afin de pouvoir continuer à suivre les mises à jour.Please bookmark this article and keep checking for updates.

Différences de codeCode differences

Le tableau suivant présente les différences de code entre v2 et v3 pour des scénarios courants.The following table shows the code differences between v2 and v3 for common scenarios.

ScénarioScenario API V2V2 API API V3V3 API
Créer une ressource et charger un fichierCreate an asset and upload a file Exemple .NET v2v2 .NET example Exemple .NET v3v3 .NET example
Soumettre un travailSubmit a job Exemple .NET v2v2 .NET example Exemple .NET v3v3 .NET example

Montre comment créer au préalable une transformation, puis soumettre un travail.Shows how to first create a Transform and then submit a Job.
Publier une ressource avec chiffrement AESPublish an asset with AES encryption 1. Créer une ContentKeyAuthorizationPolicyOption1. Create ContentKeyAuthorizationPolicyOption
2. Créer une ContentKeyAuthorizationPolicy2. Create ContentKeyAuthorizationPolicy
3. Créer une AssetDeliveryPolicy3. Create AssetDeliveryPolicy
4. Créer une ressource et charger du contenu OU soumettre un travail et utiliser une ressource en sortie4. Create Asset and upload content OR Submit job and use output asset
5. Associer une AssetDeliveryPolicy à un Asset5. Associate AssetDeliveryPolicy with Asset
6. Créer une ContentKey6. Create ContentKey
7. Attacher un ContentKey à un Asset7. Attach ContentKey to Asset
8. Créer une AccessPolicy8. Create AccessPolicy
9. Créer un Locator9. Create Locator

Exemple .NET v2v2 .NET example
1. Créer une stratégie de clé de contenu1. Create Content Key Policy
2. Créer un Asset2. Create Asset
3. Charger du contenu ou utiliser un Asset comme JobOutput3. Upload content or use Asset as JobOutput
4. Créer un localisateur de streaming4. Create Streaming Locator

Exemple .NET v3v3 .NET example
Obtenir des détails de travaux et gérer des travauxGet job details and manage jobs Gérer des travaux avec v2Manage jobs with v2 Gérer des travaux avec v3Manage jobs with v3

Problèmes connusKnown issues

  • Actuellement, vous ne pouvez pas utiliser le portail Azure pour gérer des ressources v3.Currently, you cannot use the Azure portal to manage v3 resources. Utilisez l’API REST, Azure CLI ou l’un des kits de développement logiciel (SDK) pris en charge.Use the REST API, CLI, or one of the supported SDKs.
  • Vous devez provisionner des unités réservées Multimédia (MRU) dans votre compte afin de contrôler la concurrence et les performances de vos travaux, en particulier ceux impliquant une analyse audio ou vidéo.You need to provision Media Reserved Units (MRUs) in your account in order to control the concurrency and performance of your Jobs, particularly ones involving Video or Audio Analysis. Pour plus d’informations, consultez Mise à l’échelle du traitement multimédia.For more information, see Scaling Media Processing. Vous pouvez gérer les MRU à l’aide de CLI 2.0 pour Media Services v3, du portail Azure ou des API v2.You can manage the MRUs using CLI 2.0 for Media Services v3, using the Azure portal, or using the v2 APIs. Vous devez provisionner des unités réservées Multimédia, indépendamment de la version (v2 ou v3) des API Media Services que vous utilisez.You need to provision MRUs, whether you are using Media Services v2 or v3 APIs.
  • Des entités Media Services créées avec l’API v3 ne peuvent pas être gérées avec l’API v2.Media Services entities created with the v3 API cannot be managed by the v2 API.
  • Il n’est pas recommandé de gérer les entités créées avec des API v2 via les API v3.It is not recommended to manage entities that were created with v2 APIs via the v3 APIs. Voici des exemples de différences qui rendent les entités des deux versions incompatibles :Following are examples of the differences that make the entities in two versions incompatible:
    • Les travaux et tâches créés dans v2 n’apparaissent pas dans v3, car elles ne sont pas associées à une transformation.Jobs and Tasks created in v2 do not show up in v3 as they are not associated with a Transform. Il est recommandé de basculer vers des transformations et travaux v3.The recommendation is to switch to v3 Transforms and Jobs. Il y aura une période de temps relativement courte du basculement durant laquelle il sera nécessaire de surveiller les travaux v2 en cours.There will be a relatively short time period of needing to monitor the inflight v2 Jobs during the switchover.
    • Les canaux et programmes créés avec v2 (qui sont mappés à des événements et sorties en direct dans v3) ne peuvent plus être gérés avec v3.Channels and Programs created with v2 (which are mapped to Live Events and Live Outputs in v3) cannot continue being managed with v3. Il est recommandé de basculer vers des événements et sorties en direct v3 à un point d’arrêt approprié du canal.The recommendation is to switch to v3 Live Events and Live Outputs at a convenient Channel stop.
      Actuellement, vous ne pouvez pas migrer en continu des canaux en cours d’exécution.Presently, you cannot migrate continuously running Channels.

Notes

Cette page sera actualisée à mesure que l’équipe Media Services apportera des améliorations continues aux API v3, et traitera des différences entre les versions.This page will be maintained as the Media Services team makes continued improvements to the v3 APIs and addresses the gaps between the versions.

Poser des questions, envoyer des commentaires, obtenir des mises à jourAsk questions, give feedback, get updates

Découvrez l’article Communauté Azure Media Services pour découvrir les différentes façons dont vous pouvez poser des questions, faire des commentaires et obtenir des mises à jour sur Media Services.Check out the Azure Media Services community article to see different ways you can ask questions, give feedback, and get updates about Media Services.

Étapes suivantesNext steps

Pour découvrir combien il est facile de démarrer le codage et le streaming de fichiers vidéo, consultez Diffuser des fichiers.To see how easy it is to start encoding and streaming video files, check out Stream files.