Editing and production parameters - Intelligent Media Services

OutputMediaConfig

Configuration d'un fichier média au format JSON. Spécifiez l'URL du fichier média dans un bucket Object Storage Service (OSS) ou son emplacement de stockage dans ApsaraVideo VOD. Pour stocker le fichier média dans le bucket OSS, définissez le champ MediaURL. Pour le stocker dans ApsaraVideo VOD, définissez les champs StorageLocation et FileName.

Champs

Champ	Type	Obligatoire	Description
MediaURL	String	Obligatoire pour stocker le fichier média dans le bucket OSS.	URL du fichier média dans le bucket OSS. Exemple : http://-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4. Remarque : Le bucket OSS doit se trouver dans la même région que le service à appeler. Impossible de spécifier un endpoint d'accélération OSS ou un nom de domaine Content Delivery Network (CDN). Pour plus d'informations sur les formats de fichiers pris en charge, consultez Formats de fichiers compatibles avec le montage.
StorageLocation	String	Obligatoire pour stocker le fichier média dans ApsaraVideo VOD.	Emplacement de stockage du fichier média dans ApsaraVideo VOD. La valeur ne doit pas inclure le préfixe http://. Exemple : outin-xxxxxx.oss-cn-shanghai.aliyuncs.com.
FileName	String	Obligatoire pour stocker le fichier média dans ApsaraVideo VOD.	Nom du fichier média dans ApsaraVideo VOD. Ce nom inclut l'extension, mais pas le chemin d'accès. Exemple : outputVod.mp4.
Video	String	Non	Configuration de la vidéo et du flux vidéo de sortie. Pour plus d'informations, consultez Video.
Width	Integer	Non	Largeur de la vidéo de sortie. Champ facultatif. Par défaut, la largeur maximale parmi les vidéos est appliquée.
Height	Integer	Non	Hauteur de la vidéo de sortie. Champ facultatif. Par défaut, la hauteur maximale parmi les vidéos est appliquée.
Bitrate	Integer	Non	Débit binaire de la vidéo de sortie. Unité : Kbit/s. Champ facultatif. Par défaut, le débit binaire maximal parmi les vidéos est appliqué.
MaxDuration	Float	Non	Durée maximale de la vidéo de sortie. Unité : secondes. Pour plus d'informations, consultez Configurer le champ MaxDuration.
ProduceTemplateId	String	Non	ID du modèle utilisé pour la production vidéo, identique à celui du modèle de transcodage ApsaraVideo Media Processing (MPS). Ce champ personnalisé permet de transcoder la vidéo produite et de traiter des vidéos personnalisées dans des scénarios spécifiques. Créez un modèle de transcodage dans MPS.
VodTemplateGroupId	String	Non	ID du groupe de modèles de transcodage VOD. Obtenez cet ID depuis la console ApsaraVideo VOD. Si aucun transcodage de la vidéo produite n'est nécessaire, définissez ce champ sur VOD_NO_TRANSCODE. Pour plus d'informations, consultez Modèles de transcodage.
Endpoint	String	Non	Endpoint du fournisseur de services cloud. Obligatoire lors de l'utilisation d'Amazon Simple Storage Service (S3).
Bucket	String	Non	Bucket S3. Obligatoire lors de l'utilisation de S3.
ObjectKey	String	Non	Nom de l'objet. Obligatoire lors de l'utilisation de S3.
AccessKeyId	String	Non	ID AccessKey temporaire obtenu auprès du fournisseur de services cloud. Obligatoire lors de l'utilisation de S3.
AccessKeySecret	String	Non	Secret AccessKey temporaire obtenu auprès du fournisseur de services cloud. Obligatoire lors de l'utilisation de S3.

Video

Champs du paramètre OutputMediaConfig définissant la configuration de la vidéo et du flux vidéo de sortie. Le tableau suivant présente des exemples de configuration.

Champ	Type	Obligatoire	Définition	Description
Fps	Integer	Non	Fréquence d'images du flux vidéo de sortie.	Valeurs valides : 1 à 60. Valeur par défaut : 25.
Orientation	String	Non	Mode d'orientation d'affichage de la vidéo.	Valeurs valides : Horizontal et Vertical. Horizontal : mode paysage. Vertical : mode portrait. Si ce champ est défini sur Horizontal, le système détermine la largeur et la hauteur maximales de la vidéo de sortie en fonction des dimensions de la vidéo en mode paysage ayant la plus grande largeur. Si ce champ est défini sur Vertical, le système détermine la largeur et la hauteur maximales de la vidéo de sortie en fonction des dimensions de la vidéo en mode portrait ayant la plus grande hauteur. Ce champ est ignoré si les champs Width et Height sont spécifiés.
Codec	String	Non	Format d'encodage.	Valeurs valides : H.264 et H.265. Valeur par défaut : H.264.
Profile	String	Non	Profil d'encodage vidéo.	Valeurs valides : baseline, main et high. Valeur par défaut : high. Remarque : ce champ n'est valide que si le champ Codec est défini sur H.264.
Crf	Integer	Non	Facteur de taux constant.	Valeurs valides : 0 à 51. Valeur par défaut : Si Codec est défini sur H.264, la valeur par défaut est 23. Si Codec est défini sur H.265, la valeur par défaut est 26. Remarque : si les champs Crf et Bitrate sont tous deux spécifiés, le champ Bitrate est ignoré.
Preset	String	Non	Algorithme vidéo prédéfini.	Valeurs valides : veryfast, fast, medium, slow et slower. Valeur par défaut : medium. Remarque : ce champ n'est valide que si le champ Codec est défini sur H.264.

