Create a transcoding job - ApsaraVideo Media Processing - Centre de documentation Alibaba Cloud

Soumettez des tâches de transcodage dans la console ApsaraVideo Media Processing (MPS) ou via une opération API pour convertir les contenus multimédias au format souhaité.

Avant de commencer

Effectuez les préparatifs suivants. Ignorez cette section si ces opérations sont déjà réalisées.

Activer un pipeline. Pour les tâches de transcodage standard, utilisez un pipeline standard.
Téléchargez la vidéo à traiter sur OSS.
- Si vous souhaitez créer une tâche, téléchargez directement la vidéo sur OSS. Pour plus d'informations, consultez la section Télécharger une vidéo.
- Si vous souhaitez créer un workflow et le déclencher automatiquement, ajoutez des buckets multimédias et créez un workflow avant de télécharger la vidéo. Après avoir spécifié les buckets multimédias d'entrée et de sortie et téléchargé un fichier multimédia dans le bucket d'entrée, MPS reçoit un message concernant le téléchargement et déclenche le workflow associé. Une fois le workflow terminé, le fichier multimédia traité est téléchargé dans le bucket de sortie. Pour plus d'informations, consultez la section Ajouter des buckets multimédias.
Configurez les modèles de transcodage.
Utilisez des modèles de filigrane pour simplifier l'ajout de filigranes à vos vidéos. Pour plus d'informations, consultez la section Modèles de filigrane.
(Facultatif) Activez la fonction de notification. Si vous souhaitez que MPS envoie des notifications sur les tâches et les workflows vers des topics ou des files d'attente MNS, configurez une file d'attente ou un topic MNS selon vos besoins. Pour plus d'informations, consultez la section Configurer les notifications.

Soumettre des tâches dans la console

Tâche unique

Connectez-vous à la console ApsaraVideo Media Processing.
Dans la barre de navigation supérieure, sélectionnez une région. Par exemple, sélectionnez China (Hangzhou).
Dans le volet de navigation de gauche, choisissez Job Management.
Sous l'onglet Encode, cliquez sur Create Task.

Configurez les paramètres.

Paramètre	Description
Input File URL	Cliquez sur Select. Dans la liste déroulante Bucket, sélectionnez un bucket. Les dossiers du bucket sélectionné s'affichent sous Path. Sélectionnez un fichier d'entrée. Remarque Si aucun bucket n'est disponible, accédez à la console OSS pour créer un bucket dans la région actuelle. Pour plus d'informations, consultez la section Ajouter des buckets multimédias. Si aucun fichier n'est disponible sous Path après la sélection d'un bucket, téléchargez des fichiers dans ce bucket via la console OSS. Si un message indique qu'OSS n'est pas activé, accédez à la console OSS pour activer le service. En cas d'erreur de rôle ou de message d'autorisation refusée, accédez à la console Resource Access Management (RAM) et accordez les autorisations OSS requises à l'utilisateur RAM actuel. Vous pouvez attacher la stratégie AliyunOSSFullAccess ou créer une stratégie personnalisée selon vos besoins. Pour plus d'informations, consultez la section Créer un utilisateur RAM et accorder des autorisations.
Encoding Pipeline	Sélectionnez un pipeline dans la liste déroulante. Remarque Si aucun pipeline n'est disponible, activez d'abord un pipeline. Pour plus d'informations, consultez la section Créer un pipeline. Le niveau de simultanéité du pipeline n'est pas garanti et dépend des ressources disponibles. La simultanéité par défaut est de 200.
Output File Name	Saisissez un nom pour le fichier de sortie. Ajoutez une extension de fichier pour tous les types de fichiers, à l'exception de M3U8. Par exemple, saisissez `example_video01.mp4`.
Output Path	Cliquez sur Select. Dans la liste déroulante Bucket, sélectionnez un bucket. Les dossiers du bucket s'affichent sous Path. Sélectionnez un dossier comme chemin de sortie. Remarque Si le chemin de sortie est identique au chemin d'entrée mais que les fichiers ont des noms différents, le fichier source n'est pas écrasé. Si les fichiers portent le même nom, votre configuration OSS détermine si le fichier source est écrasé. Pour éviter l'écrasement, consultez la section Empêcher l'écrasement des objets portant le même nom (Java SDK V1). Avec ce paramètre activé, la tâche échoue lors de l'écriture du fichier de sortie s'il porte le même nom que le fichier source. Nous vous recommandons d'utiliser un nom différent pour le fichier de sortie. Pour les autres problèmes courants, consultez la description du paramètre Input File URL.

