TargetVideo - Intelligent Media Management - Centre de documentation Alibaba Cloud

Paramètre	Type	Description	Exemple
	object	Les paramètres de traitement vidéo.
DisableVideo	boolean	Indique si la génération du flux vidéo doit être désactivée. Valeurs valides : true : Désactivé. Le fichier de sortie ne contient pas de flux vidéo. false (par défaut) : Non désactivé.	false
Stream	array	La liste des numéros d'index des flux vidéo à traiter à partir du fichier source. Une valeur vide (par défaut) indique que le flux vidéo avec le plus petit numéro d'index (le premier flux vidéo) est traité. Un numéro d'index supérieur à 100 indique que tous les flux vidéo sont traités. Exemple : `[0,1]` traite les flux vidéo avec les numéros d'index 0 et 1. `[1]` traite le flux vidéo avec le numéro d'index 1. `[101]` traite tous les flux vidéo. Remarque Seuls les flux vidéo avec des numéros d'index existants sont traités. Si un flux vidéo correspondant à un numéro d'index n'existe pas, ce numéro d'index est ignoré.
	integer	Le numéro d'index du flux vidéo à traiter.	0
TranscodeVideo	object	Les paramètres de transcodage vidéo. Une valeur vide indique que le traitement vidéo est désactivé et que le fichier de sortie ne contient pas de flux vidéo. Remarque Il n'est pas recommandé de définir ce paramètre sur une valeur vide pour désactiver le traitement vidéo.
Codec	string	Le format d'encodage vidéo. Valeurs valides : Pour l'API CreateMediaConvert : copy (par défaut), h264, h265, vp9. Avertissement Lorsque ce paramètre est défini sur copy, les flux vidéo à traiter sont directement copiés dans le fichier de sortie, et les autres paramètres sous TranscodeVideo ne prennent pas effet. copy ne peut pas être utilisé pour la concaténation vidéo et est généralement utilisé pour les scénarios de conversion de format de conteneur. Pour l'API GenerateVideoPlaylist : h264 (par défaut), h265.	h264
PixelFormat	string	Le format de pixel. La valeur par défaut est identique à celle de la vidéo source. Valeurs valides : yuv420p yuv422p yuv444p yuv420p10le yuv422p10le yuv444p10le yuva420p Remarque yuva420p n'est disponible que pour l'API CreateMediaConvert, et le paramètre Codec doit être défini sur vp9.	yuv420p
FrameRateOption	string	L'option de fréquence d'images. Valeurs valides : fixed : Utilise toujours la fréquence d'images vidéo cible spécifiée. adaptive : Utilise la fréquence d'images de la vidéo source lorsqu'elle est inférieure à la fréquence d'images vidéo cible spécifiée. fall : Renvoie un échec lorsque la fréquence d'images de la vidéo source est inférieure à la fréquence d'images vidéo cible spécifiée. Valeur par défaut : Pour l'API CreateMediaConvert, la valeur par défaut est fixed. Pour l'API GenerateVideoPlaylist, la valeur par défaut est adaptive. Remarque Ce paramètre doit être défini conjointement avec le paramètre FrameRate.	fixed
FrameRate	number	La fréquence d'images vidéo. La valeur par défaut est identique à celle de la vidéo source.	25
ResolutionOption	string	L'option de résolution. Valeurs valides : fixed : Utilise toujours la résolution vidéo cible spécifiée. adaptive : Utilise la résolution de la vidéo source lorsque la zone de résolution de la vidéo source est inférieure à la zone de résolution vidéo cible spécifiée. fall : Renvoie un échec lorsque la zone de résolution de la vidéo source est inférieure à la zone de résolution vidéo cible spécifiée. Valeur par défaut : Pour l'API CreateMediaConvert, la valeur par défaut est fixed. Pour l'API GenerateVideoPlaylist, la valeur par défaut est adaptive. Remarque Ce paramètre doit être défini conjointement avec le paramètre Resolution.	fixed
Resolution	string	La résolution de la vidéo de sortie au format `largeurxhauteur`. La valeur par défaut est identique à la résolution de lecture de la vidéo source. Vous pouvez spécifier à la fois la largeur et la hauteur, ou spécifier uniquement la largeur ou la hauteur. Vous pouvez également utiliser le paramètre AdaptiveResolutionDirection pour spécifier à la fois les côtés long et court, ou uniquement le côté long ou court. La plage de valeurs pour un seul côté est (0,4096]. Exemple 1 : Si AdaptiveResolutionDirection est false, `1280x720` définit la largeur sur 1280 et la hauteur sur 720. `1280x` définit la largeur sur 1280 et conserve la hauteur identique à celle de la vidéo source. `x720` définit la hauteur sur 720 et conserve la largeur identique à celle de la vidéo source. Exemple 2 : Si AdaptiveResolutionDirection est true, `1280x720` définit le côté long sur 1280 et le côté court sur 720. `1280x` définit le côté long sur 1280 et conserve le côté court identique à celui de la vidéo source. `x720` définit le côté court sur 720 et conserve le côté long identique à celui de la vidéo source. Remarque Si la vidéo source contient des informations de rotation, la détermination de la largeur/hauteur et des côtés long/court est basée sur l'état après rotation, qui correspond à la résolution de lecture.	640x480
AdaptiveResolutionDirection	boolean	Indique si le mode adaptatif des côtés long/court doit être activé. Valeurs valides : true : Activé. Le format du paramètre Resolution est `côté long × côté court`. false (par défaut) : Désactivé. Le format du paramètre Resolution est `largeur × hauteur`.	true
ScaleType	string	Le mode de mise à l'échelle. Valeurs valides : stretch (par défaut) : Largeur/hauteur ou côtés long/court fixes. Force la mise à l'échelle et étire pour remplir les zones vides. crop : Mise à l'échelle proportionnelle. Met à l'échelle à la résolution minimale qui dépasse le rectangle de largeur/hauteur ou de côtés long/court spécifié, puis recadre l'excédent au centre. fill : Mise à l'échelle proportionnelle. Met à l'échelle à la résolution maximale dans le rectangle de largeur/hauteur ou de côtés long/court spécifié, puis remplit les zones vides avec du noir en utilisant un alignement central. fit : Mise à l'échelle proportionnelle. Met à l'échelle à la résolution maximale dans le rectangle de largeur/hauteur ou de côtés long/court spécifié. Remarque Ce paramètre doit être défini conjointement avec le paramètre Resolution.	crop
Rotation	integer	Le degré de rotation horaire de la vidéo. Valeurs valides : 0 (par défaut) 90 180 270	90
BitrateOption	string	L'option de débit binaire vidéo. Valeurs valides : fixed : Utilise toujours le débit binaire vidéo cible spécifié. adaptive : Utilise le débit binaire de la vidéo source lorsqu'il est inférieur au débit binaire vidéo cible spécifié. fall : Renvoie un échec lorsque le débit binaire de la vidéo source est inférieur au débit binaire vidéo cible spécifié. Valeur par défaut : Pour l'API CreateMediaConvert, la valeur par défaut est fixed. Pour l'API GenerateVideoPlaylist, la valeur par défaut est adaptive. Remarque Ce paramètre doit être défini conjointement avec le paramètre Bitrate.	fixed
Bitrate	integer	Le débit binaire du flux vidéo, en bits par seconde (bit/s). Remarque Ce paramètre est mutuellement exclusif avec CRF. Si ce paramètre et CRF sont tous deux vides, l'encodage est effectué avec une valeur CRF de 23.	128000
GOPSize	integer	Le nombre d'images entre les images clés. Valeur par défaut : 150. Remarque Ce paramètre n'est pas pris en charge pour l'API GenerateVideoPlaylist.	60
CRF	number	Spécifie le mode de qualité constante. Ce paramètre est mutuellement exclusif avec le paramètre Bitrate. La plage de valeurs est [0,51]. Une valeur plus élevée entraîne une qualité vidéo inférieure. La plage de valeurs recommandée est [18,38].	18
BufferSize	integer	La taille de la mémoire tampon de décodage pour le débit binaire variable, en bits par seconde (bps). Remarque Ce paramètre prend effet uniquement lorsqu'il est utilisé conjointement avec le paramètre CRF.	4000000
MaxBitrate	integer	La limite de débit binaire maximal pour le débit binaire variable. Lors de l'utilisation de ce paramètre, le paramètre BufferSize doit être spécifié. Remarque Ce paramètre prend effet uniquement lorsqu'il est utilisé conjointement avec le paramètre CRF.	128000
BFrames	integer	Le nombre d'images B consécutives. Valeur par défaut : 3.	3
Refs	integer	Le nombre d'images de référence. Valeur par défaut : 2.	2
VideoSlim	integer	Active le mode HD léger. Valeurs valides : 0 : Valeur par défaut. Désactivé. 1 : Utilise le mode HD léger pour le transcodage. Remarque Pour des résultats optimaux, utilisez les paramètres Bitrate ou CRF officiellement recommandés pour l'encodage de transcodage vidéo avec le mode HD léger. Important Le mode HD léger prend uniquement en charge les formats h.264/h.265, uniquement yuv420p, une profondeur de 8 bits, et ne prend pas en charge la sortie de transcodage vidéo multi-cible ni la concaténation vidéo. Pour plus d'informations, consultez Présentation du produit HD léger.	0
FilterVideo	object	Les paramètres de traitement vidéo. Ce paramètre ne prend pas effet lorsque le paramètre TranscodeVideo est vide ou lorsque TranscodeVideo.Codec est défini sur copy. Remarque Ce paramètre n'est pas pris en charge pour l'API GenerateVideoPlaylist.
Watermarks	array	La liste des filigranes vidéo.
	object	Les informations sur le filigrane vidéo.
