Intelligent Media Services:Configuration des timelines

Paramètre

Type

Obligatoire

Description

VideoTracks

VideoTrack[]

Non (en l'absence de pistes vidéo, des pistes audio sont requises).

Pistes vidéo. Elles se superposent selon l'ordre des éléments du tableau MediaId. Par exemple, la piste correspondant au premier élément du tableau MediaId est placée sous celle correspondant au deuxième élément.

AudioTracks

AudioTrack[]

Non (en l'absence de pistes audio, des pistes vidéo sont requises).

Pistes audio.

ImageTracks (la fonctionnalité de piste d'images est fusionnée avec celle des pistes vidéo ; elle n'est plus mise à jour ni maintenue).

ImageTrack[]

Non (si des pistes d'images existent, des pistes vidéo sont requises).

Pistes d'images. Remarques :

1. Les pistes d'images doivent être placées au-dessus des pistes vidéo. Pour mixer une image avec une vidéo dans des scénarios de production combinée, utilisez des pistes vidéo.

2. Les pistes d'images se superposent selon l'ordre des éléments du tableau MediaId. Par exemple, la piste correspondant au premier élément du tableau MediaId est placée sous celle correspondant au deuxième élément.

SubtitleTracks

SubtitleTrack[]

Non

Pistes de sous-titres.

EffectTracks

EffectTrack[]

Non

Pistes d'effets.

Paramètre

Type

Obligatoire

Description

Type

String

Non

Type de la piste vidéo. Par défaut, il s'agit d'une piste vidéo standard.

Si vous définissez Type sur Effect, la piste vidéo peut servir aux effets. Dans ce cas, spécifiez des objets EffectTrackItem dans VideoTrackClips.

MainTrack

Boolean

Non

Indique si la piste vidéo actuelle est la piste principale. Valeur par défaut : False. Pour plus d'informations, consultez Définir une piste principale.

TrackShortenMode

String

Non

Lorsque la durée de la piste vidéo actuelle dépasse celle de la piste principale, elle est automatiquement réduite pour s'aligner sur cette dernière. Ce paramètre définit le mode de raccourcissement. Valeur valide :

• AutoSpeed : la vidéo est automatiquement accélérée.

TrackExpandMode

String

Non

Lorsque la durée de la piste vidéo actuelle est inférieure à celle de la piste principale, elle est automatiquement étendue pour s'aligner sur cette dernière. Ce paramètre définit le mode d'extension. Valeur valide :

• AutoSpeed : la vidéo est automatiquement ralentie.

VideoTrackClips

VideoTrackClip[]

Oui

Médias contenus dans la piste vidéo.

Paramètre

Type

Obligatoire

Description

MainTrack

Boolean

Non

Indique si la piste audio actuelle est la piste principale. Valeur par défaut : False. Pour plus d'informations, consultez Définir une piste principale.

TrackShortenMode

String

Non

Lorsque la durée de la piste audio actuelle dépasse celle de la piste principale, elle est automatiquement réduite pour s'aligner sur cette dernière. Ce paramètre définit le mode de raccourcissement. Valeur valide :

• AutoSpeed : l'audio est automatiquement accéléré.

TrackExpandMode

String

Non

Lorsque la durée de la piste audio actuelle est inférieure à celle de la piste principale, elle est automatiquement étendue pour s'aligner sur cette dernière. Ce paramètre définit le mode d'extension. Valeur valide :

• AutoSpeed : l'audio est automatiquement ralenti.

AudioTrackClips

AudioTrackClip[]

Oui

Médias contenus dans la piste audio.

Paramètre

Type

Obligatoire

Description

ImageTrackClips (la fonctionnalité de piste d'images est fusionnée avec celle des pistes vidéo ; elle n'est plus mise à jour ni maintenue).

ImageTrackClip[]

Oui

Médias contenus dans la piste d'images.

Paramètre

Type

Obligatoire

Description

SubtitleTrackClips

SubtitleTrackClip[]

Oui

Médias contenus dans la piste de sous-titres.

Paramètre

Type

Obligatoire

Description

Remarques

Type

String

Oui

Type du média.

• Définissez la valeur sur AI_Avatar.

MediaId

String

Non

ID du fichier audio utilisé pour le rendu de l'humain numérique.

• Spécifiez un seul des paramètres suivants : MediaId, MediaURL ou Content.

MediaURL

String

Non

URL du fichier audio utilisé pour le rendu de l'humain numérique.

• Spécifiez un seul des paramètres suivants : MediaId, MediaURL ou Content.

• Ce paramètre accepte une URL OSS publique ou toute URL publique accessible via Internet.

Content

String

Non

Contenu textuel utilisé pour le rendu de l'humain numérique.

• Spécifiez un seul des paramètres suivants : MediaId, MediaURL ou Content.

• Ce paramètre doit contenir au moins cinq caractères.

AvatarId

String

Non

ID de l'image de l'humain numérique.

• Pour plus d'informations, consultez https://icms.alibaba-inc.com/content/ice/ims?l=1&m=65087&n=4147232.

Voice

String

Non

Type de voix.

• Ce paramètre s'applique lorsque Content est spécifié.

• Pour les effets vocaux, consultez Démonstrations de voix intelligentes.

CustomizedVoice

String

Non

Voix humaine personnalisée.

• Spécifiez l'ID de la voix entraînée via la fonctionnalité de clonage vocal pour générer un audio avec votre propre voix personnalisée.

• Si ce paramètre est défini, Voice est ignoré.

LoopMotion

Boolean

Non

Indique si la première et la dernière image de la vidéo sont identiques.

• Si ce paramètre est défini sur true, la première et la dernière image de la vidéo générée pour l'humain numérique sont identiques. Cela évite les sauts d'images dans les mouvements et expressions lors d'une lecture en boucle ou de la fusion de vidéos d'humains numériques.

• Valeurs valides : true et false.

• Valeur par défaut : false.

SpeechRate

Integer

Non

Cadence de parole.

• Ce paramètre s'applique lorsque Content est spécifié. Valeurs valides : de -500 à 500. Valeur par défaut : 0.

  • Une valeur de -500 correspond à une cadence multipliée par 0,5. Une valeur de 0 conserve la cadence d'origine. Une valeur de 500 correspond à une cadence doublée.

PitchRate

Integer

Non

Intonation.

• Ce paramètre s'applique lorsque Content est spécifié.

• Valeurs valides : de -500 à 500.

• Valeur par défaut : 0.

Paramètre

Type

Obligatoire

Description

MediaId

String

Non

ID de la ressource multimédia IMS ou ApsaraVideo VOD correspondant à la ressource de la piste image.

Remarque : Vous devez spécifier soit MediaId, soit MediaURL, mais pas les deux.

MediaURL

String

Non

URL OSS de la ressource de la piste image. Cette URL OSS respecte le format suivant : https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4.

Remarque :

• Vous devez spécifier soit MediaId, soit MediaURL, mais pas les deux.

• Seule une URL OSS publique est acceptée pour ce paramètre.

Pour plus d'informations, consultez Modification de la vitesse audio et vidéo.

X

Float

Non

Distance horizontale entre le coin supérieur gauche de la ressource et celui de la vidéo de sortie. Cette valeur peut s'exprimer en pourcentage ou en pixels. Une valeur comprise entre 0 et 0,9999 représente un pourcentage, tandis qu'un entier supérieur ou égal à 2 indique un nombre de pixels.

Y

Float

Non

Distance verticale entre le coin supérieur gauche de la ressource et celui de la vidéo de sortie. Cette valeur peut s'exprimer en pourcentage ou en pixels. Une valeur comprise entre 0 et 0,9999 représente un pourcentage, tandis qu'un entier supérieur ou égal à 2 indique un nombre de pixels.

Width

Float

Non

Largeur de la ressource dans la vidéo de sortie. Cette valeur peut s'exprimer en pourcentage ou en pixels. Une valeur comprise entre 0 et 0,9999 représente un pourcentage, tandis qu'un entier supérieur ou égal à 2 indique un nombre de pixels.

Height

Float

Non

Hauteur de la ressource dans la vidéo de sortie. Cette valeur peut s'exprimer en pourcentage ou en pixels. Une valeur comprise entre 0 et 0,9999 représente un pourcentage, tandis qu'un entier supérieur ou égal à 2 indique un nombre de pixels.

TimelineIn

Float

Non

Instant de début de l'image dans la timeline. Unité : secondes. La valeur est précise à quatre décimales près. En l'absence de spécification, la valeur 0 est appliquée par défaut.

TimelineOut

Float

Non

Instant de fin de l'image dans la timeline. Unité : secondes. La valeur est précise à quatre décimales près. Si TimelineOut n'est pas défini, la durée maximale de la piste vidéo est utilisée.

DyncFrames

Int

Non

Nombre d'images de l'autocollant animé. Ce paramètre est requis lorsque le fichier source est une image animée. Pour plus d'informations, consultez Ajout de filigranes, d'autocollants ou d'autocollants GIF.

Effects

Effect[]

Non

Effets appliqués à la ressource.

Paramètre

Type

Obligatoire

Description

Type

String

Oui

Type de la ressource de sous-titres. Valeurs valides :

• Subtitle : un fichier de sous-titres externe

• Text : texte en bannière

SubType

String

Non

Sous-type de la ressource de sous-titres. Valeurs valides :

• srt : fichier de sous-titres externe au format SubRip Subtitle (SRT)

• ass : fichier de sous-titres externe au format Advanced SubStation Alpha (ASS)

Ignorez ce paramètre si vous définissez Type sur Text.

FileURL

String

Non

URL OSS du fichier de sous-titres. Ce paramètre est requis si vous définissez Type sur Subtitle. L'URL OSS respecte le format suivant :

https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.srt.

Remarque :

• Vous pouvez spécifier une URL OSS publique ou toute URL publique accessible via Internet pour ce paramètre.

Pour plus d'informations, consultez Sous-titres et modèles de sous-titres.

X

Float

Non

Distance horizontale entre le coin supérieur gauche du texte en bannière et le coin supérieur gauche de la vidéo de sortie. Ce paramètre s'applique uniquement si Type est défini sur Text. La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise entre 0 et 0,9999 correspond à un pourcentage. Un entier supérieur ou égal à 2 correspond à un nombre de pixels.

Y

Float

Non

Distance verticale entre le coin supérieur gauche du texte en bannière et le coin supérieur gauche de la vidéo de sortie. Ce paramètre s'applique uniquement si Type est défini sur Text. La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise entre 0 et 0,9999 correspond à un pourcentage. Un entier supérieur ou égal à 2 correspond à un nombre de pixels.

TimelineIn

Float

Non

Instant de début du texte en bannière dans la timeline. Ce paramètre s'applique uniquement si Type est défini sur Text. Unité : secondes. La valeur est précise à quatre décimales près. En l'absence de spécification de TimelineIn, la ressource s'affiche dès la fin de l'affichage de la ressource précédente dans la timeline.

TimelineOut

Float

Non

Instant de fin du texte en bannière dans la timeline. Ce paramètre s'applique uniquement si Type est défini sur Text. Unité : secondes. La valeur est précise à quatre décimales près. En l'absence de spécification de TimelineOut, la ressource cesse de s'afficher au moment où la ressource suivante commence à apparaître dans la timeline.

ClipId

Float

Non

Ce paramètre sert à aligner les pistes. Si le ReferenceClipId d'une ressource située sur une autre piste possède la même valeur, les instants de début et de fin de cette ressource s'alignent sur le clip actuel.

Si vous spécifiez ce paramètre, vous devez également définir TimelineIn et TimelineOut pour le clip actuel, ou bien activer la durée de défilement adaptatif.

ReferenceClipId

String

Non

Ce paramètre permet d'aligner les pistes. Si le ClipId d'une ressource située sur une autre piste possède la même valeur, les instants de début et de fin du clip actuel s'alignent sur cette ressource.

Content

String

Non

Contenu du texte en bannière. Ce paramètre est obligatoire si vous définissez Type sur Text.

Font

String

Non

Police du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Valeur par défaut : SimSun. Pour plus d'informations sur les polices prises en charge, consultez Liste des polices.

FontSize

Int

Non

Taille de police du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Valeur par défaut : 0. Valeur maximale : 5000.

SizeRequestType

String

Non

Méthode de calcul de la taille de la police rendue pour le texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Valeur par défaut : RealDim.

• Nominal : la hauteur de rendu des sous-titres (en pixels) est égale à la taille de la police.

• RealDim : pour certaines polices, la hauteur de rendu des sous-titres (en pixels) peut être inférieure à la taille de la police.

FontColor

String

Non

Couleur du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. La valeur suit le format d'un croisillon (#) suivi d'une valeur hexadécimale. Exemple : #ffffff.

FontColorOpacity

Float

Non

Opacité du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Valeurs valides : de 0 à 1. Valeur par défaut : 1. Une valeur de 1 indique une opacité totale. Une valeur de 0 indique une transparence totale.

FontFace

FontFace

Non

Apparence du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text.

Spacing

Int

Non

Espacement des mots du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Unité : pixel. Valeur par défaut : 0.

LineSpacing

Int

Non

Interligne du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Unité : pixel. Valeur par défaut : 0.

Angle

Float

Non

Angle de rotation du texte en bannière dans le sens antihoraire. Ce paramètre s'applique uniquement si Type est défini sur Text. Unité : degré. Valeur par défaut : 0.

BorderStyle

Int

Non

Style de bordure du texte en bannière. Valeurs valides : 1 et 3. La valeur 1 applique une bordure et une ombre au texte. La valeur 3 applique un arrière-plan au texte. Valeur par défaut : 1.

Outline

Int

Non

Largeur du contour du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Unité : pixel. Valeur par défaut : 0.

OutlineColour

String

Non

Couleur du contour du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. La valeur suit le format d'un croisillon (#) suivi d'une valeur hexadécimale. Exemple : #ffffff.

Shadow

Int

Non

Taille de l'ombre du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Unité : pixel. Valeur par défaut : 0.

BackColour

String

Non

Couleur de l'ombre du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. La valeur suit le format d'un croisillon (#) suivi d'une valeur hexadécimale. Exemple : #ffffff.

Alignment

String

Non

Mode d'alignement du texte. Ce paramètre s'applique uniquement si Type est défini sur Text. Valeur par défaut : TopLeft. Valeurs valides :

• TopLeft

• TopCenter

• TopRight

• CenterLeft

• CenterCenter

• CenterRight

• BottomLeft

• BottomCenter

• BottomRight

Pour positionner précisément les sous-titres selon les différents modes d'alignement, nous vous recommandons de configurer l'alignement du texte comme suit :

• Alignement à gauche : spécifiez dans X et Y les coordonnées du sommet supérieur gauche du sous-titre par rapport au coin supérieur gauche de la vidéo.

• Alignement centré : spécifiez dans X et Y les coordonnées de l'intersection des limites sur l'axe central du sous-titre par rapport au coin supérieur gauche de la vidéo.

• Alignement à droite : spécifiez dans X et Y les coordonnées du sommet supérieur droit du sous-titre par rapport au coin supérieur gauche de la vidéo.

AdaptMode

String

Non

Détermine s'il faut activer le retour à la ligne automatique ou la mise à l'échelle automatique lorsque le texte en bannière dépasse la largeur de la vidéo ou la largeur de la zone de texte spécifiée. Valeurs valides :

• AutoWrap : active le retour à la ligne automatique.

• AutoScale : active la mise à l'échelle automatique.

• AutoWrapAtSpaces : active le retour à la ligne automatique en effectuant les coupures uniquement au niveau des espaces. Cette option s'applique exclusivement aux textes en anglais.

• AutoWrapAtSpacesStrict : impose un retour à la ligne strict basé sur les caractères d'espace. Si un mot dépasse les limites du conteneur, il passe intégralement à la ligne suivante au lieu d'être coupé.

TextWidth

Float

Non

Largeur de la zone de texte. Ce paramètre s'applique uniquement si AdaptMode est spécifié. Il intervient lors de l'activation du retour à la ligne automatique ou de la mise à l'échelle automatique. En l'absence de ce paramètre, la largeur de la vidéo sert de référence pour ces ajustements. Une valeur supérieure à 0 et inférieure ou égale à 1 représente le pourcentage de la largeur de la zone de texte par rapport à la largeur de la vidéo de sortie. Une valeur supérieure à 1 correspond à un nombre de pixels.

FontUrl

String

Non

URL OSS du fichier de police. Ce paramètre s'applique uniquement si Type est défini sur Text. Formats de fichiers de police pris en charge : TTF, OTF et WOFF. Exemple : https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf.

EffectColorStyle

String

Non

Effet WordArt du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Pour plus d'informations sur les effets WordArt, consultez WordArt.

SubtitleEffects

SubtitleEffect[]

Non

Effets multicouches du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Vous pouvez configurer des contours multicouches, des ombres multicouches, des flous gaussiens et des effets d'arrière-plan de sous-titres. Les flous gaussiens ne sont pris en charge que si le texte des sous-titres possède une ombre.

Remarque :

• Si vous spécifiez SubtitleEffects, les paramètres Outline et Shadow de SubtitleTrackClip deviennent inopérants.

• Lors de la configuration de contours multicouches, d'ombres multicouches ou d'effets d'arrière-plan, les effets de sous-titres se superposent selon l'ordre des éléments du tableau SubtitleEffects. La couche correspondant au premier effet du tableau se place en bas, tandis que celle correspondant au dernier effet se place au sommet.

ScrollStartY

Float

Non

Coordonnée Y du point de départ pour le défilement vertical (vers le haut ou le bas) du sous-titre. Ce paramètre s'applique uniquement si l'effet de défilement des sous-titres est configuré. Unité : pixel. Une valeur inférieure à 1 représente une mesure relative par rapport à la hauteur de la vidéo de sortie.

ScrollEndY

Float

Non

Coordonnée Y du point d'arrivée pour le défilement vertical (vers le haut ou le bas) du sous-titre. Ce paramètre s'applique uniquement si l'effet de défilement des sous-titres est configuré. Unité : pixel. Une valeur inférieure à 1 représente une mesure relative par rapport à la hauteur de la vidéo de sortie.

ScrollSpeed

Float

Non

Vitesse de défilement vertical (vers le haut ou le bas) du sous-titre. Ce paramètre s'applique uniquement si l'effet de défilement des sous-titres est configuré. Unité : pixel par seconde.

ScrollStartShift

Float

Non

Décalage de la position de défilement vertical par rapport au point de départ. Unité : pixel. Une valeur inférieure à 1 représente une mesure relative par rapport à la hauteur de la vidéo de sortie.

ScrollEndShift

Float

Non

Décalage de la position de défilement vertical par rapport au point d'arrivée. Unité : pixel. Une valeur inférieure à 1 représente une mesure relative par rapport à la hauteur de la vidéo de sortie.

ScrollStartFreeze

Float

Non

Durée de pause au point de départ du défilement vertical. Unité : secondes.

ScrollEndFreeze

Float

Non

Durée de pause au point d'arrivée du défilement vertical. Unité : secondes.

ScrollDirection

String

Non

Direction du défilement horizontal. Valeurs valides :

• Left

• Right

ScrollStartX

Float

Non

Coordonnée X du point de départ pour le défilement horizontal. Unité : pixel. Une valeur inférieure à 1 représente une mesure relative par rapport à la hauteur de la vidéo de sortie.

ScrollEndX

Float

Non

Coordonnée X du point d'arrivée pour le défilement horizontal. Unité : pixel. Une valeur inférieure à 1 représente une mesure relative par rapport à la hauteur de la vidéo de sortie.

ScrollLoop

Boolean

Non

Indique si l'effet de défilement horizontal doit être lu en boucle.

AaiMotionInEffect

String

Non

Effet d'entrée du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Pour plus d'informations sur les effets d'entrée des sous-titres, consultez Exemples d'effets de sous-titres.

AaiMotionIn

Float

Non

Durée de l'effet d'entrée du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Unité : secondes. La valeur est précise à quatre décimales près. En l'absence de spécification de AaiMotionIn, la durée par défaut est de 0,5 seconde. Si le texte reste affiché moins de 0,5 seconde, la durée de l'effet d'entrée correspond à la durée totale d'affichage du texte diminuée de la durée de l'effet de sortie.

AaiMotionOutEffect

String

Non

Effet de sortie du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Pour plus d'informations sur les effets de sortie des sous-titres, consultez Exemples d'effets de sous-titres.

AaiMotionOut

Float

Non

Durée de l'effet de sortie du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Unité : secondes. La valeur est précise à quatre décimales près. En l'absence de spécification de AaiMotionOut, la durée par défaut est de 0,5 seconde. Si le texte reste affiché moins de 0,5 seconde, la durée de l'effet de sortie correspond à la durée totale d'affichage du texte.

AaiMotionLoopEffect

String

Non

Effet de boucle du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. L'effet de boucle ne peut pas fonctionner simultanément avec l'effet d'entrée ou l'effet de sortie. Pour plus d'informations sur les effets de boucle du texte, consultez Exemples d'effets de sous-titres.

Ratio

Float

Non

Vitesse de l'effet de boucle du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. La valeur est précise à quatre décimales près. En l'absence de spécification, la valeur 1 est utilisée. Une valeur supérieure à 1 accélère l'effet, tandis qu'une valeur inférieure à 1 le ralentit.

TextureURL

String

Non

URL de la texture du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Seuls les objets OSS aux formats PNG, JPG, JPEG ou BMP sont pris en charge. Exemple : https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png.

BubbleStyleId

String

Non

ID de l'effet de bulle du texte en bannière. Ce paramètre s'applique uniquement si Type est défini sur Text. Pour plus d'informations sur les effets de bulle, consultez Exemples d'effets de bulles de texte.

BubbleWidth

Float

Non

Largeur de la carte de base de la bulle par rapport à la vidéo de sortie. Ce paramètre s'applique uniquement aux sous-titres en bulle. Une valeur supérieure à 1 correspond à un nombre de pixels. Une valeur inférieure ou égale à 1 correspond à un pourcentage.

BubbleHeight

Float

Non

Hauteur de la carte de base de la bulle par rapport à la vidéo de sortie. Ce paramètre s'applique uniquement aux sous-titres en bulle. Une valeur supérieure à 1 correspond à un nombre de pixels. Une valeur inférieure ou égale à 1 correspond à un pourcentage.

Paramètre

Type

Obligatoire

Description

Type

String

Oui

Type de l'effet. Valeurs valides : VFX et Filter.

SubType

String

Oui

Sous-type de l'effet.

TimelineIn

Float

Non

Instant de début de l'effet dans la timeline. Unité : secondes. La valeur est précise à quatre décimales près. En l'absence de spécification de TimelineIn, la valeur 0 est utilisée.

TimelineOut

Float

Non

Instant de fin de l'effet dans la timeline. Unité : secondes. La valeur est précise à quatre décimales près. En l'absence de spécification de TimelineOut, l'effet se termine en même temps que la vidéo.

Duration

Float

Non

Durée de l'effet dans la timeline. Unité : secondes. La valeur est précise à quatre décimales près. En l'absence de spécification de Duration, la durée de la vidéo est utilisée.

Vous ne pouvez pas spécifier Duration et TimelineOut simultanément.

X

Float

Non

Ce paramètre s'applique uniquement si SubType est défini sur mosaic_rect/blur. Distance horizontale entre le coin supérieur gauche de la zone d'effet et le coin supérieur gauche de la vidéo de sortie.

La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise entre 0 et 0,9999 correspond à un pourcentage. Un entier supérieur ou égal à 2 correspond à un nombre de pixels.

Y

Float

Non

Ce paramètre s'applique uniquement si SubType est défini sur mosaic_rect/blur.

Distance verticale entre le coin supérieur gauche de la zone d'effet et le coin supérieur gauche de la vidéo de sortie. La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise entre 0 et 0,9999 correspond à un pourcentage. Un entier supérieur ou égal à 2 correspond à un nombre de pixels.

Width

Float

Non

Ce paramètre s'applique uniquement si SubType est défini sur mosaic_rect/blur. Largeur de la zone d'effet dans la vidéo de sortie. La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise entre 0 et 0,9999 correspond à un pourcentage. Un entier supérieur ou égal à 2 correspond à un nombre de pixels.

Height

Float

Non

Ce paramètre s'applique uniquement si SubType est défini sur mosaic_rect/blur. Hauteur de la zone d'effet dans la vidéo de sortie. La valeur peut être exprimée en pourcentage ou en pixels. Une valeur comprise entre 0 et 0,9999 correspond à un pourcentage. Un entier supérieur ou égal à 2 correspond à un nombre de pixels.

Paramètre

Type

Obligatoire

Description

Type

String

Oui

Type d'effet. Valeurs valides : Outline, Shadow et Box.

Bord

Float

Non

Largeur ou hauteur du contour ou de l'ombre. Une valeur supérieure à 1 correspond à un nombre de pixels. Une valeur comprise entre 0 et 1 indique une dimension relative à la taille du texte.

XBord

Float

Non

Largeur du contour ou de l'ombre. Une valeur supérieure à 1 correspond à un nombre de pixels. Une valeur comprise entre 0 et 1 indique une largeur relative à la taille du texte. Ce paramètre est prioritaire sur Bord.

YBord

Float

Non

Hauteur du contour ou de l'ombre. Une valeur supérieure à 1 correspond à un nombre de pixels. Une valeur comprise entre 0 et 1 indique une hauteur relative à la taille du texte. Ce paramètre est prioritaire sur Bord.

Shift

Float

Non

Décalage horizontal ou vertical du contour ou de l'ombre. Une valeur absolue supérieure à 1 correspond à un nombre de pixels. Une valeur absolue comprise entre 0 et 1 indique un décalage relatif à la taille du texte. Vous pouvez définir ce paramètre sur un nombre négatif pour appliquer un décalage vers le haut ou vers la gauche.

XShift

Float

Non

Décalage horizontal du contour ou de l'ombre. Une valeur absolue supérieure à 1 correspond à un nombre de pixels. Une valeur absolue comprise entre 0 et 1 indique un décalage horizontal relatif à la taille du texte. Ce paramètre est prioritaire sur Shift.

YShift

Float

Non

Décalage vertical du contour ou de l'ombre. Une valeur absolue supérieure à 1 correspond à un nombre de pixels. Une valeur absolue comprise entre 0 et 1 indique un décalage vertical relatif à la taille du texte. Ce paramètre est prioritaire sur Shift.

Color

String

Non

Couleur RGB. La valeur suit le format d'un dièse (#) suivi d'une valeur hexadécimale. Exemple : #ffffff.

Opacity

String

Non

Opacité du sous-titre. Une valeur de 1 rend le sous-titre totalement opaque, tandis qu'une valeur de 0 le rend complètement transparent.

Blur

Float

Non

Plage de flou gaussien en pixels. Ce paramètre n'est pris en compte que si Type est défini sur Shadow. Une fois configuré, il applique un effet lumineux au contour du sous-titre.

Radius

Float

Non

Rayon des coins de l'arrière-plan uni du texte. Ce paramètre s'applique uniquement lorsque Type est défini sur Box. Il permet d'arrondir les angles de l'arrière-plan du sous-titre après configuration.

ImageUrl

String

Non

URL de l'image d'arrière-plan personnalisée du sous-titre. Ce paramètre n'est effectif que si Type est défini sur Box. Il permet de créer un effet de bulle personnalisé. Utilisez BubbleWidth ou BubbleHeight pour modifier la taille du sous-titre. Seuls les objets OSS aux formats PNG, JPG, JPEG ou BMP sont pris en charge. Exemple : https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png.

Width

Float

Non

Largeur de l'image source de la bulle. Ce paramètre est requis pour l'utilisation de sous-titres en bulle personnalisés.

Height

Float

Non

Hauteur de l'image source de la bulle. Ce paramètre est requis pour l'utilisation de sous-titres en bulle personnalisés.

TextArea

String

Non

Zone de texte dans l'image source de la bulle. Ce paramètre est obligatoire pour les sous-titres en bulle personnalisés. Il se compose de quatre nombres à virgule flottante séparés par des virgules (,), dont les valeurs sont comprises entre 0 et 1. Par exemple, avec la valeur 0.1,0.2,0.8,0.6, les coordonnées du coin supérieur gauche de la zone de texte par rapport à la bulle sont 0.1 et 0.2, tandis que sa largeur et sa hauteur relatives correspondent respectivement à 0.8 et 0.6.

Paramètre

Type

Obligatoire

Description

Bold

Boolean

Non

Indique si la police est en gras.

Italic

Boolean

Non

Indique si la police est en italique.

Underline

Boolean

Non

Indique si la police est soulignée.

Paramètre

Type

Obligatoire

Description

Type

String

Oui

Type d'effet. Valeurs valides :

• Text : ajoute une bannière textuelle à un média situé sur une piste vidéo.

• DeWatermark : floute le filigrane d'un média sur une piste vidéo.

• Crop : recadre un média présent dans une piste vidéo.

• Pad : ajoute des marges autour d'un média dans une piste vidéo.

• Scale : redimensionne un élément d'une piste vidéo.

• Transition : applique un effet de transition à un média d'une piste vidéo.

• VFX : intègre un effet visuel à un contenu vidéo.

• Volume : ajuste le niveau sonore d'un média sur une piste audio.

• AFade : configure les fondus d'entrée et de sortie audio pour un média d'une piste audio.

• AI_ASR : génère automatiquement des sous-titres à partir de la bande son d'une piste audio ou vidéo.

SubType

String

Non

Sous-type de l'effet.

• Lorsque Type est défini sur Transition, ce paramètre précise le sous-type de l'effet de transition.

• Si Type est défini sur VFX, ce paramètre détermine le sous-type de l'effet visuel.

• Quand Type est défini sur Filter, ce paramètre spécifie le sous-type du filtre. Pour plus d'informations, consultez Exemples de filtres.