:SubmitMediaProducingJob

• Facturation : le montage de clips vidéo est facturé en fonction de la durée de la vidéo produite. Pour plus de détails, consultez Montage de clips vidéo. Aucun frais n'est facturé pour les tâches ayant échoué.

• Capacités de montage variées : lorsque vous devez organiser et concevoir des éléments en fonction de vos idées créatives, appelez cette opération. Cette opération prend en charge des configurations de timeline flexibles pour répondre aux exigences complexes de montage de clips vidéo.

• Règles de référence des éléments : les éléments référencés dans la timeline de montage cloud peuvent être des ressources médiatiques de la médiathèque ou des fichiers OSS. Les URL externes ou les URL CDN ne sont pas prises en charge. Lorsque l'élément est un fichier OSS, MediaUrl prend uniquement en charge le format d'URL OSS, tel que https://your-bucket.oss-region-name.aliyuncs.com/your-object.ext.

• Exécution asynchrone des tâches : cette opération est une tâche asynchrone. Après avoir soumis une tâche, un identifiant de tâche est renvoyé (la tâche n'est pas encore terminée et intègre une file d'attente en arrière-plan pour une exécution asynchrone). Le résultat final est envoyé via une notification de rappel. Vous pouvez également interroger de manière proactive l'état de la tâche en appelant GetMediaProducingJob.

• Interrogation de l'état de la tâche :

  1. Appelez GetMediaProducingJob et transmettez le JobId pour interroger l'état et le résultat de la tâche.

  2. Lors de la soumission d'une tâche de production de médias, vous pouvez définir UserData dans les paramètres de la requête pour inclure une URL de rappel. Lorsque la tâche de montage est terminée ou échoue, le système envoie une notification à l'URL de rappel. Vous pouvez traiter les données de rappel pour obtenir l'état de la tâche.

• Enregistrement et analyse des ressources médiatiques : une fois la composition vidéo terminée, la ressource médiatique est automatiquement enregistrée. À ce stade, la ressource médiatique est toujours en cours d'analyse. Une fois l'analyse terminée, vous pouvez obtenir la durée et la résolution de la vidéo produite en fonction du MediaId.

Limites

• La limite de débit de cette opération est de 30 QPS (requêtes par seconde pour la soumission de tâches). Les tâches soumises intègrent une file d'attente en arrière-plan et sont traitées de manière asynchrone.

  Remarque

  Si cette limite est dépassée, vous pouvez rencontrer une erreur « Throttling.User ». Pour plus d'informations, consultez Erreur Throttling.User lors de la soumission d'une tâche de montage.

• Lorsque vous soumettez un grand nombre de tâches (par exemple 1 000 ou 10 000), le système effectue une mise à l'échelle dynamique, mais un temps d'attente dans la file peut s'appliquer.

• Le nombre maximal de pistes pour les pistes vidéo, les pistes d'images et les pistes de sous-titres est de 100 pour chacune.

• Il n'y a pas de limite sur le nombre d'éléments, mais la taille totale des fichiers de tous les éléments ne peut pas dépasser 1 To.

• La région du compartiment OSS d'entrée ou de sortie doit être la même que la région où IMS est utilisé.

• Lorsque la sortie est une vidéo, les limites de résolution suivantes s'appliquent à la vidéo produite :

  • La largeur et la hauteur doivent être d'au moins 128 px.

  • La largeur et la hauteur ne peuvent pas dépasser 4 096 px.

  • Le côté court ne peut pas dépasser 2 160 px.

Exemples de paramètres OutputMediaConfig

Exemple : Sortie vers OSS

{
  "MediaURL":"https://my-test-bucket.oss-ap-southeast-1.aliyuncs.com/test/xxxxxtest001xxxxx.mp4",
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

Lors de la sortie vers OSS, MediaURL est requis. La valeur par défaut du paramètre OutputMediaTarget est « oss-object », ce qui indique une sortie vers OSS. Les autres paramètres sont facultatifs. Bitrate est utilisé pour définir le débit binaire du média de sortie. En général, un débit binaire plus élevé produit une vidéo plus claire. La valeur maximale est de 5 000. Width et Height sont utilisés pour définir la résolution du média de sortie.

Format du chemin d'URL OSS : https://bucketname.oss-region-name.aliyuncs.com/xxx/yyy.ext

bucketname est le nom du compartiment OSS.

oss-region-name.aliyuncs.com est le point de terminaison public du fichier OSS. Par exemple, les points de terminaison pour Singapour, le Japon (Tokyo) et les États-Unis (Virginie) sont :

oss-ap-southeast-1.aliyuncs.com
oss-ap-northeast-1.aliyuncs.com 
oss-us-east-1.aliyuncs.com

Exemple : Sortie vers VOD

{ 
  "StorageLocation": "outin-*xxxxxx7d2a3811eb83da00163exxxxxx.oss-ap-southeast-1.aliyuncs.com",  
  "FileName": "output.mp4",  
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680
}

Lors de la sortie vers VOD, les paramètres StorageLocation et FileName sont requis. Définissez le paramètre OutputMediaTarget sur « vod-media » pour effectuer la sortie vers le compartiment de stockage VOD. Vous pouvez consulter les emplacements de stockage disponibles dans VOD après avoir téléchargé des ressources médiatiques et vérifié l'adresse de stockage de la ressource médiatique.

Paramètres de la structure OutputMediaConfig