Transformations et travaux dans Media ServicesTransforms and Jobs in Media Services

Cette rubrique fournit des informations détaillées sur les transformations et les travaux et explique la relation entre ces entités.This topic gives details about Transforms and Jobs and explains the relationship between these entities.

Vue d'ensembleOverview

Flux de travail de transformations/travauxTransforms/Jobs workflow

Le schéma qui suit présente le flux de travail transformations/travaux :The following diagram shows transforms/jobs workflow:

Flux de travail des transformations et travaux dans Azure Media Services

Flux de travail classiqueTypical workflow

  1. Créer une transformation.Create a Transform.
  2. Envoyer des travaux sous cette transformation.Submit Jobs under that Transform.
  3. Répertorier les transformations.List Transforms.
  4. Supprimer une transformation si vous ne prévoyez pas de l’utiliser ultérieurement.Delete a Transform, if you aren't planning to use it in the future.

ExemplesExample

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 :Suppose you wanted to extract the first frame of all your videos as a thumbnail image–the steps you would take are:

  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 ».Define the recipe, or the rule for processing your videos: "use the first frame of the video as the thumbnail".
  2. Pour chaque vidéo, vous devez indiquer au service :For each video, you would tell the service:
    1. où trouver cette vidéo ;Where to find that video.
    2. à quel emplacement écrire l’image miniature de sortie.Where to write the output thumbnail image.

Une transformation vous permet de créer la recette une seule fois (Étape 1) et d’envoyer des travaux à l’aide de cette recette (Étape 2).A Transform helps you create the recipe once (Step 1), and submit Jobs using that recipe (Step 2).

Notes

Les propriétés de Transform et Job (Transformation et Travail) de type DateHeure sont toujours au format UTC.Properties of Transform and Job of the Datetime type are always in UTC format.

TransformationsTransforms

Utilisez des transformations pour configurer des tâches courantes de codage ou d'analyse des vidéos.Use Transforms to configure common tasks for encoding or analyzing videos. Chaque transformation décrit une recette, ou un flux de travail de tâches pour le traitement de vos fichiers vidéo ou audio.Each Transform describes a recipe or a workflow of tasks for processing your video or audio files. Une transformation unique peut appliquer plusieurs règles.A single Transform can apply more than one rule. 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.For example, a Transform could specify that each video be encoded into an MP4 file at a given bitrate, and that a thumbnail image be generated from the first frame of the video. Vous devez ajouter une entrée TransformOutput pour chaque règle que vous souhaitez inclure dans votre transformation.You would add one TransformOutput entry for each rule that you want to include in your Transform. Vous utilisez des présélections pour indiquer à la transformation comment les fichiers multimédias d’entrée doivent être traités.You use presets to tell the Transform how the input media files should be processed.

Consultation du schémaViewing schema

Dans Media Services v3, les présélections sont des entités fortement typées dans l’API elle-même.In Media Services v3, presets are strongly typed entities in the API itself. Vous trouverez la définition « schema » (schéma) pour ces objets dans Open API Specification (ou Swagger).You can find the "schema" definition for these objects in Open API Specification (or 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).You can also view the preset definitions (like StandardEncoderPreset) in the REST API, .NET SDK, or other Media Services v3 SDK reference documentation.

Création de transformationsCreating Transforms

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.You can create Transforms using REST, CLI, or any of the published SDKs. 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.The Media Services v3 API is driven by Azure Resource Manager, so you can also use Resource Manager templates to create and deploy Transforms in your Media Services account. Le contrôle d’accès en fonction du rôle peut être utilisé pour bloquer l’accès aux transformations.Role-based access control can be used to lock down access to Transforms.

Mise à jour de transformationsUpdating Transforms

Si vous avez besoin mettre à jour votre transformation, utilisez l’opération de mise à jour.If you need to update your Transform, use the Update operation. Elle est destinée à modifier la description ou les priorités des TransformOutputs sous-jacents.It's intended for making changes to the description, or the priorities of the underlying TransformOutputs. Il est recommandé que ces mises à jour soient effectuées lorsque tous les travaux en cours sont terminés.It's recommended that such updates be done when all in-progress jobs have completed. Si vous souhaitez réécrire la recette, vous devez créer une nouvelle transformation.If you intend to rewrite the recipe, you need to create a new Transform.