Type	string	Le type de filigrane. Valeurs valides : text (par défaut) : filigrane textuel. file : filigrane d'image ou d'image animée.	text
Dx	number	La signification diffère selon que la valeur est un entier ou un décimal : 0 (par défaut) : le décalage en pixels et le rapport entre le décalage horizontal et la hauteur de la résolution de sortie sont tous deux de 0. Entier : le décalage en pixels (px). Plage de valeurs : [1,4096]. Décimal : le rapport entre le décalage horizontal et la hauteur de la résolution de sortie. Plage de valeurs : (0,1).	0
Dy	number	La signification diffère selon que la valeur est un entier ou un décimal : 0 (par défaut) : le décalage en pixels et le rapport entre le décalage vertical et la hauteur de la résolution de sortie sont tous deux de 0. Entier : le décalage en pixels (px). Plage de valeurs : [1,4096]. Décimal : le rapport entre le décalage vertical et la hauteur de la résolution de sortie. Plage de valeurs : (0,1).	0
StartTime	number	L'heure de début pour l'ajout du filigrane, en secondes (s). La valeur par défaut est l'heure de début de la vidéo.	0
Duration	number	La durée d'affichage du filigrane, en secondes (s). La valeur par défaut s'étend jusqu'à la fin de la vidéo.	0
ReferPos	string	La position de référence pour l'ajout du filigrane. Valeurs valides : topleft (par défaut) : coin supérieur gauche topright : coin supérieur droit bottomright : coin inférieur droit bottomleft : coin inférieur gauche	topleft
Content	string	Le contenu du filigrane textuel. La valeur par défaut est vide. Important Ce paramètre prend effet lorsque le paramètre `Type` est défini sur `text`.	exemple
FontName	string	Le nom de la police du filigrane textuel. Valeurs valides : SourceHanSans-Regular (par défaut) SourceHanSans-Bold SourceHanSerif-Regular SourceHanSerif-Bold Important Ce paramètre prend effet lorsque le paramètre `Type` est défini sur `text`.	SourceHanSans-Bold
FontSize	integer	La taille de la police du filigrane textuel. Valeur par défaut : 16. La valeur doit être un entier. Plage de valeurs : (4,120). Important Ce paramètre prend effet lorsque le paramètre `Type` est défini sur `text`.	18
FontColor	string	La couleur de la police du texte du filigrane. Le format est #RRGGBB. Valeur par défaut : #000000. Les valeurs telles que « red » et « green » sont également prises en charge. Important Ce paramètre prend effet lorsque le paramètre `Type` est défini sur `text`.	red
FontApha	number	La transparence de la police du filigrane textuel. Plage de valeurs : (0,1]. Valeur par défaut : 1, ce qui indique une opacité totale. Important Ce paramètre prend effet lorsque le paramètre `Type` est défini sur `text`.	0.8
BorderWidth	integer	La largeur de la bordure du filigrane textuel, en pixels (px). La valeur doit être un entier. Plage de valeurs : [0,4096]. Valeur par défaut : 0. Important Ce paramètre prend effet lorsque le paramètre `Type` est défini sur `text`.	2
BorderColor	string	La couleur de la bordure du texte du filigrane. Le format est #RRGGBB. Valeur par défaut : #000000. Les valeurs telles que « red » et « green » sont également prises en charge. Important Ce paramètre prend effet lorsque le paramètre `Type` est défini sur `text`.	red
URI	string	L'URI OSS du fichier de filigrane. Les formats pris en charge sont PNG et MOV. Le format de l'URI OSS est `oss://<bucket>/<object>`, où `<bucket>` est le nom d'un compartiment OSS dans la même région que le projet actuel, et `<object>` est le chemin complet du fichier, y compris l'extension du nom de fichier. Important Ce paramètre prend effet lorsque le paramètre `Type` est défini sur `file`.	oss://test-bucket/watermark.jpg
Width	number	La largeur de l'image du filigrane. La valeur par défaut est la largeur d'origine de l'image du filigrane. La signification diffère selon que la valeur est un entier ou un décimal : Entier : la valeur en pixels de la largeur de suppression du logo, en pixels (px). Plage de valeurs : [1,4096]. Décimal : le rapport par rapport à la largeur de la résolution vidéo de sortie. Plage de valeurs : (0,1).	80
Height	number	La hauteur de l'image du filigrane. La valeur par défaut est la hauteur d'origine de l'image du filigrane. La signification diffère selon que la valeur est un entier ou un décimal : Entier : la valeur en pixels de la hauteur de suppression du logo, en pixels (px). Plage de valeurs : [1,4096]. Décimal : le rapport par rapport à la hauteur de la résolution vidéo de sortie. Plage de valeurs : (0,1).	40
Delogos	array	Floute une zone rectangulaire de la vidéo pour supprimer les logos, les marques de chaîne et les éléments similaires.
	object	Les paramètres de traitement de flou vidéo.
