ApsaraVideo Media Processing:Détails des paramètres

Paramètre

Type

Obligatoire

Description

OutputObject

String

Oui

Le chemin OSS du fichier de sortie. Le chemin OSS est un chemin complet incluant le nom du fichier de sortie.

• Pour plus d'informations sur le terme object key, consultez la page Termes.

• Les espaces réservés sont pris en charge. Pour plus d'informations, consultez la section Règles de remplacement des espaces réservés de cette rubrique.

• Règles de spécification de l'extension de fichier :

  • Workflow : Il n'est pas nécessaire de spécifier l'extension de fichier. MPS ajoute automatiquement l'extension de fichier à la valeur du paramètre OutputObject en fonction du format de conteneur du modèle de transcodage.

  • Tâche de transcodage : Vous devez spécifier l'extension de fichier, et celle-ci doit correspondre au format de conteneur du modèle de transcodage. Si le format de conteneur est M3U8, MPS ajoute automatiquement l'extension de fichier .m3u8 à la liste de lecture. Un numéro de série à cinq chiffres est automatiquement ajouté en suffixe au nom de la liste de lecture pour générer le nom d'un fichier de segment multimédia. Le numéro de série à cinq chiffres commence à 00001 et est relié au nom de la liste de lecture par un trait d'union (-). L'extension de fichier d'un fichier de segment multimédia est .ts. Par exemple, si le nom de fichier de la liste de lecture est filename.m3u8, le nom du premier fichier de segment multimédia est filename-00001.ts.

• Le chemin d'un objet OSS doit être encodé en URL au format UTF-8 avant d'être utilisé dans MPS. Pour plus d'informations, consultez la page Encodage URL.

• Par exemple, le chemin du fichier d'entrée est a/b/example.flv et vous souhaitez définir le chemin du fichier de sortie sur a/b/c/example+test.mp4. Dans ce cas, vous pouvez utiliser des espaces réservés pour spécifier le chemin du fichier de sortie au format {ObjectPrefix}/c/{FileName}+test.mp4. Après encodage URL, le chemin s'affiche sous la forme %7BObjectPrefix%7D/c/%7BFileName%7D%2Btest.mp4.

TemplateId

String

Oui

L'ID du modèle de transcodage.

• Vous pouvez utiliser des modèles de transcodage personnalisés et des modèles prédéfinis par le système. Pour plus d'informations, consultez les pages Modèles de transcodage personnalisés et Détails des modèles prédéfinis.

• Exemple : S00000002-200040.

Container

Object

Non

Le format de conteneur. Pour plus d'informations, consultez la section Container de cette rubrique.

• Si vous spécifiez ce paramètre, le paramètre correspondant dans le modèle de transcodage spécifié est écrasé.

Video

Object

Non

Le paramètre lié au transcodage vidéo. Pour plus d'informations, consultez la section Video de cette rubrique.

• Si vous spécifiez ce paramètre, le paramètre correspondant dans le modèle de transcodage spécifié est écrasé.

Audio

Object

Non

Le paramètre lié au transcodage audio. Pour plus d'informations, consultez la section Audio de cette rubrique.

• Si vous spécifiez ce paramètre, le paramètre correspondant dans le modèle de transcodage spécifié est écrasé.

TransConfig

Object

Non

Le paramètre lié au processus de transcodage. Pour plus d'informations, consultez la section TransConfig de cette rubrique.

• Si vous spécifiez ce paramètre, le paramètre correspondant dans le modèle de transcodage spécifié est écrasé.

• Exemple : {"TransMode":"onepass","AdjDarMethod":"none","IsCheckVideoBitrateFail":"true","IsCheckAudioBitrateFail":"true"}.

VideoStreamMap

String

Non

L'identifiant du flux vidéo à conserver dans le fichier d'entrée. Valeurs valides :

• Non spécifié : Un flux vidéo par défaut est sélectionné.

• 0:v:{Numéro de série} : Un flux vidéo spécifique est sélectionné. Le numéro de série spécifie l'indice du flux vidéo. Le numéro de série commence à 0. Par exemple, 0:v:1 indique que le deuxième flux vidéo est sélectionné pour le transcodage.

• 0:v: Tous les flux vidéo sont sélectionnés.

AudioStreamMap

String

Non

L'identifiant du flux audio à conserver dans le fichier d'entrée. Valeurs valides :

• Non spécifié : Un flux audio par défaut est sélectionné. En général, un flux audio chinois, multicanaux et de haute qualité est privilégié.

• 0:a:{Numéro de série} : Un flux audio spécifique est sélectionné. Le numéro de série spécifie l'indice du flux audio. Le numéro de série commence à 0. Par exemple, 0:a:1 indique que le deuxième flux audio est sélectionné pour le transcodage.

• 0:a: Tous les flux audio sont sélectionnés. Cette valeur s'applique à un scénario de doublage multilingue.

Rotate

String

Non

L'angle de rotation de la vidéo dans le sens horaire.

• Valeurs valides : 0, 90, 180 et 270.

• Valeur par défaut : 0, ce qui indique que la vidéo n'est pas tournée.

WaterMarks

Object[]

Non

Les filigranes. Les filigranes sont des images ou du texte ajoutés aux images vidéo. Si vous spécifiez ce paramètre, le paramètre correspondant dans le modèle de filigrane spécifié est écrasé. Pour plus d'informations, consultez la section WaterMarks de cette rubrique.

• Vous pouvez ajouter jusqu'à quatre filigranes à une tâche de transcodage.