Cliquez sur Next.

Configurez le Encoding Template.

Paramètre	Description
Template Type	Sélectionnez le type de modèle de transcodage. Pour plus de détails sur les modèles prédéfinis, consultez la section Détails des modèles prédéfinis. Pour créer un modèle personnalisé, consultez la section Modèles de transcodage.
Output Format	Sélectionnez un format de sortie. La valeur par défaut est mp4.
Template	Sélectionnez un modèle. La valeur par défaut est MP4-4K.
(Facultatif) Watermark Template	Activez le switch. Dans la liste déroulante Watermark Template, sélectionnez un modèle de filigrane. Si aucun modèle de filigrane n'est disponible, créez-en un au préalable. Cliquez sur Select à côté de Watermark Image. Dans la liste déroulante Bucket, sélectionnez un bucket. Les dossiers du bucket s'affichent sous Path. Sélectionnez un fichier image. Remarque Les fichiers de filigrane pris en charge incluent les images PNG, les images PNG animées et les animations MOV.
(Facultatif) Clip Output	Activez le switch. Définissez l'heure de début et la durée pour configurer le clip. Dans le champ Start From, sélectionnez l'heure de début au format HH:MM:SS. Remarque L'heure de début doit être antérieure à la durée totale de la vidéo. Sinon, la tâche de transcodage échoue. Dans le champ Clip Length, sélectionnez la durée au format HH:MM:SS. Remarque Si la durée du clip spécifiée dépasse la fin de la vidéo, le clip s'exécute jusqu'à la fin de la vidéo source.
(Facultatif) Rotate Angle	Saisissez un angle de rotation dans le sens horaire. La valeur doit se situer dans la plage [0, 360].

Cliquez sur Submit pour créer et soumettre la tâche de transcodage.

Une fois la tâche soumise, vous pouvez consulter son état d'exécution, les détails de configuration, le chemin d'entrée et le chemin de sortie dans la liste des tâches.

Remarque
Si une tâche de transcodage échoue et que vous ne pouvez pas afficher les détails de l'échec, vérifiez votre connexion réseau et resoumettez la tâche.

Workflow

Connectez-vous à la console ApsaraVideo Media Processing.
Dans la barre de navigation supérieure, sélectionnez une région.
Dans le volet de navigation de gauche, choisissez Workflow > Workflow Orchestration.
Cliquez sur Create Workflow.
Configurez les paramètres du workflow selon vos besoins.
1. Workflow Name : Saisissez un nom pour le workflow.
2. Configuration Plan : Sélectionnez un plan de configuration.
  
  Remarque
  MPS fournit des workflows prédéfinis pour les cas d'utilisation courants. Vous pouvez sélectionner et modifier un workflow prédéfini ou créer un workflow personnalisé.

Modifiez la topologie du workflow.

Cliquez sur l'icône plus (+) à côté du nœud concerné et sélectionnez le nœud Encode dans la liste déroulante.
Cliquez sur l'icône en forme de crayon à côté du nœud Encode pour ouvrir la page Basic Settings.

Configurez les paramètres de transcodage.