StartTime	number	L'heure de début pour l'ajout de la mosaïque, en secondes (s). La valeur par défaut est l'heure de début de la vidéo.	0
Duration	number	La durée d'application de la mosaïque, en secondes (s). La valeur par défaut s'étend jusqu'à la fin de la vidéo.	15
Dx	number	La signification diffère selon que la valeur est un entier ou un décimal : 0 (par défaut) : le décalage en pixels et le rapport entre le décalage horizontal et la hauteur de la résolution de sortie sont tous deux de 0. Entier : le décalage en pixels (px). Plage de valeurs : [1,4096]. Décimal : le rapport entre le décalage horizontal et la hauteur de la résolution de sortie. Plage de valeurs : (0,1).	0
Dy	number	Valeur par défaut : 0. La signification diffère selon que la valeur est un entier ou un décimal : 0 (par défaut) : le décalage en pixels et le rapport entre le décalage vertical et la hauteur de la résolution de sortie sont tous deux de 0. Entier : le décalage en pixels (px). Plage de valeurs : [1,4096]. Décimal : le rapport entre le décalage vertical et la hauteur de la résolution de sortie. Plage de valeurs : (0,1).	0
Width	number	La largeur de la mosaïque. La valeur par défaut est le décimal 1.0, qui remplit toute la largeur de la vidéo de sortie. La signification diffère selon que la valeur est un entier ou un décimal : Entier : la valeur en pixels, en pixels (px). Plage de valeurs : [1,4096]. Décimal : le rapport par rapport à la largeur de la résolution vidéo de sortie. Plage de valeurs : (0,1).	100
Height	number	La hauteur de la mosaïque. La valeur par défaut est le décimal 1.0, qui remplit toute la hauteur de la vidéo de sortie. La signification diffère selon que la valeur est un entier ou un décimal : Entier : la valeur en pixels, en pixels (px). Plage de valeurs : [1,4096]. Décimal : le rapport par rapport à la hauteur de la résolution vidéo de sortie. Plage de valeurs : (0,1).	40
ReferPos	string	La position de référence pour l'ajout de la mosaïque. Valeurs valides : topleft (par défaut) : coin supérieur gauche topright : coin supérieur droit bottomright : coin inférieur droit bottomleft : coin inférieur gauche	topleft
Speed	number	Le paramètre de vitesse de lecture de la vidéo. Plage de valeurs : [0.5,1.0]. Valeur par défaut : 1.0. Remarque Il s'agit du rapport entre la vitesse de lecture du fichier multimédia transcodé et la vitesse de lecture par défaut du fichier multimédia source, et non d'un transcodage accéléré. Important Ce paramètre s'applique uniquement à l'API CreateMediaConvertTask.	1.0
Desensitization	object	La configuration de désensibilisation de la vidéo. Important Ce paramètre s'applique uniquement à l'API CreateMediaConvertTask.
Face	object	La configuration de désensibilisation des visages. Remarque Cette fonctionnalité est en préversion publique. Si vous avez des questions, rejoignez le groupe DingTalk pour nous faire part de vos commentaires. Pour le numéro du groupe DingTalk, consultez Nous contacter.
Confidence	number	Le seuil de confiance des visages, qui définit la limite inférieure de confiance pour la reconnaissance faciale. Si la valeur de confiance d'un visage détecté est inférieure à ce seuil, le visage n'est pas désensibilisé. Plage de valeurs : 0.0 à 1.0. Valeur par défaut : 0.0 (aucun filtrage de confiance n'est effectué).	0.4
MinSize	integer	Le seuil de taille minimale des visages, qui définit la taille minimale des visages à désensibiliser. Si la largeur ou la hauteur d'un visage détecté est inférieure à ce seuil, le visage n'est pas désensibilisé. Unité : pixels. Valeur par défaut : 0, ce qui indique aucune restriction sur la taille du visage.	0.4
ScaleRatio	number	Le rapport de mise à l'échelle de la zone de détection. Plage de valeurs : 0.1 à 5.0. Met à l'échelle la largeur et la hauteur de la zone de détection en fonction de son centre. • > 1.0 : agrandit la zone de flou. • < 1.0 : réduit la zone de flou. • = 1.0 : utilise la zone de détection d'origine.	1.0
BlurRadius	integer	Le rayon de flou. Plage de valeurs : 1 à 100. Une valeur plus élevée entraîne généralement une zone plus floue.	100
Transparency	number	La transparence et l'intensité de l'adoucissement des bords de la zone de flou. Plage de valeurs : 0.0 à 1.0. • 0.0 : affiche l'effet de flou complet. • 1.0 : aucun traitement de flou n'est effectué. Seule l'image d'origine est affichée. • 0.0 à 1.0 : une valeur plus élevée entraîne une proportion plus importante de l'image d'origine, un rayon de flou réel plus petit et généralement une plage d'adoucissement des bords plus grande.	0.0
LicensePlate	object	La configuration de désensibilisation des plaques d'immatriculation. Remarque Cette fonctionnalité est en préversion publique. Si vous avez des questions, rejoignez le groupe DingTalk pour nous faire part de vos commentaires. Pour le numéro du groupe DingTalk, consultez Nous contacter.
Confidence	number	Le seuil de confiance des plaques d'immatriculation, qui définit la limite inférieure de confiance pour la reconnaissance des plaques d'immatriculation. Si la valeur de confiance d'une plaque d'immatriculation détectée est inférieure à ce seuil, la plaque d'immatriculation n'est pas désensibilisée. Plage de valeurs : 0.0 à 1.0. Valeur par défaut : 0.0 (aucun filtrage de confiance n'est effectué).	0.4
MinSize	integer	Le seuil de taille minimale des plaques d'immatriculation, qui définit la taille minimale des plaques d'immatriculation à désensibiliser. Si la largeur ou la hauteur d'une plaque d'immatriculation détectée est inférieure à ce seuil, la plaque d'immatriculation n'est pas désensibilisée. Unité : pixels. Valeur par défaut : 0, ce qui indique aucune restriction sur la taille de la plaque d'immatriculation.	0.4
ScaleRatio	number	Le rapport de mise à l'échelle de la zone de détection. Plage de valeurs : 0.1 à 5.0. Met à l'échelle la largeur et la hauteur de la zone de détection en fonction de son centre. • > 1.0 : agrandit la zone de flou. • < 1.0 : réduit la zone de flou. • = 1.0 : utilise la zone de détection d'origine.	1.0
BlurRadius	integer	Le rayon de flou. Plage de valeurs : 1 à 100. Une valeur plus élevée entraîne généralement une zone plus floue.	100
Transparency	number	La transparence et l'intensité de l'adoucissement des bords de la zone de flou. Plage de valeurs : 0.0 à 1.0. • 0.0 : affiche l'effet de flou complet. • 1.0 : aucun traitement de flou n'est effectué. Seule l'image d'origine est affichée. • 0.0 à 1.0 : une valeur plus élevée entraîne une proportion plus importante de l'image d'origine, un rayon de flou réel plus petit et généralement une plage d'adoucissement des bords plus grande.	0.0

object

Les paramètres de traitement vidéo.

DisableVideo

boolean

Indique si la génération du flux vidéo doit être désactivée. Valeurs valides :

true : Désactivé. Le fichier de sortie ne contient pas de flux vidéo.
false (par défaut) : Non désactivé.

false

Stream

array

La liste des numéros d'index des flux vidéo à traiter à partir du fichier source. Une valeur vide (par défaut) indique que le flux vidéo avec le plus petit numéro d'index (le premier flux vidéo) est traité. Un numéro d'index supérieur à 100 indique que tous les flux vidéo sont traités.

Exemple : [0,1] traite les flux vidéo avec les numéros d'index 0 et 1. [1] traite le flux vidéo avec le numéro d'index 1. [101] traite tous les flux vidéo.

Remarque

Seuls les flux vidéo avec des numéros d'index existants sont traités. Si un flux vidéo correspondant à un numéro d'index n'existe pas, ce numéro d'index est ignoré.

integer

Le numéro d'index du flux vidéo à traiter.

0

TranscodeVideo

object

Les paramètres de transcodage vidéo. Une valeur vide indique que le traitement vidéo est désactivé et que le fichier de sortie ne contient pas de flux vidéo.

Remarque

Il n'est pas recommandé de définir ce paramètre sur une valeur vide pour désactiver le traitement vidéo.

Codec

string

Le format d'encodage vidéo. Valeurs valides :

Pour l'API CreateMediaConvert : copy (par défaut), h264, h265, vp9.
Avertissement Lorsque ce paramètre est défini sur copy, les flux vidéo à traiter sont directement copiés dans le fichier de sortie, et les autres paramètres sous TranscodeVideo ne prennent pas effet. copy ne peut pas être utilisé pour la concaténation vidéo et est généralement utilisé pour les scénarios de conversion de format de conteneur.
Pour l'API GenerateVideoPlaylist : h264 (par défaut), h265.

h264

PixelFormat

string

Le format de pixel. La valeur par défaut est identique à celle de la vidéo source. Valeurs valides :

yuv420p
yuv422p
yuv444p
yuv420p10le
yuv422p10le
yuv444p10le
yuva420p

Remarque

yuva420p n'est disponible que pour l'API CreateMediaConvert, et le paramètre Codec doit être défini sur vp9.

yuv420p

FrameRateOption

string

L'option de fréquence d'images. Valeurs valides :

fixed : Utilise toujours la fréquence d'images vidéo cible spécifiée.
adaptive : Utilise la fréquence d'images de la vidéo source lorsqu'elle est inférieure à la fréquence d'images vidéo cible spécifiée.
fall : Renvoie un échec lorsque la fréquence d'images de la vidéo source est inférieure à la fréquence d'images vidéo cible spécifiée.

Valeur par défaut :

Pour l'API CreateMediaConvert, la valeur par défaut est fixed.
Pour l'API GenerateVideoPlaylist, la valeur par défaut est adaptive.

Remarque

Ce paramètre doit être défini conjointement avec le paramètre FrameRate.

fixed

FrameRate

number

La fréquence d'images vidéo. La valeur par défaut est identique à celle de la vidéo source.

25

ResolutionOption

string

L'option de résolution. Valeurs valides :

fixed : Utilise toujours la résolution vidéo cible spécifiée.
adaptive : Utilise la résolution de la vidéo source lorsque la zone de résolution de la vidéo source est inférieure à la zone de résolution vidéo cible spécifiée.
fall : Renvoie un échec lorsque la zone de résolution de la vidéo source est inférieure à la zone de résolution vidéo cible spécifiée.

Valeur par défaut :

Pour l'API CreateMediaConvert, la valeur par défaut est fixed.
Pour l'API GenerateVideoPlaylist, la valeur par défaut est adaptive.

Remarque

Ce paramètre doit être défini conjointement avec le paramètre Resolution.

fixed

Resolution

string

La résolution de la vidéo de sortie au format largeurxhauteur. La valeur par défaut est identique à la résolution de lecture de la vidéo source. Vous pouvez spécifier à la fois la largeur et la hauteur, ou spécifier uniquement la largeur ou la hauteur. Vous pouvez également utiliser le paramètre AdaptiveResolutionDirection pour spécifier à la fois les côtés long et court, ou uniquement le côté long ou court. La plage de valeurs pour un seul côté est (0,4096].

Exemple 1 : Si AdaptiveResolutionDirection est false, 1280x720 définit la largeur sur 1280 et la hauteur sur 720. 1280x définit la largeur sur 1280 et conserve la hauteur identique à celle de la vidéo source. x720 définit la hauteur sur 720 et conserve la largeur identique à celle de la vidéo source.
Exemple 2 : Si AdaptiveResolutionDirection est true, 1280x720 définit le côté long sur 1280 et le côté court sur 720. 1280x définit le côté long sur 1280 et conserve le côté court identique à celui de la vidéo source. x720 définit le côté court sur 720 et conserve le côté long identique à celui de la vidéo source.

Remarque

Si la vidéo source contient des informations de rotation, la détermination de la largeur/hauteur et des côtés long/court est basée sur l'état après rotation, qui correspond à la résolution de lecture.

640x480

AdaptiveResolutionDirection

boolean

Indique si le mode adaptatif des côtés long/court doit être activé. Valeurs valides :

true : Activé. Le format du paramètre Resolution est côté long × côté court.
false (par défaut) : Désactivé. Le format du paramètre Resolution est largeur × hauteur.

true

ScaleType

string

Le mode de mise à l'échelle. Valeurs valides :

stretch (par défaut) : Largeur/hauteur ou côtés long/court fixes. Force la mise à l'échelle et étire pour remplir les zones vides.
crop : Mise à l'échelle proportionnelle. Met à l'échelle à la résolution minimale qui dépasse le rectangle de largeur/hauteur ou de côtés long/court spécifié, puis recadre l'excédent au centre.
fill : Mise à l'échelle proportionnelle. Met à l'échelle à la résolution maximale dans le rectangle de largeur/hauteur ou de côtés long/court spécifié, puis remplit les zones vides avec du noir en utilisant un alignement central.
fit : Mise à l'échelle proportionnelle. Met à l'échelle à la résolution maximale dans le rectangle de largeur/hauteur ou de côtés long/court spécifié.

Remarque

Ce paramètre doit être défini conjointement avec le paramètre Resolution.

crop

Rotation

integer

Le degré de rotation horaire de la vidéo. Valeurs valides :

0 (par défaut)
90
180
270

90

BitrateOption

string

L'option de débit binaire vidéo. Valeurs valides :

fixed : Utilise toujours le débit binaire vidéo cible spécifié.
adaptive : Utilise le débit binaire de la vidéo source lorsqu'il est inférieur au débit binaire vidéo cible spécifié.
fall : Renvoie un échec lorsque le débit binaire de la vidéo source est inférieur au débit binaire vidéo cible spécifié.

Valeur par défaut :

Pour l'API CreateMediaConvert, la valeur par défaut est fixed.
Pour l'API GenerateVideoPlaylist, la valeur par défaut est adaptive.

Remarque

Ce paramètre doit être défini conjointement avec le paramètre Bitrate.

fixed

Bitrate

integer

Le débit binaire du flux vidéo, en bits par seconde (bit/s).

Remarque

Ce paramètre est mutuellement exclusif avec CRF. Si ce paramètre et CRF sont tous deux vides, l'encodage est effectué avec une valeur CRF de 23.

128000

GOPSize

integer

Le nombre d'images entre les images clés. Valeur par défaut : 150.

Remarque

Ce paramètre n'est pas pris en charge pour l'API GenerateVideoPlaylist.

60

CRF

number

Spécifie le mode de qualité constante. Ce paramètre est mutuellement exclusif avec le paramètre Bitrate. La plage de valeurs est [0,51]. Une valeur plus élevée entraîne une qualité vidéo inférieure. La plage de valeurs recommandée est [18,38].

18

BufferSize

integer

La taille de la mémoire tampon de décodage pour le débit binaire variable, en bits par seconde (bps).

Remarque

Ce paramètre prend effet uniquement lorsqu'il est utilisé conjointement avec le paramètre CRF.

4000000

MaxBitrate

integer

La limite de débit binaire maximal pour le débit binaire variable. Lors de l'utilisation de ce paramètre, le paramètre BufferSize doit être spécifié.

Remarque

Ce paramètre prend effet uniquement lorsqu'il est utilisé conjointement avec le paramètre CRF.

128000

BFrames

integer

Le nombre d'images B consécutives. Valeur par défaut : 3.

3

Refs

integer

Le nombre d'images de référence. Valeur par défaut : 2.

2

VideoSlim

integer

Active le mode HD léger. Valeurs valides :

0 : Valeur par défaut. Désactivé.

1 : Utilise le mode HD léger pour le transcodage.

Remarque

Pour des résultats optimaux, utilisez les paramètres Bitrate ou CRF officiellement recommandés pour l'encodage de transcodage vidéo avec le mode HD léger.

Important Le mode HD léger prend uniquement en charge les formats h.264/h.265, uniquement yuv420p, une profondeur de 8 bits, et ne prend pas en charge la sortie de transcodage vidéo multi-cible ni la concaténation vidéo. Pour plus d'informations, consultez Présentation du produit HD léger.

0

FilterVideo

object

Les paramètres de traitement vidéo. Ce paramètre ne prend pas effet lorsque le paramètre TranscodeVideo est vide ou lorsque TranscodeVideo.Codec est défini sur copy.

Remarque

Ce paramètre n'est pas pris en charge pour l'API GenerateVideoPlaylist.

Watermarks

array

La liste des filigranes vidéo.

object

Les informations sur le filigrane vidéo.

Type

string

Le type de filigrane. Valeurs valides :

text (par défaut) : filigrane textuel.
file : filigrane d'image ou d'image animée.

text

Dx

number

La signification diffère selon que la valeur est un entier ou un décimal :

0 (par défaut) : le décalage en pixels et le rapport entre le décalage horizontal et la hauteur de la résolution de sortie sont tous deux de 0.
Entier : le décalage en pixels (px). Plage de valeurs : [1,4096].
Décimal : le rapport entre le décalage horizontal et la hauteur de la résolution de sortie. Plage de valeurs : (0,1).

0

Dy

number

La signification diffère selon que la valeur est un entier ou un décimal :

0 (par défaut) : le décalage en pixels et le rapport entre le décalage vertical et la hauteur de la résolution de sortie sont tous deux de 0.
Entier : le décalage en pixels (px). Plage de valeurs : [1,4096].
Décimal : le rapport entre le décalage vertical et la hauteur de la résolution de sortie. Plage de valeurs : (0,1).

0

StartTime

number

L'heure de début pour l'ajout du filigrane, en secondes (s). La valeur par défaut est l'heure de début de la vidéo.

0

Duration

number

La durée d'affichage du filigrane, en secondes (s). La valeur par défaut s'étend jusqu'à la fin de la vidéo.

0

ReferPos

string

La position de référence pour l'ajout du filigrane. Valeurs valides :

topleft (par défaut) : coin supérieur gauche
topright : coin supérieur droit
bottomright : coin inférieur droit
bottomleft : coin inférieur gauche

topleft

Content

string

Le contenu du filigrane textuel. La valeur par défaut est vide.