• Le code suivant montre un exemple de filigrane image unique : ["WaterMarkTemplateId":"88c6ca184c0e47098a5b665e2a12****"},{"InputFile":{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"},{"Timeline":{"Start":"0","Duration":"ToEND"}}].

• Exemple de filigrane texte unique : ["Type":"Text","TextWaterMark":{"Content":"5rWL6K+V5paH5a2X5rC05Y2w","FontName":"SimSun","FontSize":"16","Top":2,"Left":10}].

DeWatermark

Object

Non

Vous pouvez effectuer un traitement de floutage. Pour plus d'informations, consultez la section Détails du traitement de floutage.

• Exemple : {"0": [{"l":10,"t":10,"w":10,"h":10},{"l":100,"t":0.1,"w":10,"h":10}],"128000": [],"250000": [{"l":0.2,"t":0.1,"w":0.01,"h":0.05}]}.

SubtitleConfig

Object

Non

Les configurations du sous-titrage incrusté. Ce paramètre vous permet d'ajouter des fichiers de sous-titres externes à la vidéo. Pour plus d'informations, consultez la section SubtitleConfig de cette rubrique.

• Vous pouvez ajouter jusqu'à quatre fichiers de sous-titres à une tâche de transcodage.

• Exemple : {"ExtSubtitleList":[{"Input":{"Bucket":"example-bucket-****","Location":"oss-cn-hangzhou","Object":"example.srt"},"CharEnc":"UTF-8"}]}.

Clip

Object

Non

Le clip. Pour plus d'informations, consultez la section Clip de cette rubrique.

• Exemple : {"TimeSpan":{"Seek":"00:01:59.999","End":"18000.30"},"ConfigToClipFirstPart":false}, ce qui indique que le clip commence à 1 minute, 59 secondes et 999 millisecondes et se termine au point situé 5 minutes et 30 millisecondes avant la fin de la vidéo. Le clip est extrait de la vidéo formée par la fusion de plusieurs fichiers d'entrée.

MergeList

Object[]

Non

La liste de fusion. Vous pouvez fusionner plusieurs fichiers d'entrée et clips dans l'ordre pour générer une nouvelle vidéo. Pour plus d'informations, consultez la section MergeList de cette rubrique.

• Vous ne pouvez spécifier qu'un seul des paramètres MergeList et MergeConfigUrl. Le paramètre MergeConfigUrl a une priorité plus élevée que le paramètre MergeList.

• Vous pouvez ajouter jusqu'à quatre paramètres MergeURL à une tâche de transcodage. Pour ajouter davantage de paramètres MergeURL à une tâche de transcodage, vous devez spécifier le paramètre MergeConfigUrl.

• Exemple de spécification d'un seul paramètre MergeURL : [{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4"}].

• Exemple de spécification de deux paramètres MergeURL : [{"MergeURL":"http://exampleBucket**m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4","Start":"1","Duration":"20"},{"MergeURL":"http://exampleBucket**.oss-cn-hangzhou.aliyuncs.com/tail_comm_02.mp4","Start":"5.4","Duration":"10.2"}].

MergeConfigUrl

String

Non

Le chemin OSS du fichier de configuration pour la fusion des clips.

• Vous ne pouvez spécifier qu'un seul des paramètres MergeList et MergeConfigUrl. Le paramètre MergeConfigUrl a une priorité plus élevée que le paramètre MergeList.

• Le fichier doit être stocké dans un bucket OSS. Exemple : http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/mergeConfigfile.

• Le fichier contient plusieurs paramètres MergeURL. Spécifiez les paramètres MergeURL dans l'ordre dans lequel vous souhaitez fusionner les clips correspondants. Vous pouvez spécifier jusqu'à 50 paramètres MergeURL. Pour plus d'informations sur le format, consultez la section MergeList de cette rubrique. Exemple de contenu du fichier de configuration : {"MergeList":[{"MergeURL":"http://exampleBucket**m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4","Start":"1","Duration":"20"},{"MergeURL":"http://exampleBucket**.oss-cn-hangzhou.aliyuncs.com/tail_comm_02.mp4","Start":"5.4","Duration":"10.2"}]}.

OpeningList

Object[]

Non

Les parties d'ouverture. L'ouverture est un effet de fusion spécial qui vous permet d'intégrer des parties d'ouverture au début de la vidéo d'entrée. Les parties d'ouverture sont affichées en mode Picture-in-Picture (PiP). Pour plus d'informations, consultez la section OpeningList de cette rubrique.

• Vous pouvez ajouter jusqu'à deux parties d'ouverture à une tâche de transcodage. Spécifiez les parties d'ouverture dans l'ordre dans lequel vous souhaitez les intégrer dans la vidéo de sortie.

• Exemple : [{"OpenUrl":"http://exampleBucket**.oss-cn-hangzhou.aliyuncs.com/opening_01.flv","Start":"1","Width":"1920","Height":"1080"},{"OpenUrl":"http://exampleBucket**.oss-cn-hangzhou.aliyuncs.com/opening_02.flv","Start":"1","Width":"-1","Height":"full"}].

TailSlateList

Object[]

Non

Les parties de fin. La fin est un effet de fusion spécial qui vous permet d'ajouter des parties de fin à la fin de la vidéo d'entrée. Les parties de fin sont affichées en mode fondu entrant et sortant. Pour plus d'informations, consultez la section TailSlateList de cette rubrique.

• Vous pouvez ajouter jusqu'à deux parties de fin à une tâche de transcodage. Spécifiez les parties de fin dans l'ordre dans lequel vous souhaitez les intégrer dans la vidéo de sortie.

• Exemple : [{"TailUrl":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_01.flv","Start":"1","BlendDuration":"2","Width":"1920","Height":"1080","IsMergeAudio":false,"BgColor":"White"}].

Amix

Object[]

Non

La configuration du mixage audio. Ce paramètre convient aux scénarios où vous souhaitez fusionner plusieurs pistes audio dans une vidéo ou ajouter une musique de fond. Pour plus d'informations, consultez la section Amix de cette rubrique.

• Vous pouvez ajouter jusqu'à quatre fichiers audio mixés à une tâche de transcodage.

• Exemple de mixage de deux flux audio d'un fichier d'entrée : [{"AmixURL":"input","MixDurMode":"longest","Start":"1","Duration":"2"}].

• Exemple d'ajout d'un fichier externe et de son mixage avec le fichier d'entrée : [{"AmixURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail.flv","Map":"0:a:1","MixDurMode":"longest","Start":"1","Duration":"2"}].

MuxConfig

Object

Non

Les configurations d'emballage. Pour plus d'informations, consultez la section MuxConfig de cette rubrique.

• Si vous spécifiez ce paramètre, le paramètre correspondant dans le modèle de transcodage spécifié est écrasé.

• Exemple : {"Segment":{"Duration":"10","ForceSegTime":"1,2,4,6,10,14,18"}}, ce qui indique que la vidéo est forcée d'être segmentée aux 1re, 2e, 4e, 6e, 10e, 14e, 18e, 20e, 30e, 40e, 50e... secondes.

M3U8NonStandardSupport

Object

Non

La prise en charge non standard du format M3U8. Pour plus d'informations, consultez la section M3U8NonStandardSupport de cette rubrique.

• Exemple : {"TS":{"Md5Support":true,"SizeSupport":true}}, ce qui indique que la valeur MD5 et la taille de chaque fichier TS sont incluses dans la vidéo M3U8 de sortie.

Encryption

String

Non

La configuration de chiffrement. Ce paramètre prend effet uniquement si le paramètre Container est défini sur m3u8. Pour plus d'informations, consultez la section Détails des paramètres de chiffrement.

• Exemple : {"Type":"hls-aes-128","Key":"ZW5jcnlwdGlvbmtleTEyMw","KeyType":"Base64","KeyUri":"aHR0cDovL2FsaXl1bi5jb20vZG9jdW1lbnQvaGxzMTI4LmtleQ=="}.

UserData

String

Non

Les données personnalisées, dont la taille peut atteindre 1 024 octets.

Priority

String

Non

La priorité de la tâche de transcodage dans la file d'attente MPS.

• Valeurs valides : [1,10]. Une valeur de 1 spécifie la priorité la plus basse, tandis qu'une valeur de 10 spécifie la priorité la plus élevée.

• Valeur par défaut : 6.

• Meilleure pratique : Les files d'attente MPS ont des limites de simultanéité. Si vous soumettez de nombreuses tâches, celles-ci peuvent être mises en file d'attente. Nous vous recommandons de configurer une priorité plus élevée pour la tâche qui nécessite de hautes performances temporelles ou qui traite du contenu important.

Metadata

Map

Non

Les metadata pour le format de conteneur de la vidéo de sortie, spécifiées sous forme de paires clé-valeur JSON. Exemple : {"key1":"value1","key2":"value2"}.

• Longueur maximale de key : 64.

• Longueur maximale de value : 512.

• Vous pouvez ajouter jusqu'à 4 paires clé-valeur metadata.

Paramètre

Type

Obligatoire

Description

Format

String

Non

Le format de conteneur.

• Pour plus d'informations sur les formats pris en charge et les codecs compatibles, consultez la page Formats pris en charge.

  • Formats vidéo pris en charge : 3GP, AVI, FLV, F4V, fMP4, MKV, MOV, MP4, TS, MXF, WebM, M3U8, HLS-fMP4, MPD, CMAF-HLS et CMAF-DASH.

  • Formats audio pris en charge : AAC, M4A, MP2, MP3, MP4, Ogg, FLAC, M3U8, HLS-fMP4, MPD, CMAF-HLS et CMAF-DASH.

  • Images animées : GIF et WebP.

• Format par défaut : MP4.

Paramètre

Type

Obligatoire

Description

Remove

String

Non

Indique si le flux vidéo doit être supprimé. Valeurs possibles :

• true : supprime le flux vidéo. Si vous définissez ce paramètre sur true, tous les paramètres liés à la vidéo deviennent invalides.

• false : l'élément est conservé.

• Valeur par défaut : false.

Codec

String

Non

Format d'encodage vidéo.

• Valeurs possibles : H.264, H.265, AV1, GIF et WEBP. Pour plus d'informations sur les formats pris en charge et les formats de conteneur compatibles, consultez la section Formats pris en charge.

• Valeur par défaut : H.264.

Width

String

Non

Largeur ou côté long de la vidéo de sortie. Si le paramètre LongShortMode est défini sur false ou laissé vide, ce paramètre spécifie la largeur de la vidéo de sortie. Si le paramètre LongShortMode est défini sur true, ce paramètre spécifie le côté long de la vidéo de sortie.

• Unité : pixel.

• Valeurs possibles : [128,4096]. La valeur doit être un nombre pair.

• Valeur par défaut :

  • Si ni le paramètre Width ni le paramètre Height n'est spécifié, la valeur par défaut correspond à la largeur ou au côté long de la vidéo d'entrée.

  • Si seul le paramètre Height est spécifié, la valeur par défaut est calculée en fonction du rapport d'aspect de la vidéo d'entrée.

Height

String

Non

Hauteur ou côté court de la vidéo de sortie. Si le paramètre LongShortMode est défini sur false ou laissé vide, ce paramètre spécifie la hauteur de la vidéo de sortie. Si le paramètre LongShortMode est défini sur true, ce paramètre spécifie le côté court de la vidéo de sortie.

• Unité : pixel.

• Valeurs possibles : [128,4096]. La valeur doit être un nombre pair.

• Valeur par défaut :

  • Si ni Width ni Height n'est défini, la dimension la plus courte de la vidéo d'entrée est utilisée.

  • Si seul le paramètre Width est spécifié, la valeur par défaut est calculée en fonction du rapport d'aspect de la vidéo d'entrée.

LongShortMode

String

Non

Indique si la rotation automatique doit être activée (adaptation aux côtés longs et courts). Ce paramètre prend effet uniquement lorsque Width ou Height est spécifié.

• true : la fonctionnalité est activée.

• false : désactivé.

• Valeur par défaut : false.

• Meilleure pratique : si vos vidéos d'entrée contiennent à la fois des vidéos au format paysage et portrait, activez la fonction de rotation automatique et configurez une mise à l'échelle proportionnelle basée sur les paramètres de résolution pour éviter l'étirement et la distorsion de la vidéo. Pour un exemple, consultez la section Configurer la rotation automatique.

Fps

String

Non

Fréquence d'images du flux vidéo.

• Unité : images par seconde.

• Valeurs possibles : (0,60].

• Valeur par défaut : fréquence d'images du fichier d'entrée. Si la fréquence d'images du fichier d'entrée dépasse 60, la valeur 60 est utilisée.

• Valeurs courantes : 24, 25 et 30.

MaxFps

String

Non

Fréquence d'images maximale.

Gop

String

Non

Définissez l'intervalle entre les images I adjacentes en temps ou en nombre d'images.

• Format de l'intervalle de temps maximal entre deux images I consécutives : {Time}s. Valeurs possibles : [1,100000].

• Format de l'intervalle d'images maximal entre deux images I consécutives : {Nombre d'images}. Valeurs possibles : [1,100000].

• Valeur par défaut : 10s, ce qui signifie que l'intervalle de temps entre deux images I consécutives est de 10 secondes.

• Meilleure pratique : nous vous recommandons de définir ce paramètre sur un intervalle de temps compris entre deux et sept secondes dans un scénario de média en continu afin de réduire le temps nécessaire au démarrage de la lecture et le temps de réponse lors de la recherche.

Bitrate

String

Non

Débit binaire moyen de la vidéo de sortie. Si vous utilisez le mode de contrôle du débit binaire CRB, ABR ou VBR, vous devez spécifier le paramètre Bitrate et définir le paramètre TransMode sur une valeur valide. Pour plus d'informations, consultez la section Mode de contrôle du débit binaire de cette rubrique.

• Unité : Kbit/s.

• Valeurs possibles : -1 et [10,50000]. Une valeur de -1 indique que le débit binaire d'origine de la vidéo d'entrée est utilisé.

• Meilleure pratique :

  • CBR : définissez le paramètre TransMode sur CBR et les paramètres Bitrate, Maxrate et Bufsize sur la même valeur.

  • ABR : définissez le paramètre TransMode sur onepass et spécifiez le paramètre Bitrate. Vous pouvez également spécifier les paramètres Maxrate et Bufsize pour contrôler la plage de débit binaire.

  • VBR : définissez le paramètre TransMode sur twopass et spécifiez le paramètre Maxrate ou BitrateBnd ainsi que le paramètre Bufsize.

BitrateBnd

String

Non

Plage de débit binaire moyen de la vidéo de sortie.

• Ce paramètre prend effet uniquement si le paramètre Codec est défini sur H.264.

• Exemple : {"Max":"5000","Min":"1000"}.

Maxrate

String

Non

Débit binaire de pointe de la vidéo de sortie. Pour plus d'informations, consultez la section Mode de contrôle du débit binaire de cette rubrique.

• Unité : Kbit/s.

• Valeurs possibles : [10,50000].

Bufsize

String

Non

Taille du tampon pour le contrôle du débit binaire. Vous pouvez spécifier ce paramètre pour contrôler les fluctuations du débit binaire. Pour plus d'informations, consultez la section Mode de contrôle du débit binaire de cette rubrique.

• Unité : Kbit.

• Valeurs possibles : [1000,128000].

• Valeur par défaut : 6000.

Crf

String

Non

Facteur de contrôle de la qualité. Pour utiliser le mode CRF, vous devez spécifier le paramètre Crf et définir le paramètre TransMode sur fixCRF. Pour plus d'informations, consultez la section Mode de contrôle du débit binaire de cette rubrique.

• Valeurs possibles : [20,51].

• Si le paramètre Codec est défini sur H.264, la valeur par défaut est 23. Si le paramètre Codec est défini sur H.265, la valeur par défaut est 26. Si le paramètre Codec est défini sur AV1, la valeur par défaut est 32.

• Meilleure pratique :

  • Une valeur de 0 signifie que la vidéo est sans perte. Une valeur de 51 signifie que la qualité d'image est la pire. Nous vous recommandons de définir la valeur sur un nombre compris entre 23 et 29. Vous pouvez ajuster la valeur en fonction de la complexité de l'image vidéo. Si vous augmentez ou diminuez la valeur de six, le débit binaire est réduit de moitié ou doublé. Pour une même définition, vous pouvez définir une valeur plus élevée pour un dessin animé que pour une vidéo filmée.

  • Le mode CRF privilégie la qualité vidéo et le débit binaire des vidéos de sortie est imprévisible. Vous pouvez spécifier les paramètres Maxrate et Bufsize pour contrôler la plage de débit binaire.

Qscale

String

Non

Valeur du facteur de contrôle de la qualité vidéo. Ce paramètre prend effet si vous utilisez le mode VBR.

• Ce paramètre prend effet uniquement si le paramètre Codec est défini sur H.264.

• Valeurs possibles : [0,51].

Profile

String

Non

Spécifie le profil d'encodage. Pour plus d'informations, consultez la section Termes.

• Ce paramètre prend effet uniquement si Codec est défini sur H.264.

• Valeurs possibles : baseline, main et high.

• Valeur par défaut : high.

• Meilleure pratique : si vous souhaitez générer des vidéos de sortie avec plusieurs définitions à partir d'une même vidéo, nous vous recommandons de définir ce paramètre sur baseline pour la définition la plus basse. Cela garantit que la vidéo de sortie peut être lue sur toute la gamme d'appareils. Si vous souhaitez générer des vidéos de sortie avec d'autres définitions, définissez ce paramètre sur main ou high.

Preset

String

Non

Mode prédéfini de l'encodeur H.264.

• Ce paramètre prend effet uniquement si le paramètre Codec est défini sur H.264.

• Valeurs possibles : veryfast, fast, medium, slow et slower.

• Valeur par défaut : medium.

ScanMode

String

Non

Mode de balayage. Valeurs possibles :

• Si vous laissez ce paramètre vide, le mode de balayage du fichier d'entrée est utilisé.

• auto : effectue automatiquement le désentrelacement.

• progressive : balayage séquentiel, ligne par ligne.

• interlaced : le balayage est entrelacé.

• Valeur par défaut : None.

Meilleure pratique : le mode de balayage entrelacé économise davantage de trafic de données que le mode de balayage progressif, mais offre une qualité d'image médiocre. Par conséquent, le mode de balayage progressif est couramment utilisé dans la production vidéo grand public.

• Si vous définissez le paramètre ScanMode sur progressive ou interlaced mais que ce mode de balayage ne correspond pas à celui du fichier d'entrée, le transcodage du fichier échoue.

• Nous vous recommandons de définir Original Video Mode ou Automatic Deinterlacing pour améliorer la compatibilité.

PixFmt

String

Non

Format de couleur de la vidéo.

• Pour utiliser le format de couleur d'origine, définissez PixFmt sur "".

• Les valeurs possibles incluent yuv420p, yuvj420p, yuv422p, yuvj422p, yuv444p, yuvj444p, yuv444p, yuv444p161e, pc, bt470bg et smpte170m. Si le paramètre Codec est défini sur GIF, bgr8 est pris en charge.

Crop

String

Non

Méthode utilisée pour recadrer les vidéos. Les bordures peuvent être détectées et supprimées automatiquement. Vous pouvez également recadrer la vidéo manuellement.

• Spécifiez ce paramètre si la résolution de la vidéo d'entrée est supérieure à celle de la vidéo de sortie. Ne spécifiez pas le paramètre AdjDarMethod si ce paramètre est spécifié.

• Suppression automatique des bordures de barres noires.

• Pour utiliser une méthode de recadrage personnalisée, définissez le paramètre au format {width}:{height}:{left}:{top}.

  • width : largeur de la vidéo de sortie après recadrage.

  • height : hauteur de la vidéo de sortie après recadrage.

  • left : marge gauche entre l'image de sortie et l'image d'origine.

  • top : marge supérieure entre l'image de sortie et l'image d'origine.

• Exemple de recadrage personnalisé : 1920:800:0:140.

Pad

String

Non

La vidéo est complétée par des barres noires.

• Spécifiez ce paramètre si la résolution de la vidéo d'entrée est inférieure à celle de la vidéo de sortie. Ne spécifiez pas les paramètres IsCheckReso, IsCheckResoFail ou AdjDarMethod si ce paramètre est spécifié.

• Format : {width}:{height}:{left}:{top}.

  • width : largeur de la vidéo de sortie après ajout des bordures noires.

  • height : hauteur de la vidéo de sortie après ajout des bordures noires.

  • left : marge gauche de l'image source par rapport à l'image de sortie.

  • top : marge entre le haut de l'image de sortie et le haut de l'image d'origine.

• Exemple : 1920:1080:0:140.

Paramètre

Type

Obligatoire

Description

Remove

String

Non

Indique si le flux audio doit être supprimé.

• true : supprime le flux audio. Si vous définissez ce paramètre sur true, tous les paramètres liés à l'audio deviennent invalides.

• false : la ressource est conservée.

• Valeur par défaut : false.

Codec

String

Non

Format de codec audio.

• Valeurs possibles : AAC, AC3, EAC3, MP2, MP3, FLAC, OPUS, VORBIS, WMA-V1, WMA-V2 et pcm_s16le. Pour plus d'informations sur les formats pris en charge et les formats de conteneur compatibles, consultez la section Formats pris en charge.

• Valeur par défaut : AAC.

Profile

String

Non

Profil d'encodage audio.

• Ce paramètre prend effet uniquement si le paramètre Codec est défini sur AAC.

• Valeurs possibles : aac_low, aac_he, aac_he_v2, aac_ld et aac_eld. Pour plus d'informations sur le terme profil d'encodage, consultez la section Termes.

• Valeur par défaut : aac_low.

Bitrate

String

Non

Débit binaire audio du fichier de sortie.

• Unité : Kbit/s.

• Valeurs possibles : [8,1000].

• Valeur par défaut : 128.

• Valeurs courantes : 64, 128 et 256.

Samplerate

String

Non

Taux d'échantillonnage.

• Unité : Hz.

• Valeurs possibles : 22050, 32000, 44100, 48000 et 96000.

  Remarque

  Les taux d'échantillonnage pris en charge varient en fonction du format d'encodage et du format de conteneur. Pour plus d'informations, consultez la section Taux d'échantillonnage audio. Par exemple, si Codec est défini sur MP3, vous ne pouvez pas définir ce paramètre sur 96000. Si Codec est défini sur FLV, vous ne pouvez définir ce paramètre que sur 22050 ou 44100.

• Valeur par défaut : 44100.

Channels

String

Non

Nombre de canaux audio.

• Valeurs possibles : 0, 1, 2, 4, 5, 6 et 8.

  • Si le paramètre Codec est défini sur MP3 ou OPUS, vous pouvez définir ce paramètre sur 0, 1 ou 2.

  • Si le paramètre Codec est défini sur AAC ou FLAC, vous pouvez définir ce paramètre sur 0, 1, 2, 4, 5, 6 ou 8.

  • Si le paramètre Codec est défini sur VORBIS, vous pouvez définir ce paramètre sur 2.

  • Si le paramètre Format est défini sur MPD, vous ne pouvez pas définir ce paramètre sur 8.

• Valeur par défaut : 2.

• Si vous souhaitez conserver le nombre original de canaux audio, définissez ce paramètre sur 0.

Volume

String

Non

Configuration du volume. Pour plus d'informations, consultez la section Volume de cette rubrique.

• Ce paramètre est pris en charge uniquement si un seul flux audio de sortie est configuré. Ce paramètre n'est pas pris en charge si plusieurs flux audio de sortie sont configurés.

Parameter

Type

Required

Description

Type

String

No

Le type de filigrane. Valeurs valides :

• Text : un filigrane textuel. Si vous définissez ce paramètre sur Text, vous devez spécifier le paramètre TextWaterMark.

• Image : un filigrane image. Si vous définissez ce paramètre sur Image, vous devez spécifier les paramètres liés au filigrane image.

• Valeur par défaut : Image.

TextWaterMark

Object

No

La configuration du filigrane textuel. Pour plus d'informations, consultez la section TextWaterMark de cette rubrique.

• Si le paramètre Type est défini sur Text, ce paramètre est obligatoire.

• Exemple : {"Content":"5rWL6K+V5paH5a2X5rC05Y2w","FontName":"SimSun","FontSize":"16","Top":2,"Left":10}.

InputFile

Object

No

Le fichier à utiliser comme filigrane image. Vous pouvez utiliser les paramètres Bucket, Location et Object pour spécifier l'emplacement du fichier.

• Les types de fichiers suivants sont pris en charge : images statiques PNG au format .png, images animées PNG au format .apng, fichiers MOV au format .mov et fichiers GIF au format .gif.

• Le fichier doit être stocké dans un compartiment OSS. Pour plus d'informations, consultez la section Input de cette rubrique.

• Dans l'API ApsaraVideo Media Processing, l'Object nécessite un URL Encoding (basé sur UTF-8) avant utilisation.

• Exemple : {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"}.

WaterMarkTemplateId

String

No

L'ID du modèle de filigrane image. Si vous ne spécifiez pas ce paramètre, les configurations par défaut suivantes sont utilisées pour les paramètres liés au filigrane image :

• La position du filigrane image est TopRight.

• Dx et Dy : 0.

• Width : 0,12 fois la largeur de la vidéo de sortie.

• Height : mise à l'échelle proportionnelle basée sur la largeur du filigrane image.

• Durée d'affichage du filigrane image : durée entière.

ReferPos

String

No

L'emplacement du filigrane image.

• Valeurs valides : TopRight, TopLeft, BottomRight et BottomLeft.

Dx

String

No

Le décalage horizontal du filigrane image par rapport à la vidéo de sortie. Si vous spécifiez ce paramètre, le paramètre correspondant dans le modèle de filigrane spécifié est écrasé. Les types de valeurs suivants sont pris en charge :

• Entier : la valeur en pixels du décalage horizontal.

  • Unité : pixel.

  • Valeurs valides : [8,4096].

• Décimal : le ratio du décalage horizontal par rapport à la largeur de la vidéo de sortie.

  • Valeurs valides : (0,1).

  • Quatre décimales sont prises en charge, par exemple 0,9999. Les décimales excédentaires sont ignorées.

Dy

String

No

Le décalage vertical du filigrane image par rapport à la vidéo de sortie. Les types de valeurs suivants sont pris en charge :

• Entier : la valeur en pixels du décalage vertical.

  • Unité : pixel.

  • Valeurs valides : [8,4096].

• Décimal : le ratio du décalage vertical par rapport à la hauteur de la vidéo de sortie.

  • Valeurs valides : (0,1).

  • Quatre décimales sont prises en charge, par exemple 0,9999. Les décimales excédentaires sont ignorées.

Width

String

No

Vous pouvez définir la largeur du filigrane image de deux manières :

• Entier : la valeur en pixels de la largeur du filigrane.

  • Plage : [8,4096].

  • Unité : pixel.

• Une valeur décimale qui représente la largeur de la vidéo de sortie en pourcentage.

  • Plage : (0,1).

  • Prend en charge quatre décimales, par exemple 0,9999. Les décimales excédentaires sont automatiquement ignorées.

Height

String

No

Vous pouvez définir la hauteur du filigrane image de deux manières :

• Entier : la valeur en pixels de la hauteur du filigrane.

  • Plage : [8,4096].

  • Unité : pixel.

• Une valeur décimale qui spécifie la hauteur en proportion de la hauteur de la vidéo de sortie.

  • Plage : (0,1).

  • Prend en charge quatre décimales, par exemple 0,9999. Les décimales excédentaires sont automatiquement ignorées.

Timeline

String

No

La durée d'affichage du filigrane image. Pour plus d'informations, consultez la section Timeline de cette rubrique.

Parameter

Type

Required

Description

Content

String

Yes

Le texte à afficher en tant que filigrane. Le texte doit être encodé au format Base64.

• Par exemple, pour ajouter le filigrane textuel « test text watermark », définissez Content sur « 5rWL6K+V5paH5a2X5rC05Y2w ».

FontName

String

No

Police.

• Pour plus d'informations sur les polices prises en charge, consultez Fonts.

• Valeur par défaut : SimSun.

FontSize

Int

No

Taille de la police.

• Valeurs valides : (4 120).

• Valeur par défaut : 16.

FontColor

String

No

Couleur de la police.

• Pour plus d'informations sur les couleurs prises en charge, consultez la colonne name de FontColor.

• Valeur par défaut : black.

FontAlpha

Float

No

Transparence du texte.

• Valeurs valides : (0,1].

• Valeur par défaut : 1,0.

BorderWidth

Int

No

Largeur du contour

• Unité : pixel.

• Valeurs valides : [0,4096].

• Valeur par défaut : 0.

BorderColor

String

No

Couleur du contour.

• Pour plus d'informations sur les couleurs prises en charge, consultez la colonne name de BorderColor.

• Valeur par défaut : Black.

Top

Int

No

Marge supérieure du texte.

• Unité : pixel.

• Valeurs valides : [0,4096].

• Valeur par défaut : 0.

Left

Int

No

Marge gauche.

• Unité : pixel.

• Valeurs valides : [0,4096].

• Valeur par défaut : 0.

Parameter

Type

Required

Description

Start

String

No

Le début de la plage de temps pendant laquelle le filigrane image est affiché.

• Format : sssss[.SSS].

• La plage de valeurs valides est [0 000, 86399,999]. Le processus de transcodage échoue si l'heure de début dépasse la durée.

• Valeur par défaut : 0.

• Exemple : 18000,30.

Duration

String

No

La plage de temps pendant laquelle le filigrane image est affiché.

• Si le paramètre est défini sur ToEND, le filigrane est affiché en continu jusqu'à la fin de la vidéo.

• Format : sssss[.SSS]. Unité : secondes.

• Valeur par défaut : ToEND.

Parameter

Type

Required

Description

Type

String

No

Le type de filigrane.

• Image : un filigrane image.

• Valeur par défaut : Image.

ReferPos

String

No

L'emplacement du filigrane image.

• Valeurs valides : TopRight, TopLeft, BottomRight et BottomLeft.

• La figure suivante montre un exemple d'utilisation des paramètres ReferPos, Dx et Dy pour spécifier l'emplacement du filigrane image.

Dx

String

No

Le décalage horizontal du filigrane image par rapport à la vidéo de sortie. Les types de valeurs suivants sont pris en charge :

• Entier : la valeur en pixels du décalage horizontal.

  • Unité : pixel.

  • Valeurs valides : [8,4096].

• Décimal : le ratio du décalage horizontal par rapport à la largeur de la vidéo de sortie.

  • Valeurs valides : (0,1).

  • Quatre décimales sont prises en charge, par exemple 0,9999. Les décimales excédentaires sont ignorées.

Dy

String

No

Le décalage vertical du filigrane image par rapport à la vidéo de sortie. Les types de valeurs suivants sont pris en charge :

• Entier : la valeur en pixels du décalage vertical.

  • Unité : pixel.

  • Valeurs valides : [8,4096].

• Décimal : le ratio du décalage vertical par rapport à la hauteur de la vidéo de sortie.

  • Valeurs valides : (0,1).

  • Quatre décimales sont prises en charge, par exemple 0,9999. Les décimales excédentaires sont ignorées.

Width

String

No

La largeur du filigrane image. Les types de valeurs suivants sont pris en charge :

• Entier : la valeur en pixels de la largeur du filigrane.

  • Unité : pixel.

  • Plage : [8,4096].

• Type décimal : un ratio de la largeur de la résolution de la vidéo de sortie.

  • Plage de valeurs : (0,1).

  • Prend en charge quatre décimales, par exemple 0,9999. Les décimales excédentaires sont automatiquement ignorées.

Height

String

No

La hauteur du filigrane image peut être définie de l'une des deux manières suivantes :

• Entier : la valeur en pixels de la hauteur du filigrane.

  • Unité : pixel.

  • Plage : [8,4096].

• Valeur décimale : un ratio par rapport à la hauteur de la résolution de la vidéo de sortie.

  • Plage de valeurs : (0,1).

  • Prend en charge quatre décimales, par exemple 0,9999. Les décimales excédentaires sont automatiquement ignorées.

Timeline

String

No

Filigrane dynamique : pour plus d'informations, consultez Détails des paramètres de timeline.

Parameter

Type

Required

Description

ExtSubtitleList

Object[]

No

Les sous-titres externes. Pour plus d'informations, consultez la section ExtSubtitle de cette rubrique.

• Vous pouvez ajouter jusqu'à quatre fichiers de sous-titres à une tâche de transcodage.

• Exemple : [{"Input":{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.srt"},"CharEnc":"UTF-8"}].

Parameter

Type

Required

Description

Input

String

Yes

Le fichier de sous-titres externe. Utilisez les paramètres Bucket, Location et Object pour spécifier l'emplacement du fichier.

• Les formats SRT et ASS sont pris en charge. Les informations de couleur contenues dans le fichier de sous-titres peuvent être lues.

• Le fichier doit être stocké dans un compartiment OSS. Pour plus d'informations, consultez la section Input de cette rubrique.

• Les espaces réservés sont pris en charge. Pour plus d'informations, consultez la section Règles de remplacement des espaces réservés de cette rubrique.

• Le chemin d'un objet OSS doit être encodé en URL au format UTF-8 avant d'être utilisé dans MPS. Pour plus d'informations, consultez Encodage d'URL.

• Par exemple, si le chemin du fichier d'entrée est a/b/example.flv et que celui du fichier de sous-titres est a/b/example-cn.mp4, vous pouvez utiliser des espaces réservés pour spécifier l'objet au format suivant : {ObjectPrefix}{FileName}-cn.srt. Une fois le chemin encodé en URL, l'objet devient {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"%7bObjectPrefix%7d%7bFileName%7d-cn.srt"}.

CharEnc

String

No

Le format d'encodage des sous-titres externes.

• Valeurs valides : UTF-8, GBK, BIG5 et auto.

• Valeur par défaut : auto.

FontName

String

No

La police du sous-titre.

• Pour plus d'informations sur les polices prises en charge, consultez Polices.

• Valeur par défaut : SimSun.

FontSize

Int

No

La taille de la police du sous-titre.

• Valeurs valides : (4 120).

• Valeur par défaut : 16.

Parameter

Type

Required

Description

TimeSpan

String

No

L'intervalle de temps pour extraire un clip du fichier d'entrée. Pour plus d'informations, consultez la section TimeSpan de cette rubrique.

• Exemple de spécification de l'intervalle de temps à l'aide du paramètre Duration : {"Seek":"00:01:59.999","Duration":"180.30"}, qui indique que le clip commence à 1 minute, 59 secondes et 999 millisecondes et se termine à 5 minutes et 30 millisecondes.

• Exemple de spécification de l'intervalle de temps à l'aide du paramètre End : {"Seek":"00:01:59.999","End":"180.30"}, qui indique que le clip commence à 1 minute, 59 secondes et 999 millisecondes et se termine à l'instant situé 5 minutes et 30 millisecondes avant la fin de la vidéo.

ConfigToClipFirstPart

Boolean

No

Indique s'il faut effectuer un montage vidéo sur le premier segment.

• true : extrait la première partie du fichier en un clip avant la fusion des clips.

• false : le contenu est d'abord concaténé (transcodé), puis monté.

• Valeur par défaut : false.

Parameter

Type

Required

Description

Seek

String

No

Le point de départ temporel du clip. Utilisez ce paramètre pour spécifier le début du clip. Par défaut, le point de départ correspond au début de la vidéo.

• Format : hh:mm:ss[.SSS] ou sssss[.SSS].

• Valeurs valides : [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemple : 00:01:59.999 ou 180.30.

Duration

String

No

La durée du clip. Vous pouvez spécifier la durée du clip par rapport au point temporel indiqué par le paramètre Seek. Par défaut, la durée du clip s'étend du point temporel spécifié par Seek jusqu'à la fin de la vidéo. Vous ne pouvez spécifier qu'un seul des paramètres Duration et End. Si vous spécifiez le paramètre End, le paramètre Duration est ignoré.

• Format : hh:mm:ss[.SSS] ou sssss[.SSS].

• Valeurs valides : [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemple : 00:01:59.99 ou 180.30.

End

String

No

La durée de la partie finale de la vidéo d'origine à rogner. Vous ne pouvez spécifier qu'un seul des paramètres Duration et End. Si vous spécifiez le paramètre End, le paramètre Duration est ignoré.

• Format : hh:mm:ss[.SSS] ou sssss[.SSS].

• Valeurs valides : [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemple : 00:01:59.999 ou 180.30.

Parameter

Type

Required

Description

MergeURL

String

Yes

Le chemin OSS du clip à fusionner.

• Le chemin d'un objet OSS doit être encodé en URL au format UTF-8 avant d'être utilisé dans MPS. Pour plus d'informations, consultez Encodage d'URL.

• Exemple : http://exampleBucket****m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4.

Start

String

No

Le point temporel auquel le clip de sortie est découpé à partir du clip d'origine. Spécifiez ce paramètre si vous souhaitez fusionner uniquement une partie de la vidéo dans le fichier de sortie. Par défaut, le point de départ correspond au début de la vidéo.

• Format : hh:mm:ss[.SSS] ou sssss[.SSS].

• Valeurs valides : [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemple : 01:59:59.999 ou 32000.23.

Duration

String

No

La durée de la vidéo mixée. La durée est relative au point temporel de début spécifié par le paramètre Start. Spécifiez ce paramètre si vous souhaitez fusionner uniquement une partie de la vidéo dans le fichier de sortie. Par défaut, la durée correspond à la période allant du point temporel spécifié par Start jusqu'à la fin de la vidéo.

• Format : hh:mm:ss[.SSS] ou sssss[.SSS].

• Valeurs valides : [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemple : 01:59:59.999 ou 32000.23.

Parameter

Type

Required

Description

OpenUrl

String

Yes

Le chemin OSS de la séquence d'ouverture.

• Le chemin d'un objet OSS doit être encodé en URL au format UTF-8 avant d'être utilisé dans MPS. Pour plus d'informations, consultez Encodage d'URL.

• Exemple : http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv.

Start

String

No

La durée écoulée après le démarrage de la lecture de la vidéo d'entrée avant que la scène d'ouverture ne soit diffusée. La valeur commence à 0.

• Unité : secondes.

• Valeur par défaut : 0.

Width

String

No

La largeur de la vidéo de sortie peut être définie de trois manières :

• Width : la largeur en pixels. La valeur doit être un entier compris entre 0 et 4096.

• -1 : la largeur est égale à celle de l'écran d'ouverture de la vidéo d'entrée.

• Full : la vidéo remplit toute la zone de lecture.

• Valeur par défaut : -1.

Height

String

No

Vous pouvez définir la hauteur de la vidéo de sortie de trois manières :

• Width : la largeur en pixels. La valeur doit être un entier compris entre 0 et 4096.

• -1 : identique à la hauteur de la vidéo d'entrée.

• full : remplit tout le cadre vidéo.

• Valeur par défaut : -1.

Parameter

Type

Required

Description

TailUrl

String

Yes

L'URL de la vidéo de générique de fin dans OSS.

• Le chemin d'un objet OSS doit être encodé en URL au format UTF-8 avant d'être utilisé dans MPS. Pour plus d'informations, consultez Encodage d'URL.

• Exemple : http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_01.flv.

BlendDuration

String

No

Le délai entre la fin de la partie principale et le début de la séquence de fin. Pendant la transition, la dernière image de la partie principale s'estompe progressivement tandis que la première image de la séquence de fin apparaît en fondu.

• Unité : secondes.

• Valeur par défaut : 0.

Width

String

No

La largeur de la séquence de fin de sortie. Valeurs valides :

• Width : la largeur en pixels, comprise dans la plage [0, 4096].

• -1 : la largeur est identique à celle de la vidéo de générique de fin d'entrée.

• full : la vidéo remplit tout le cadre.

• Valeur par défaut : -1.

Height

String

No

La hauteur du générique de fin de sortie dispose de trois paramètres disponibles :

• Width : la largeur en pixels. La valeur doit être un entier compris entre 0 et 4096.

• -1 : la hauteur de la vidéo d'écran de fin d'entrée.

• full : la vidéo remplit la zone de lecture.

• Valeur par défaut : -1.

IsMergeAudio

Boolean

No

Indique s'il faut ajouter l'audio de la vidéo de générique de fin.

• true : active la concaténation.

• false : aucune concaténation n'a lieu.

• Valeur par défaut : true.

BgColor

String

No

La couleur de la marge si la largeur et la hauteur de la séquence de fin sont inférieures à celles de la partie principale.

• Pour plus d'informations sur les couleurs prises en charge, consultez la colonne name de bgcolor.

• Valeur par défaut : White.

Parameter

Type

Required

Description

AmixURL

String

Yes

Le flux audio à mixer prend en charge deux modes :

• input : mélange plusieurs flux audio du fichier d'entrée. Vous pouvez mixer deux flux audio du fichier d'entrée.

• Chemin OSS : ajoute un flux audio externe. Par exemple, vous pouvez ajouter une musique de fond. Vous pouvez mixer un flux audio du fichier d'entrée avec le flux audio spécifié par le chemin OSS. Exemple : http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail.flv.

Map

String

No

Pour sélectionner le flux audio cible à mixer dans AmixURL, utilisez le paramètre AudioStreamMap afin de spécifier le numéro d'ordre du flux audio dans le fichier d'entrée.

• Format : 0:a:{Numéro de série}. Le numéro de série spécifie l'indice du flux audio. Le numéro de série commence à 0.

• Par exemple, 0:a:1 spécifie le deuxième flux audio.

MixDurMode

String

No

La durée du fichier de sortie mixé.

• first : utilise la durée du fichier d'entrée.

• longest : utilise la durée la plus longue entre le fichier d'entrée et le flux audio spécifié par le paramètre AmixURL.

• Valeur par défaut : longest.

Start

String

No

Le point de départ temporel du flux audio. Spécifiez ce paramètre si vous souhaitez mixer uniquement une partie de l'audio dans le fichier de sortie. Par défaut, le point de départ correspond au début de l'audio.

• Format : hh:mm:ss[.SSS] ou sssss[.SSS].

• Valeurs valides : [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemple : 00:01:59.999 ou 18000.30.

Duration

String

No

La durée de l'audio mixé. La durée est relative au point temporel de début spécifié par le paramètre Start. Spécifiez ce paramètre si vous souhaitez mixer uniquement une partie de l'audio dans le fichier de sortie. Par défaut, la durée correspond à la période allant du point temporel spécifié par Start jusqu'à la fin de l'audio.

• Format : hh:mm:ss[.SSS] ou sssss[.SSS].

• Valeurs valides : [00:00:00.000,23:59:59.999] ou [0.000,86399.999].

• Exemple : 00:01:59.999 ou 18000.30.

Parameter

Type

Required

Description

Segment

String

No

La configuration des segments. Pour plus d'informations, consultez la section Segment de cette rubrique.

• Ce paramètre prend effet uniquement si le format de conteneur est défini sur M3U8, HLS-FMP4, MPD ou CMAF.

• Exemple : {"Duration":"10","ForceSegTime":"1,2,4,6,10,14,18"}, qui spécifie que la vidéo est forcée d'être segmentée aux 1re, 2e, 4e, 6e, 10e, 14e, 18e, 20e, 30e, 40e, 50e... secondes.

Parameter

Type

Required

Description

Duration

Int

No

Durée du segment.

• Unité : secondes.

• Valeurs valides : [1,60].

• Valeur par défaut : 10. Ce paramètre force le découpage de la vidéo aux 10e, 20e, 30e et 40e secondes.

ForceSegTime

String

No

Points temporels auxquels la vidéo est forcement découpée. Séparez les points par des virgules (,). Vous pouvez spécifier jusqu'à 10 points.

• Format : {Point dans le temps},{Point dans le temps},{Point dans le temps}.

• Type : décimal. Ce paramètre prend en charge jusqu'à trois décimales.

• Unité : secondes.

• Exemple : 1,2,4,6,10,14,18. La vidéo est ainsi découpée aux 1re, 2e, 4e, 6e, 10e, 14e et 18e secondes.

Parameter

Type

Required

Description

TS

Object

No

Prise en charge non standard des fichiers TS. Pour plus d'informations, consultez la section TS de cette rubrique.

Parameter

Type

Required

Description

Md5Support

Boolean

No

Indique s'il faut inclure la valeur MD5 de chaque fichier TS dans la vidéo M3U8 de sortie.

SizeSupport

Boolean

No

Indique s'il faut inclure la taille de chaque fichier TS dans la vidéo M3U8 de sortie.

Parameter

Type

Required

Description

Type

String

Yes

Méthode de chiffrement de la vidéo. Valeurs valides :

• hls-aes-128 : chiffrement standard.

KeyType

String

Yes

Méthode de chiffrement de la clé.

• Base64 : méthode de chiffrement de base.

• KMS : Key Management Service (KMS). KMS est utilisé pour générer des clés en texte clair et en texte chiffré.

Key

String

Yes

Clé chiffrée pour la vidéo cryptée. Le format de la clé dépend de la méthode de chiffrement.

• Base64 :

  • Chiffrez la clé en texte clair à l'aide de Base64 et définissez ce paramètre sur la clé chiffrée générée.

  • La clé en texte clair est personnalisée et peut comporter jusqu'à 16 caractères.

  • Par exemple, la clé chiffrée correspondant à la clé en texte clair « encryptionkey128 » est « ZW5jcnlwdGlvbmtleTEyOA== ».

• KMS :

  • Appelez l'opération GenerateKMSDataKey, transmettez la clé maître client (CMK), puis définissez le paramètre KeySpec sur AES_128 pour obtenir la clé chiffrée correspondante à partir du paramètre CiphertextBlob.

KeyUri

String

Yes

Il s'agit du point de terminaison du service de déchiffrement. Vous devez configurer le service vous-même.

• L'URL ne peut pas être transmise à MPS en texte clair. Vous devez chiffrer l'URL en Base64.

• Par exemple, si l'URL est http://aliyun.com/document/hls128.key, elle est chiffrée en aHR0cDovL2FsaXl1bi5jb20vZG9jdW1lbnQvaGxzMTI4LmtleQ== en Base64.

SkipCnt

String

No

Nombre de clips non chiffrés au début de la vidéo. Cela permet de réduire le temps de chargement lors du démarrage.

• Exemple : 3.

Paramètre

Type

Obligatoire

Description

Num

String

Non

Le nombre d'instantanés à capturer.

• Si vous spécifiez l'un des paramètres Interval et Num, le mode asynchrone est utilisé par défaut. La valeur du paramètre Num doit être supérieure à 0.

• Si vous laissez les paramètres Num et Interval vides et spécifiez le paramètre Time, le système capture de manière synchrone un instantané à l'heure spécifiée.

• Si vous définissez le paramètre Num sur 1 et spécifiez le paramètre Time, le système capture de manière asynchrone un instantané à l'heure spécifiée.

• Si vous définissez le paramètre Num sur une valeur supérieure à 1, le système commence à capturer de manière asynchrone des instantanés à l'heure spécifiée pour le paramètre Time et s'arrête lorsque le nombre d'instantanés capturés atteint le nombre spécifié pour le paramètre Num. Les instantanés sont capturés à l'intervalle spécifié par le paramètre Interval. Si vous ne spécifiez pas le paramètre Interval, les instantanés sont capturés toutes les 10 secondes. Si le résultat de Time + Interval × Num est supérieur à la durée de la vidéo d'entrée, seuls les instantanés capturés à des moments situés dans la durée de la vidéo d'entrée peuvent être générés. Une fois les instantanés générés, le nombre réel d'instantanés est renvoyé.

• Si vous définissez le paramètre Num sur une valeur supérieure à 1 et le paramètre Interval sur 0, le système commence à capturer de manière asynchrone des instantanés au moment spécifié pour le paramètre Time. Le nombre d'instantanés est déterminé par le paramètre Num et les instantanés sont capturés de manière uniforme sur toute la durée de la vidéo d'entrée.

Time

String

Non

Le moment auquel le système commence à capturer des instantanés dans la vidéo d'entrée.

• Unité : milliseconde.

• Si la valeur du paramètre Time dépasse la durée de la vidéo, la génération des instantanés échoue.

• Ce paramètre n'est pas requis si des instantanés sont capturés à des moments précis. Dans les autres scénarios, ce paramètre est obligatoire.

  Remarque

  Dans le scénario où des instantanés sont capturés à des moments précis, MPS convertit le moment minimal du paramètre TimeArray en une valeur en millisecondes. Cette valeur est utilisée pour le paramètre Time dans ce scénario. Si vous spécifiez l'espace réservé {SnapshotTime} dans le chemin de sortie, l'espace réservé est remplacé par la valeur du paramètre Time.

Interval

String

Non

L'intervalle de capture des instantanés.

• Si vous spécifiez ce paramètre, le mode asynchrone est automatiquement utilisé pour capturer les instantanés.

• Définissez le paramètre Interval sur une valeur supérieure à 0 si vous souhaitez capturer plusieurs instantanés de manière asynchrone. Unité : secondes.

• L'intervalle pour les captures d'écran moyennes asynchrones est de 0.

• La valeur par défaut est 10. Cette valeur est soumise si Num est défini mais que ce paramètre ne l'est pas.

TimeArray

Array

Non

Le tableau des moments précis. Ce paramètre est requis si vous capturez des instantanés à des moments précis.

• La valeur doit être un entier unique en millisecondes.

• Les moments ne peuvent pas dépasser la durée de la vidéo. Sinon, les instantanés ne peuvent pas être capturés.

• Vous pouvez spécifier les moments dans l'ordre ou hors ordre. Nous vous recommandons de les spécifier dans l'ordre. Si vous les spécifiez hors ordre, MPS trie ces moments.

FrameType

String

Non

Spécifie le type de capture d'écran.

• Valeur par défaut : intra.

• normal : images régulières. La qualité d'image des images régulières est inférieure à celle des images clés. De plus, la capture d'images régulières prend plus de temps que celle des images clés. Cependant, une image régulière peut être capturée à un moment précis.

• intra (par défaut) : images clés. Les images clés des vidéos offrent une bonne qualité d'image et peuvent être capturées rapidement car elles sont décodées de manière indépendante. Cependant, les images clés apparaissent dans une vidéo à intervalles réguliers et ne peuvent pas être capturées à des moments précis. Si le moment que vous spécifiez n'est pas exact, le système capture l'image clé la plus proche du moment spécifié. Dans ce cas, si la distance entre deux images clés est supérieure à l'intervalle de capture des instantanés, le nombre d'instantanés générés peut être inférieur au nombre d'instantanés souhaité.

Width

String

Non

La largeur des instantanés.

• Unité : pixel.

• Valeurs valides : [8,4096]. Nous vous recommandons de spécifier un nombre pair.

• Valeur par défaut :

  • Par défaut, si vous ne spécifiez ni largeur ni hauteur, la largeur de la vidéo d'entrée est utilisée.

  • Si seule la hauteur est spécifiée, la largeur des instantanés est calculée en fonction du rapport d'aspect de la vidéo d'entrée.

Height

String

Non

La hauteur des instantanés.

• Unité : pixel.

• Valeurs valides : [8,4096]. Nous vous recommandons de spécifier un nombre pair.

• Valeur par défaut :

  • Par défaut, si vous ne spécifiez ni largeur ni hauteur, la hauteur de la vidéo d'entrée est utilisée.

  • Si seule la largeur est spécifiée, la hauteur des instantanés est calculée en fonction du rapport d'aspect de la vidéo d'entrée.

BlackLevel

String

Non

La limite supérieure des pixels noirs dans un instantané. Si les pixels noirs d'un instantané dépassent cette valeur, le système considère que l'image est un écran noir. Pour plus d'informations sur les pixels noirs, consultez la description du paramètre PixelBlackThreshold.

PixelBlackThreshold

String

Non

Le seuil de valeur de couleur pour les pixels. Si la valeur de couleur d'un pixel est inférieure au seuil, le système considère que le pixel est un pixel noir.

• Valeurs valides : [0 255]. 0 spécifie un pixel noir pur et 255 spécifie un pixel blanc pur.

• Si vous souhaitez améliorer le filtrage des écrans noirs, spécifiez une valeur plus élevée pour ce paramètre. Nous vous recommandons de définir ce paramètre sur 30 et d'ajuster la valeur selon vos besoins.

• Par exemple, si vous définissez ce paramètre sur 100, les pixels dont les valeurs de couleur sont inférieures à 100 sont considérés comme des pixels noirs.

Format

String

Non

Le format du fichier de sortie.

• Si vous définissez ce paramètre sur vtt, le fichier de sortie est au format WebVTT. Vous devez spécifier le paramètre SubOut pour déterminer s'il faut générer des fichiers WebVTT.

• Par défaut, ce paramètre est laissé vide. Dans ce cas, le fichier de sortie est généré au format JPG.

SubOut

Object

Non

Les configurations du fichier WebVTT. Pour plus d'informations, consultez la section SubOut Webvtt de cette rubrique.

• Le paramètre est requis si le paramètre Format est défini sur vtt.

TileOut

Object

Non

Les configurations de la mosaïque d'images. Pour plus d'informations, consultez la section TileOut de cette rubrique.

• Après avoir défini ce paramètre, les instantanés générés sont combinés en une mosaïque d'images. Le paramètre TileOutputFile spécifie la mosaïque d'images de sortie.

• Si vous laissez ce paramètre vide, aucune mosaïque d'images n'est générée.

OutputFile

Object

Oui

La sortie est un seul petit fichier image stocké à l'emplacement spécifié par OSS Bucket, Location et Object. Pour plus d'informations, consultez Détails de la capture d'écran OutputFile.

• Les fichiers d'instantané sont au format JPG.

• Exemple : {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.jpg"}.

TileOutputFile

Object

Non

La mosaïque d'images de sortie. Vous devez spécifier le chemin de stockage de l'objet dans OSS. La valeur de ce paramètre est similaire à celle du paramètre OutputFile.

• Ce paramètre est requis si vous spécifiez le paramètre TileOut pour générer une mosaïque d'images.

• Le fichier puzzle est au format JPG.

• Exemple : {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.jpg"}.

Paramètre

Type

Obligatoire

Description

IsSptFrag

String

Non

Indique s'il faut générer des fichiers d'index WebVTT. Valeurs valides :

• true : génère des fichiers d'index WebVTT. Les fichiers d'index WebVTT sont stockés dans le même chemin que les instantanés.

• false : ne génère pas de fichiers d'index WebVTT. Seuls les instantanés sont exportés.

• Valeur par défaut : false.

Paramètre

Type

Obligatoire

Description

Lines

Int

Non

Le nombre de lignes contenues dans l'instantané en mosaïque.

• Valeurs valides : (0,10000].

• Valeur par défaut : 10.

Columns

Int

Non

Le nombre de colonnes contenues dans l'instantané en mosaïque.

• Valeurs valides : (0,10000].

• Valeur par défaut : 10.

CellWidth

String

Non

Largeur d'une seule image.

• Unité : pixel.

• Valeur par défaut : la largeur de l'instantané d'origine.

CellHeight

String

Non

Hauteur d'une seule image.

• Unité : pixel.

• Valeur par défaut : la hauteur de l'instantané d'origine.

Padding

String

Non

Espacement entre les images individuelles

• Unité : pixel.

• Valeur par défaut : 0.

Margin

String

Non

Largeur de la bordure.

• Valeur par défaut : 0.

• Unité : pixel.

Color

String

Non

La couleur d'arrière-plan. La couleur d'arrière-plan utilisée pour remplir les marges, l'espacement entre les instantanés et la zone où aucun instantané n'est affiché.

• Vous pouvez spécifier un mot-clé de couleur ou une valeur aléatoire pour ce paramètre. Par exemple, si vous souhaitez définir la couleur d'arrière-plan sur noir, vous pouvez spécifier le mot-clé de couleur dans l'un des formats suivants : Black, black et #000000.

• Valeur par défaut : black.

IsKeepCellPic

String

Non

Détermine s'il faut conserver les vignettes individuelles.

• true : le graphique unique est stocké dans OutputFile.

• false : l'élément n'est pas conservé.

• Par défaut : false (non conservé).

Paramètre

Type

Obligatoire

Description

Bucket

String

Oui

Le bucket OSS qui stocke les fichiers de sortie des petites images individuelles.

• Le bucket doit respecter les définitions des buckets OSS. Pour plus d'informations, consultez Concepts de base.

Location

String

Oui

La région dans laquelle réside le bucket OSS.

• Le bucket OSS doit résider dans la même région que MPS.

• Respectez les définitions des régions OSS. Pour plus d'informations, consultez Concepts de base.

Object

String

Oui

Le chemin dans lequel les instantanés de sortie sont stockés dans OSS.

• Le chemin inclut le nom du fichier et l'extension du nom de fichier. Pour plus d'informations sur le terme clé d'objet, consultez Termes.

• Les espaces réservés sont pris en charge. Pour plus d'informations, consultez la section Règles de remplacement des espaces réservés de cette rubrique.

• La seule extension de nom de fichier prise en charge est .jpg.

• Le chemin d'un objet OSS doit être encodé en URL en UTF-8 avant d'être utilisé dans MPS. Pour plus d'informations, consultez Encodage URL.

Paramètre

Type

Obligatoire

Description

QueueName

String

Non

File MNS à associer. Lorsqu'une tâche dans la file MPS est terminée, son résultat d'exécution est envoyé à cette file. Pour plus d'informations sur la réception des notifications de message, consultez Recevoir des notifications de message.

• Vous pouvez spécifier l'un des paramètres QueueName ou Topic.

• Valeurs valides : les topics MNS que vous avez créés. Si aucun topic actif n'est disponible, accédez à Simple Message Queue (anciennement MNS) pour en créer un.

Topic

String

Non

Topic SMQ dans lequel vous souhaitez recevoir les notifications. Une fois la tâche terminée, les résultats sont publiés vers le topic SMQ. Le topic SMQ transfère ensuite le message vers plusieurs files ou URL abonnées au topic. Pour plus d'informations sur la réception des notifications, consultez Recevoir des notifications.

• Vous pouvez spécifier l'un des paramètres QueueName ou Topic.

• La valeur doit correspondre à un topic MNS que vous avez créé. Si aucun topic n'est disponible, accédez à la console Simple Message Queue (anciennement MNS) pour en créer un.

Paramètre

Type

Obligatoire

Description

Bucket

String

Oui

Bucket OSS qui stocke le fichier d'entrée.

• Accordez l'autorisation de lecture sur le bucket OSS à ApsaraVideo Media Processing depuis la page Bucket Authorization de la console OSS.

• Le bucket doit être conforme à la définition du bucket OSS. Pour plus d'informations, consultez le Glossaire.

Location

String

Oui

Région dans laquelle se trouve le bucket OSS.

Respectez la définition Location d'OSS. Pour plus d'informations, consultez le Glossaire.

Object

String

Oui

Objet OSS utilisé comme fichier d'entrée.

• Le chemin d'un objet OSS doit être conforme à la norme RFC 2396 et encodé en URL au format UTF-8. Pour plus d'informations, consultez l'encodage URL.

• Ceci est conforme à la définition Object d'OSS. Pour plus d'informations, consultez le Glossaire.

Audio

String

Non

Configuration audio du fichier d'entrée. La valeur doit être un objet JSON.

• Pour plus d'informations, consultez la section InputAudio de cette rubrique.

• Exemple : {"Channels":"2","Samplerate":"44100"}.

Container

String

Non

Configuration du conteneur du fichier d'entrée. La valeur doit être un objet JSON.

• Pour plus d'informations, consultez la section InputContainer de cette rubrique.

• Exemple : {"Format":"u8"}.

Paramètre

Type

Obligatoire

Description

Format

String

Oui

Format audio du fichier d'entrée.

Valeurs valides : alaw, f32be, f32le, f64be, f64le, mulaw, s16be, s16le, s24be, s24le, s32be, s32le, s8, u16be, u16le, u24be, u24le, u32be, u32le et u8.

Paramètre

Type

Obligatoire

Description

Channels

String

Oui

Nombre de canaux audio du fichier d'entrée. Valeurs valides : [1,8].

Samplerate

String

Oui

Fréquence d'échantillonnage audio du fichier d'entrée.

• Valeurs valides : (0,320000].

• Unité : Hz.

Paramètre

Type

Obligatoire

Description

QualityControl

String

Non

Configuration de la qualité du fichier de sortie. La valeur doit être un objet JSON. Pour plus d'informations, consultez la section QualityControl de cette rubrique.

PropertiesControl

String

Non

Configuration des propriétés. La valeur doit être un objet JSON. Pour plus d'informations, consultez la section PropertiesControl de cette rubrique.

Paramètre

Type

Obligatoire

Description

RateQuality

String

Non

Niveau de qualité du fichier de sortie.

• Valeurs valides : (0,51).

• La valeur doit être un entier.

• Valeur par défaut : 25.

MethodStreaming

String

Non

Mode de lecture. Valeurs valides : network et local.

Valeur par défaut : network.

Paramètre

Type

Obligatoire

Description

Deinterlace

String

Non

Détermination du mode de balayage forcé.

• Auto signifie Automatique.

• Force : exécute le désentrelacement de force.

• None : interdit le désentrelacement.

Crop

String

Non

Configuration du recadrage de l'image vidéo.

• La valeur par défaut est Automatic.

• Si vous ne définissez pas ce paramètre sur un objet JSON vide, le paramètre Mode est obligatoire.

• Pour plus d'informations, consultez la section Crop de cette rubrique.

Paramètre

Type

Obligatoire

Description

Mode

String

Non

Ce paramètre est obligatoire si la valeur du paramètre Crop n'est pas un objet JSON vide. Valeurs valides :

• Auto (Automatique)

• Force : exécute le recadrage de force.

• None : aucune opération n'est effectuée.

Width

Integer

Non

Largeur recadrée

• Valeurs valides : [8,4096].

• Si vous définissez le paramètre Mode sur Auto ou None, ce paramètre est ignoré.

Height

Integer

Non

Hauteur de l'image recadrée.

• Valeurs valides : [8,4096].

• Si vous définissez le paramètre Mode sur Auto ou None, ce paramètre est ignoré.

Top

Integer

Non

Marge supérieure à recadrer.

• Valeurs valides : [8,4096].

• Si vous définissez le paramètre Mode sur Auto ou None, ce paramètre est ignoré.

Left

Integer

Non

Marge gauche à recadrer.

• Valeurs valides : [8,4096].

• Si vous définissez le paramètre Mode sur Auto ou None, ce paramètre est ignoré.

Paramètre

Type

Obligatoire

Description

MergeList

String

Non

Champ de configuration pour la concaténation vidéo.

• La valeur doit être un tableau JSON contenant jusqu'à quatre paramètres MergeURL. Pour plus d'informations, consultez la section MergeList de cette rubrique.

• Exemple : [{"MergeURL":"http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/k/mp4.mp4"},{"MergeURL":"http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/c/ts.ts","Start":"1:14","Duration":"29"}].

Paramètre

Type

Obligatoire

Description

URL

String

Non

URL du fichier d'entrée dans OSS.

• Exemple : http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example.flv.

• Si vous ne spécifiez pas ce paramètre, les paramètres Bucket, Location et Object sont obligatoires.

Bucket

String

Non

• Cette valeur est obligatoire si vous ne spécifiez pas d'URL.

• Sinon, ce paramètre est ignoré. Avant de spécifier un bucket OSS, accordez les autorisations d'écriture sur le bucket OSS à MPS depuis la page Access Control de la console OSS.

• Pour plus d'informations sur le terme bucket, consultez le Glossaire.

Location

String

Non

• Cette valeur est obligatoire si vous ne spécifiez pas d'URL.

• Sinon, la valeur est ignorée et le centre de données (OSS Location) du bucket OSS est utilisé en sortie.

• Ceci est conforme à la définition Location d'OSS. Pour plus d'informations, consultez le Glossaire.

Object

String

Non

• Cette valeur est obligatoire si vous ne spécifiez pas d'URL.

• Si la valeur n'est pas valide, le fichier de sortie (OSS Object) est encodé en UTF-8 puis encodé en URL conformément à la norme RFC 2396. Pour plus d'informations, consultez l'encodage URL.

• Ceci doit être conforme à la définition Object d'OSS. Pour plus d'informations, consultez le Glossaire.

Paramètre

Type

Obligatoire

Description

URI

String

Non

Nom du flux vidéo de sortie, qui doit se terminer par .m3u8. Exemple : a/b/test.m3u8. Format : ^[a-z]{1}[a-z0-9./-]+$.

RefActivityName

String

Oui

Nom de l'activité associée.

ExtXStreamInfo

Json

Oui

Informations sur le flux. Exemple : {"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}.

Paramètre

Type

Obligatoire

Description

Name

String

Oui

Nom de la ressource. Le nom peut comporter jusqu'à 64 octets et doit être encodé en UTF-8. Ce paramètre correspond à NAME dans le protocole HTTP Live Streaming (HLS) V5.

Language

String

Non

Facultatif. Code de langue au format RFC 5646 correspondant à l'attribut LANGUAGE du protocole HLS V5.

URI

String

Oui

Chemin de la ressource.

Format : ^[a-z]{1}[a-z0-9./-]+$. Exemple : a/b/c/d/audio-1.m3u8.

Paramètre

Type

Obligatoire

Description

MultiBitrateVideoStreams

JsonArray

Oui

Tableau de plusieurs flux. Exemple : [{"RefActivityName": "video-1","ExtXStreamInfo": {"BandWidth": "111110","Audio":"auds","Subtitles": "subs"}}].

Paramètre

Type

Obligatoire

Description

BandWidth

String

Oui

Bande passante. Ce paramètre spécifie la limite supérieure du débit binaire total et correspond à BANDWIDTH dans le protocole HLS V5.

Audio

String

Non

ID du groupe de flux audio. Ce paramètre correspond à AUDIO dans le protocole HLS V5.

Subtitles

String

Non

ID du groupe de flux de sous-titres. Ce paramètre correspond à SUBTITLES dans le protocole HLS V5.

Paramètre

Type

Obligatoire

Description

Group

String

Oui

Nom du groupe. Exemple :

<AdaptationSet group="videostreams" mimeType="video/mp4" par="4096:1744"
              minBandwidth="258157" maxBandwidth="10285391" minWidth="426" maxWidth="4096"
              minHeight="180" maxHeight="1744" segmentAlignment="true"
              startWithSAP="1">

Lang

String

Non

Langue de la ressource. Vous pouvez spécifier ce paramètre pour les ressources audio et les sous-titres.

Paramètre

Type

Obligatoire

Description

Id

String

Oui

ID du flux. Exemple :

<Representation id="240p250kbps" frameRate="24" bandwidth="258157"
              codecs="avc1.4d400d" width="426" height="180">

URI

String

Oui

Chemin de la ressource. Format : ^[a-z]{1}[a-z0-9./-]+$. Exemple : a/b/c/d/video-1.mpd.

Paramètre

Type

Obligatoire

Description

Format

String

Oui

Format du fichier de sous-titres d'entrée. Valeurs valides : stl, ttml et vtt.

InputFile

String

Oui

{"Bucket":"example-bucket-****","Location":"oss-cn-hangzhou","Object":"example-logo****.png"}
              or
              {"URL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/subtitle/test****.chs.vtt"}