Transformations et travaux dans Media Services

  • Article

Logo de Media Services v3

Avertissement

Azure Media Services sera mis hors service le 30 juin 2024. Pour plus d’informations, consultez le Guide de mise hors service AMS.

Conseil

Voulez-vous générer des miniatures, assembler deux vidéos ensemble, créer un sous-clip d’une vidéo ou la faire pivoter (entre autres) ? Vous trouverez un exemple de code Media Services dans la page Exemples.

Cette rubrique fournit des informations détaillées sur les transformations et les travaux et explique la relation entre ces entités.

Flux de travail classique

Une transformation est comme une recette. Elle vous aide à créer la recette une seule fois (Étape 1), puis à soumettre des travaux en utilisant cette recette (Étape 2).

  1. Créer une transformation.
  2. Envoyer des travaux sous cette transformation.
  3. Répertorier les transformations.
  4. Supprimer une transformation si vous ne prévoyez pas de l’utiliser ultérieurement.

Exemple

Supposons que vous souhaitez extraire la première image de toutes vos vidéos sous la forme d’une image miniature. Vous devrez effectuer les étapes suivantes :

  1. Définir la recette, ou la règle de traitement de vos vidéos : « utiliser la première image de la vidéo comme miniature ».
  2. Pour chaque vidéo, vous devez indiquer au service :
    1. où trouver cette vidéo ;
    2. à quel emplacement écrire l’image miniature de sortie.

Notes

Les propriétés de Transform et Job (Transformation et Travail) de type DateHeure sont toujours au format UTC.

Transformations

Utilisez des transformations pour configurer des tâches courantes de codage ou d'analyse des vidéos. Chaque transformation décrit une recette, ou un flux de travail de tâches pour le traitement de vos fichiers vidéo ou audio. Une transformation unique peut appliquer plusieurs règles. Par exemple, une transformation peut spécifier que chaque vidéo est encodée dans un fichier MP4 à une vitesse de transmission donnée, et qu’une image miniature est générée à partir de la première image de la vidéo. Vous devez ajouter une entrée TransformOutput pour chaque règle que vous souhaitez inclure dans votre transformation. Vous utilisez des présélections pour indiquer à la transformation comment les fichiers multimédias d’entrée doivent être traités.

Consultation du schéma

Dans Media Services v3, les présélections sont des entités fortement typées dans l’API elle-même. Vous trouverez la définition « schema » (schéma) pour ces objets dans Open API Specification (ou Swagger). Vous pouvez également consulter les définitions prédéfinies (comme StandardEncoderPreset) dans l’API REST, le Kit de développement logiciel (SDK) .NET (ou d’autres documents de référence sur le Kit de développement logiciel (SDK) Media Services v3).

Création de transformations

Vous pouvez créer des transformations à l’aide de REST ou de l’interface CLI, ou utiliser l’un des Kits de développement logiciel (SDK) publiés. L’API Azure Media Services v3 est pilotée par Azure Resource Manager. Vous pouvez donc utiliser des modèles Resource Manager pour créer et déployer des transformations dans votre compte Media Services. Le Contrôle d'accès en fonction du rôle Azure peut être utilisé pour bloquer l'accès aux transformations.

Mise à jour de transformations

Si vous avez besoin mettre à jour votre transformation, utilisez l’opération de mise à jour. Elle est destinée à modifier la description ou les priorités des TransformOutputs sous-jacents. Vous devez effectuer les mises à jour une fois tous les travaux en cours terminés. Si vous souhaitez réécrire la recette, vous devez créer une nouvelle transformation.

travaux

Un travail est la demande réelle envoyée à Media Services pour appliquer la transformation à un contenu vidéo ou audio d’entrée donné. Lorsque la transformation est créée, vous pouvez envoyer des travaux à l’aide des API Media Services ou de l’un des kits de développement logiciel (SDK) publiés. Le travail spécifie des informations telles que l’emplacement de la vidéo d’entrée et celui de la sortie. Vous pouvez spécifier l'emplacement de votre vidéo d'entrée en utilisant : des URL HTTPS, des URL SAS ou des éléments multimédia.

Entrée de travail à partir de HTTPS

Utilisez une entrée de travail depuis HTTPS si votre contenu est déjà accessible via une URL et que vous n’avez pas besoin de stocker le fichier source dans Azure (par exemple une importation depuis S3). Cette méthode est également applicable si le contenu est dans le Stockage Blob Azure mais que le fichier ne doit pas nécessairement être dans un élément multimédia. Actuellement, cette méthode ne prend en charge qu’un fichier pour l’entrée.

Élément multimédia en tant qu’entrée de travail

Utilisez un actif multimédia en tant qu’entrée de travail si le contenu d’entrée est déjà dans un actif multimédia ou si le contenu est stocké dans un fichier local. Il s’agit également d’une bonne option si vous projetez de publier l’élément multimédia d’entrée pour la diffusion en continu ou le téléchargement (supposons que vous souhaitiez publier le fichier mp4 pour téléchargement, mais que vous souhaitiez également utiliser la reconnaissance vocale à la détection des visages). Cette méthode prend en charge les éléments multimédias multifichiers (par exemple, les ensembles de contenus pour diffusion en continu MBR encodés localement).

Vérification de la progression des travaux

La progression et l’état des travaux peuvent être obtenus en surveillant les événements avec Event Grid. Pour plus d’informations, consultez la section relative à la surveillance des événements à l’aide d’Event Grid.

Mise à jour des travaux

L’opération de mise à jour de l’entité Travail permet de modifier les propriétés description, et priority une fois le travail soumis. Une modification de la propriété priority ne s’applique que si le travail est toujours dans un état de file d’attente. Si le traitement du travail a commencé, ou est terminé, la modification de la priorité n’a aucun effet.

Exemples d’encodage

Consultez la liste complète des exemples d’encodage pour un encodage.

Obtenir de l’aide et du support

Vous pouvez contacter Media Services pour toute question ou suivre nos mises à jour selon l’une des méthodes suivantes :