Paramètre	Description
Name	Saisissez un nom pour ce nœud.
Encoding Template	Cliquez sur Select. Dans la boîte de dialogue qui s'affiche, configurez le paramètre Encoding Template. Sélectionnez un Template Type. Sélectionnez un Output Format. Sélectionnez un Template. Cliquez sur OK. Remarque Pour plus de détails sur les modèles prédéfinis, consultez la section Détails des modèles prédéfinis. Pour créer un modèle personnalisé, consultez la section Modèles de transcodage.
Output Path	Cliquez sur Select. Dans la liste déroulante Bucket, sélectionnez un bucket. Les dossiers du bucket s'affichent sous Path. Sélectionnez un dossier comme chemin de sortie. Remarque Si le chemin de sortie est identique au chemin d'entrée : Si les fichiers ont des noms différents, le fichier source n'est pas écrasé. Si les fichiers portent le même nom, votre configuration OSS détermine si le fichier source est écrasé. Pour éviter l'écrasement, consultez la section Empêcher l'écrasement des objets portant le même nom (Java SDK V1). Avec ce paramètre activé, la tâche échoue lors de l'écriture du fichier de sortie s'il porte le même nom que le fichier source. Nous vous recommandons d'utiliser un nom différent pour le fichier de sortie. Pour éviter l'écrasement des fichiers de sortie lors des exécutions ultérieures du workflow, utilisez une combinaison des variables intégrées suivantes : `{RunId}` : L'ID d'exécution du workflow multimédia. `{ObjectPrefix}` : Le chemin du fichier source, hors informations sur le bucket. `{FileName}` : Le nom du fichier source, y compris l'extension. L'extension du fichier de sortie est déterminée par le modèle de transcodage sélectionné. `{ExtName}` : L'extension du fichier source.
(Facultatif) Watermark	Activez le switch. Sélectionnez un nom de modèle dans la liste déroulante Watermark Template. Remarque Si aucun modèle de filigrane n'est disponible, créez-en un au préalable. Cliquez sur Select à côté de Watermark Image pour ajouter le chemin de l'image du filigrane. Remarque Les fichiers de filigrane pris en charge incluent les images PNG, les images PNG animées et les animations MOV.
(Facultatif) Encryption	Activez le switch. Pour Encryption Method, sélectionnez Alibaba Cloud Private Encryption ou HLS Standard Encryption. Pour plus d'informations, consultez la section Chiffrement vidéo.
(Facultatif) Clip	Activez le switch. Pour Clip Method, sélectionnez Video Clip ou Video Ending Clip. Dans le champ Start From, sélectionnez l'heure de début. Dans le champ Length, sélectionnez la durée. Remarque L'heure de début doit être antérieure à la durée totale de la vidéo. Sinon, la tâche de transcodage échoue. Si la durée du clip spécifiée dépasse la fin de la vidéo, le clip s'exécute jusqu'à la fin de la vidéo source.
(Facultatif) Add Credits	Activez le switch. À côté de File Path, cliquez sur Select et choisissez le chemin du fichier vidéo des crédits.
(Facultatif) Rotate Angle	Saisissez un angle de rotation dans le sens horaire. La valeur doit se situer dans la plage [0, 360].

Cliquez sur OK pour terminer la configuration du nœud Encode.

Cliquez sur Save pour créer le workflow.

Soumettre des tâches via API

Si la création de tâches ou de workflows dans la console ne répond pas à vos besoins, appelez l'opération SubmitJobs pour soumettre par programme des tâches de transcodage et configurer les paramètres en fonction de votre logique métier.

Appelez l'opération SubmitJobs pour soumettre une tâche de transcodage.

Pour plus d'informations, consultez la section Soumettre une tâche de transcodage. Lors du processus de création, vous devez configurer les informations de transcodage comme suit :
1. PipelineId : Utilisez l'ID d'un pipeline standard.
2. TemplateId : Sélectionnez un modèle de transcodage en fonction de vos besoins. Si les modèles prédéfinis ne répondent pas à vos exigences, créez un modèle personnalisé. Pour plus d'informations, consultez la section Ajouter un modèle de transcodage personnalisé.
3. (Facultatif) Si vous avez besoin d'un chiffrement, configurez le paramètre Encryption dans l'objet Output.
  
  Remarque
  La sortie chiffrée doit être au format M3U8. L'API prend en charge les méthodes de chiffrement Base64 et KMS. Pour plus d'informations, consultez la section Détails des paramètres.
Recevez les notifications de rappel.

Lorsqu'une tâche de transcodage est terminée et que vous avez configuré des notifications d'événements pour le pipeline, un message est envoyé à la file d'attente ou au topic spécifié dans Simple Message Queue (anciennement MNS). Pour plus d'informations, consultez la section Recevoir des notifications.
Interrogez le résultat de la tâche.
1. Appelez l'opération Interroger les tâches de transcodage pour interroger le résultat de la tâche et obtenir l'URL du fichier de sortie.
2. Appelez l'opération Lister les tâches de transcodage pour interroger plusieurs tâches de transcodage en fonction de l'ID du pipeline, de l'état de la tâche et de la plage de dates de création.