Schéma de l’objet de transformationTransform object diagram

Le schéma suivant illustre l’objet de transformation et les objets qu’il référence avec les relations de dérivation.The following diagram shows the Transform object and the objects it references, including the derivation relationships. Les flèches grises montrent un type référencé par le travail, et les flèches vertes indiquent les relations de dérivation de classe.The gray arrows show a type that the Job references and the green arrows show class derivation relationships.

Sélectionnez l’image pour l’afficher en plein écran.Select the image to view it full size.

TâchesJobs

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é.A Job is the actual request to Media Services to apply the Transform to a given input video or audio content. 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.Once the Transform has been created, you can submit jobs using Media Services APIs, or any of the published SDKs. Le travail spécifie des informations telles que l’emplacement de la vidéo d’entrée et celui de la sortie.The Job specifies information like the location of the input video and the location for the output. 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.You can specify the location of your input video using: HTTPS URLs, SAS URLs, or Assets.

Entrée de travail à partir de HTTPSJob input from HTTPS

Utilisez une entrée de travail à partir de 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 à partir de S3).Use job input from HTTPS if your content is already accessible via a URL and you don't need to store the source file in Azure (for example, import from 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.This method is also suitable if you have the content in Azure Blob storage but have no need for the file to be in an Asset. Actuellement, cette méthode ne prend en charge qu’un fichier pour l’entrée.Currently, this method only supports a single file for input.

Élément multimédia en tant qu’entrée de travailAsset as Job input

Utilisez un élément multimédia en tant qu’entrée de travail si le contenu d’entrée est déjà dans un élément multimédia ou si le contenu est stocké dans le fichier local.Use Asset as job input if the input content is already in an Asset or the content is stored in local file. 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).It's also a good option if you plan to publish the input asset for streaming or download (say you want to publish the mp4 for download but also want to do speech to text or face detection). 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).This method supports multi-file assets (for example, MBR streaming sets that were encoded locally).

Vérification de la progression des travauxChecking Job progress

La progression et l’état des travaux peuvent être obtenus en surveillant les événements avec Event Grid.The progress and state of jobs can be obtained by monitoring events with Event Grid. Pour plus d’informations, consultez la section relative à la surveillance des événements à l’aide d’Event Grid.For more information, see Monitor events using EventGrid.

Mise à jour des travauxUpdating Jobs

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.The Update operation on the Job entity can be used to modify the description and the priority properties after the job has been submitted. Une modification de la propriété priority ne s’applique que si le travail est toujours dans un état de file d’attente.A change to the priority property is effective only if the job is still in a queued state. Si le traitement du travail a commencé, ou est terminé, la modification de la priorité n’a aucun effet.If the job has begun processing, or has finished, changing priority has no effect.

Schéma de l’objet de travailJob object diagram

Le schéma suivant illustre l’objet de travail et les objets qu’il référence avec les relations de dérivation.The following diagram shows the Job object and the objects it references including the derivation relationships.

Cliquez sur l’image pour l’afficher en plein écran.Click the image to view it full size.

Configurer des unités réservées MultimédiaConfigure Media Reserved Units

Pour les travaux d’analyse audio et vidéo déclenchés par Media Services v3 ou Video Indexer, nous vous recommandons de provisionner votre compte avec des unité réservées Multimédia (MRU) 10 S3.For the Audio Analysis and Video Analysis Jobs that are triggered by Media Services v3 or Video Indexer, it's highly recommended to provision your account with 10 S3 Media Reserved Units (MRUs). Si vous avez besoin de plus de 10 MRU S3, ouvrez un ticket de support à l’aide du Portail Azure.If you need more than 10 S3 MRUs, open a support ticket using the Azure portal.

Pour plus de détails, voir Mise à l’échelle du traitement multimédia avec l’interface CLI.For details, see Scale media processing with CLI.

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.

Voir aussiSee also

Étapes suivantesNext steps