Exemples

OSS

Pour stocker le fichier média dans votre bucket OSS, définissez le champ MediaURL. Les autres champs sont facultatifs. Le champ Bitrate définit le débit binaire de la vidéo de sortie ; un débit plus élevé offre une meilleure qualité visuelle. La valeur maximale du champ Bitrate est 5000. Les champs Width et Height définissent la résolution vidéo.

{
 "MediaURL":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4",
 "Bitrate": 2000,  
 "Width": 800,  
 "Height": 680
}

L'URL du bucket OSS suit le format https://${bucket}.${oss-region-name}.aliyuncs.com/${fileKey}.

bucket correspond au nom du bucket OSS et fileKey au nom de l'objet OSS. Le nom de l'objet OSS inclut le chemin d'accès et l'extension de l'objet.

oss-region-name.aliyuncs.com représente l'endpoint public du bucket OSS. Le code suivant liste les endpoints publics des régions Chine (Shanghai), Chine (Hangzhou) et Chine (Beijing) :

oss-cn-shanghai.aliyuncs.com
oss-cn-hangzhou.aliyuncs.com 
oss-cn-beijing.aliyuncs.com

VOD

Pour stocker le fichier média dans ApsaraVideo VOD, définissez les champs StorageLocation et FileName. Consultez les emplacements de stockage ApsaraVideo VOD disponibles dans la console ApsaraVideo VOD.

{ 
  "StorageLocation": "outin-*xxxxxx7d2a3811eb83da00163exxxxxx.oss-cn-shanghai.aliyuncs.com",  
  "FileName": "outputVod.mp4",  
  "Bitrate": 2000,  
  "Width": 800,  
  "Height": 680,
  "VodTemplateGroupId": "VOD_NO_TRANSCODE"
}

Exemple de configuration du champ Video

Exemple de configuration du champ Video du paramètre OutputMediaConfig

{
  "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/outputOss.mp4",
  "Width": 800,
  "Height": 680,
  "Video": {
    "Codec": "H.264",
    "Fps": 50,
    "Profile": "main",
    "Crf": 15
  }
}

ProjectMetadata

Métadonnées du projet de montage au format JSON.

Champs

Champ	Type	Obligatoire	Description
Description	String	Non	Description du projet de montage.
Title	String	Non	Titre du projet de montage.

Exemples

{
   "Description": "Description",
   "Title": "Title"
}

EditingProduceConfig

Paramètre de montage et de production standard au format JSON.

Champs

Champ	Type	Obligatoire	Description
AudioChannelCopy	String	Non	Canal audio à copier. Valeurs valides : left et right. Si ce champ est défini sur left, les canaux audio gauche et droit de la vidéo de sortie sont copiés vers le canal audio gauche de la vidéo d'entrée. Si ce champ est défini sur right, ils sont copiés vers le canal audio droit de la vidéo d'entrée.
AutoRegisterInputVodMedia	Boolean	Non	Indique si les fichiers média ApsaraVideo VOD présents dans votre timeline doivent être automatiquement enregistrés dans la bibliothèque de ressources multimédias Intelligent Media Services (IMS). Valeur par défaut : true.
AutoRegisterOutputImsMedia	Boolean	Non	Indique si la vidéo générée après montage et production doit être automatiquement enregistrée dans la bibliothèque de ressources multimédias IMS. Valeur par défaut : true.
OutputWebmTransparentChannel	Boolean	Non	Indique s'il faut exporter la vidéo avec un canal alpha au format WebM. Valeur par défaut : false. Pour exporter la vidéo avec un canal alpha au format WebM, assurez-vous que le champ MediaURL ou FileName du paramètre OutputMediaConfig se termine par webm et que seul l'effet Scale est présent dans votre timeline. Sinon, la vidéo est exportée par défaut au format MP4 sans canal alpha.
CoverConfig	JSON	Non	Miniature. Une image de la vidéo peut servir de miniature. Celle-ci est enregistrée sous forme d'image et stockée dans votre bucket OSS. La miniature ne permet pas de modifier la première image de la vidéo. Appelez l'opération GetMediaInfo pour obtenir l'URL de la miniature. StartTime : position temporelle de la miniature dans la vidéo. La valeur peut comporter jusqu'à quatre décimales. Unité : secondes.
InputMediaRegisterConfig	JSON	Non	Indique si les fichiers média doivent être automatiquement enregistrés en tant que ressources multimédias lorsque la timeline contient des URL. Valeurs valides : NeedSnapshot NeedSprite SearchLibName
SearchLibName	String	Non	Spécifiez une bibliothèque de recherche personnalisée pour la vidéo finale rendue. Une fois le montage et la composition terminés, définissez ce champ si la ressource vidéo automatiquement enregistrée doit être importée dans une bibliothèque de recherche personnalisée. Pour plus d'informations, consultez Utiliser des bibliothèques de recherche autogérées.
NeedSnapshot	Boolean	Non	Indique s'il faut capturer automatiquement des snapshots pour le fichier média. Valeur par défaut : true.
NeedSprite	Boolean	Non	Indique s'il faut utiliser des snapshots pour générer un sprite pour le fichier média. Valeur par défaut : true.
PipelineId	String	Non	ID du pipeline personnalisé. Définissez ce champ selon vos besoins métier. Lorsque plusieurs lignes métier utilisent le même compte Alibaba Cloud pour soumettre des tâches, ce champ permet de distinguer les tâches de chaque ligne métier. Si nécessaire, ouvrez un ticket.
MaxBitrate	Integer	Non	Débit binaire maximal de la vidéo de sortie. Définissez ce champ selon vos besoins métier. Si le débit binaire de la vidéo d'entrée dépasse la valeur de ce champ, le système applique cette valeur comme débit binaire de la vidéo de sortie. En l'absence de cette spécification, le débit binaire maximal de la vidéo de sortie est fixé à 5 000 par défaut.
KeepOriginMaxBitrate	Boolean	Non	Indique s'il faut conserver le débit binaire maximal du fichier source pour la vidéo de sortie. Valeur par défaut : false. Si ce champ est défini sur true, le système utilise le débit binaire maximal du fichier source pour la vidéo de sortie, plafonné à 50 000.
KeepOriginVideoMaxFps	Boolean	Non	Indique s'il faut conserver la fréquence d'images maximale du fichier source pour la vidéo de sortie. Valeur par défaut : false. Si ce champ est défini sur true, le système utilise la fréquence d'images maximale du fichier source pour la vidéo de sortie.

Exemples

{
	"AutoRegisterInputVodMedia": true,
	"OutputWebmTransparentChannel": true,
	"CoverConfig": {
		"StartTime": 3.3
	},
	"AudioChannelCopy": "left",
	"PipelineId": "xxxd54a97cff4108b555b01166d4bxxx",
	"MaxBitrate": 5000,
	"KeepOriginMaxBitrate": false,
	"KeepOriginVideoMaxFps": false
}

MediaMetadata

Métadonnées du fichier média généré après montage au format JSON.

Champs

Champ	Type	Obligatoire	Description
Title	String	Non	Titre du fichier média. Le titre peut contenir jusqu'à 128 octets. Le titre doit être encodé en UTF-8.
Description	String	Non	Description du fichier média. La description peut contenir jusqu'à 1 024 octets. La valeur doit être encodée en UTF-8.
Tags	String	Non	Tag du fichier média. Vous pouvez spécifier jusqu'à 16 tags. Séparez les tags multiples par des virgules (,). Chaque tag peut contenir jusqu'à 32 octets. La valeur doit être encodée en UTF-8.
CateId	Long	Non	ID de catégorie du fichier média.
CustomMetadata	String	Non	Métadonnées personnalisées fournies sous forme de chaîne JSON. Exemple : {"key1": "value1", "dict1": {"key2": "value2", "key3": "value3"}} La vidéo de sortie contient ces métadonnées.

UserData

Données utilisateur au format JSON. Lors de la soumission d'une tâche de production, ajoutez des données utilisateur au paramètre UserData. Si une URL de rappel est configurée pour la tâche de production, le système envoie une requête de rappel à cette URL une fois la production terminée ; cette requête contient le paramètre UserData. La valeur de ce paramètre peut contenir jusqu'à 1 024 octets.

Pour simplifier la configuration, transmettez les paramètres de rappel via le paramètre UserData. Pour plus d'informations, consultez la bonne pratique Configurer les paramètres de rappel pour les tâches de montage terminées.

Le tableau suivant décrit le champ réservé dans le paramètre UserData.

Champ réservé

Champ

Type

Obligatoire

Description

NotifyAddress

String

Non

URL de rappel. Les rappels HTTP et Alibaba Cloud Message Service (MNS) sont pris en charge.

Exemple de rappel HTTP : http://yourdomain.com/callback.

Exemple de rappel MNS : ice-callback-test. Le nom de la file d'attente MNS doit commencer par ice-callback.