Intelligent Media Services:Configurations de la timeline

Paramètre

Type

Obligatoire

Description

VideoTracks

VideoTrack[]

Non (si aucune piste vidéo n'existe, des pistes audio sont requises.)

Les pistes vidéo. Les pistes vidéo sont superposées 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 la piste correspondant au deuxième élément.

AudioTracks

AudioTrack[]

Non (si aucune piste audio n'existe, des pistes vidéo sont requises.)

Les pistes audio.

ImageTracks (La fonctionnalité de piste d'image est fusionnée avec celle de piste vidéo et n'est plus mise à jour ni maintenue.)

ImageTrack[]

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

Les pistes d'image. Remarques :

1. Les pistes d'image doivent être placées au-dessus des pistes vidéo. Si une image doit être combinée à une vidéo en tant que ressource dans des scénarios de production vidéo et image, utilisez les pistes vidéo.

2. Les pistes d'image sont superposées 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 la piste correspondant au deuxième élément.

SubtitleTracks

SubtitleTrack[]

Non

Les pistes de sous-titres.

EffectTracks

EffectTrack[]

Non

Les pistes d'effets.

Paramètre

Type

Obligatoire

Description

Type

String

Non

Le type de la piste vidéo. Par défaut, une piste vidéo standard est utilisée.

Si vous définissez Type sur Effect, la piste vidéo peut être utilisée pour les effets. Dans ce cas, vous pouvez spécifier 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 la section Définir une piste principale.

TrackShortenMode

String

Non

Si la durée de la piste vidéo actuelle est supérieure à celle de la piste principale, la durée de la piste actuelle est raccourcie de manière adaptative pour s'aligner sur celle de la piste principale. Ce paramètre spécifie le mode de raccourcissement de la piste. Valeur valide :

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

TrackExpandMode

String

Non

Si la durée de la piste vidéo actuelle est inférieure à celle de la piste principale, la durée de la piste actuelle est étendue de manière adaptative pour s'aligner sur celle de la piste principale. Ce paramètre spécifie le mode d'extension de la piste. Valeur valide :

• AutoSpeed : la vidéo est automatiquement ralentie.

VideoTrackClips

VideoTrackClip[]

Oui

Les ressources de 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 la section Définir une piste principale.

TrackShortenMode

String

Non

Si la durée de la piste audio actuelle est supérieure à celle de la piste principale, la durée de la piste actuelle est raccourcie de manière adaptative pour s'aligner sur celle de la piste principale. Ce paramètre spécifie le mode de raccourcissement de la piste. Valeur valide :

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

TrackExpandMode

String

Non

Si la durée de la piste audio actuelle est inférieure à celle de la piste principale, la durée de la piste actuelle est étendue de manière adaptative pour s'aligner sur celle de la piste principale. Ce paramètre spécifie le mode d'extension de la piste. Valeur valide :

• AutoSpeed : l'audio est automatiquement ralenti.

AudioTrackClips

AudioTrackClip[]

Oui

Les ressources de la piste audio.

Paramètre

Type

Obligatoire

Description

ImageTrackClips (La fonctionnalité de piste d'image est fusionnée avec celle de piste vidéo et n'est plus mise à jour ni maintenue.)

ImageTrackClip[]

Oui

Les ressources de la piste d'image.

Parameter

Type

Required

Description

SubtitleTrackClips

SubtitleTrackClip[]

Yes

Les ressources de la piste de sous-titres.

Paramètre

Type

Obligatoire

Description

Remarques

Type

String

Oui

Le type de la ressource.

• Définissez la valeur sur AI_Avatar.

MediaId

String

Non

L'ID de l'audio utilisé pour le rendu d'un avatar numérique.

• Vous devez spécifier un seul des paramètres MediaId, MediaURL et Content.

MediaURL

String

Non

L'URL du fichier audio utilisé pour le rendu d'un avatar numérique.

• Vous devez spécifier un seul des paramètres MediaId, MediaURL et Content.

• Pour ce paramètre, vous pouvez indiquer une URL OSS publique ou une URL publique accessible via Internet.

Content

String

Non

Le contenu textuel utilisé pour le rendu d'un avatar numérique.

• Vous devez spécifier un seul des paramètres MediaId, MediaURL et Content.

• La valeur de ce paramètre doit contenir au moins cinq caractères.

AvatarId

String

Non

L'ID de l'image de l'avatar numérique.

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

Voice

String

Non

Le type de voix.

• Ce paramètre prend effet si vous spécifiez Content.

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

CustomizedVoice

String

Non

La voix humaine personnalisée.

• Spécifiez l'ID de la voix entraînée à l'aide de la fonctionnalité de clonage vocal humain. Vous pouvez utiliser votre voix humaine personnalisée pour générer de l'audio.

• Si vous spécifiez ce paramètre, Voice devient invalide.

LoopMotion

Boolean

Non

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

• Si vous définissez ce paramètre sur true, la première et la dernière image de la vidéo générée pour l'avatar numérique sont identiques. Cela évite les sauts d'image des mouvements et expressions de l'avatar numérique lors de la lecture en boucle ou lors de la fusion de vidéos d'avatars numériques.

• Valeurs valides : true et false.

• Valeur par défaut : false.

SpeechRate

Integer

Non

Le débit de parole.

• Ce paramètre prend effet si vous spécifiez Content. Valeurs valides : -500 à 500. Valeur par défaut : 0.

  • Une valeur de -500 indique que le débit de parole est 0,5 fois le débit original. Une valeur de 0 indique que le débit original est utilisé. Une valeur de 500 indique que le débit de parole est 2 fois le débit original.

PitchRate

Integer

Non

L'intonation.

• Ce paramètre prend effet si vous spécifiez Content.

• Valeurs valides : -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 au contenu de la piste d'image.

Remarque : vous devez spécifier uniquement l'un des paramètres MediaId ou MediaURL.

MediaURL

String

Non

URL OSS du contenu de la piste d'image. Le format de l'URL OSS est le suivant : https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4.

Remarque :

• Vous devez spécifier uniquement l'un des paramètres MediaId ou MediaURL.

• Seule une URL OSS publique peut être spécifiée pour ce paramètre.

Pour plus d'informations, consultez la rubrique Modifier la vitesse audio et vidéo.

X

Float

Non

Distance horizontale entre le coin supérieur gauche du contenu et le coin supérieur gauche de la vidéo de sortie. Vous pouvez définir cette valeur sous forme de pourcentage ou en pixels. Si la valeur est comprise entre 0 et 0,9999, elle représente un pourcentage. Si la valeur est un entier supérieur ou égal à 2, elle représente un nombre de pixels.

Y

Float

Non

Distance verticale entre le coin supérieur gauche du contenu et le coin supérieur gauche de la vidéo de sortie. Vous pouvez définir cette valeur sous forme de pourcentage ou en pixels. Si la valeur est comprise entre 0 et 0,9999, elle représente un pourcentage. Si la valeur est un entier supérieur ou égal à 2, elle représente un nombre de pixels.

Width

Float

Non

Largeur du contenu dans la vidéo de sortie. Vous pouvez définir cette valeur sous forme de pourcentage ou en pixels. Si la valeur est comprise entre 0 et 0,9999, elle représente un pourcentage. Si la valeur est un entier supérieur ou égal à 2, elle représente un nombre de pixels.

Height

Float

Non

Hauteur du contenu dans la vidéo de sortie. Vous pouvez définir cette valeur sous forme de pourcentage ou en pixels. Si la valeur est comprise entre 0 et 0,9999, elle représente un pourcentage. Si la valeur est un entier supérieur ou égal à 2, elle représente un nombre de pixels.

TimelineIn

Float

Non

Heure de début de l'image dans la timeline. Unité : secondes. La précision va jusqu'à quatre décimales. Si vous ne spécifiez pas TimelineIn, la valeur 0 est utilisée par défaut.

TimelineOut

Float

Non

Heure de fin de l'image dans la timeline. Unité : secondes. La précision va jusqu'à quatre décimales. Si vous ne spécifiez pas TimelineOut, 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 obligatoire si le fichier source est une image animée. Pour plus d'informations, consultez la rubrique Ajouter des filigranes, des autocollants ou des GIF animés.

Effects

Effect[]

Non

Effets appliqués au contenu.

Paramètre

Type

Obligatoire

Description

Type

String

Oui

Le type de ressource de sous-titre. Valeurs possibles :

• Subtitle : un fichier de sous-titres externe

• Text : texte de bannière

SubType

String

Non

Le sous-type de la ressource de sous-titre. Valeurs possibles :

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

• ass : un 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

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

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

Remarque :

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

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

X

Float

Non

La distance horizontale entre le coin supérieur gauche du texte de bannière et le coin supérieur gauche de la vidéo de sortie. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Vous pouvez définir la valeur sous forme de pourcentage ou en pixels. Si la valeur est comprise entre 0 et 0,9999, elle représente un pourcentage. Si la valeur est un entier supérieur ou égal à 2, elle indique un nombre de pixels.

Y

Float

Non

La distance verticale entre le coin supérieur gauche du texte de bannière et le coin supérieur gauche de la vidéo de sortie. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Vous pouvez définir la valeur sous forme de pourcentage ou en pixels. Si la valeur est comprise entre 0 et 0,9999, elle représente un pourcentage. Si la valeur est un entier supérieur ou égal à 2, elle indique un nombre de pixels.

TimelineIn

Float

Non

L'heure de début du texte de bannière dans la timeline. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Unité : secondes. La valeur est précise à quatre décimales près. Si vous ne spécifiez pas TimelineIn, l'affichage de la ressource commence dès la fin de l'affichage de la ressource précédente dans la timeline.

TimelineOut

Float

Non

L'heure de fin du texte de bannière dans la timeline. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Unité : secondes. La valeur est précise à quatre décimales près. Si vous ne spécifiez pas TimelineOut, l'affichage de la ressource s'arrête dès le début de l'affichage de la ressource suivante dans la timeline.

ClipId

Float

Non

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

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

ReferenceClipId

String

Non

Ce paramètre sert à aligner les pistes. Si la propriété ClipId d'une ressource située sur une autre piste possède la même valeur, les heures de début et de fin du clip actuel sont alignées sur cette ressource.

Content

String

Non

Le texte de la bannière. Ce paramètre est requis si vous définissez Type sur Text.

Font

String

Non

La police du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Valeur par défaut : SimSun. Pour obtenir la liste des polices prises en charge, consultez la rubrique Liste des polices.

FontSize

Int

Non

La taille de police du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Valeur par défaut : 0. Valeur maximale : 5000.

SizeRequestType

String

Non

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

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

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

FontColor

String

Non

La couleur du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. La valeur doit suivre le format dièse (#) suivi d'une valeur hexadécimale. Exemple : #ffffff.

FontColorOpacity

Float

Non

L'opacité du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Valeurs possibles : de 0 à 1. Valeur par défaut : 1. Une valeur de 1 signifie que le texte est entièrement opaque. Une valeur de 0 signifie que le texte est entièrement transparent.

FontFace

FontFace

Non

L'apparence du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text.

Spacing

Int

Non

L'espacement entre les mots du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Unité : pixel. Valeur par défaut : 0.

LineSpacing

Int

Non

L'interligne du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Unité : pixel. Valeur par défaut : 0.

Angle

Float

Non

L'angle de rotation du texte de bannière dans le sens inverse des aiguilles d'une montre. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Unité : degré. Valeur par défaut : 0.

BorderStyle

Int

Non

Le style de bordure du texte de bannière. Valeurs possibles : 1 et 3. La valeur 1 indique que le texte possède une bordure et une ombre. La valeur 3 indique que le texte possède un arrière-plan. Valeur par défaut : 1.

Outline

Int

Non

La largeur du contour du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Unité : pixel. Valeur par défaut : 0.

OutlineColour

String

Non

La couleur du contour du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. La valeur doit suivre le format dièse (#) suivi d'une valeur hexadécimale. Exemple : #ffffff.

Shadow

Int

Non

La taille de l'ombre du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Unité : pixel. Valeur par défaut : 0.

BackColour

String

Non

La couleur de l'ombre du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. La valeur doit suivre le format dièse (#) suivi d'une valeur hexadécimale. Exemple : #ffffff.

Alignment

String

Non

Le mode d'alignement du texte. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Valeur par défaut : TopLeft. Valeurs possibles :

• TopLeft

• TopCenter

• TopRight

• CenterLeft

• CenterCenter

• CenterRight

• BottomLeft

• BottomCenter

• BottomRight

Pour spécifier avec précision les positions des sous-titres selon différents modes d'alignement, nous vous recommandons de configurer l'alignement du texte comme suit :

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

• Alignement centré : spécifiez 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 pour X et Y.

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

AdaptMode

String

Non

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

• AutoWrap : active le retour à la ligne automatique.

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

• AutoWrapAtSpaces : active le retour à la ligne automatique et effectue les césures uniquement au niveau des espaces. Cette option s'applique uniquement au texte en anglais.

• AutoWrapAtSpacesStrict : applique un retour à la ligne strict basé sur les caractères d'espace. Si un mot dépasse la limite du conteneur, le mot entier est déplacé vers la ligne suivante plutôt que d'être coupé.

TextWidth

Float

Non

La largeur de la zone de texte. Ce paramètre s'applique si vous spécifiez AdaptMode. Il est utilisé lors de l'activation du retour à la ligne automatique ou de la mise à l'échelle automatique. Si vous ne spécifiez pas ce paramètre, la largeur de la vidéo est utilisée pour le retour à la ligne automatique ou la mise à l'échelle automatique. Si la valeur est supérieure à 0 et inférieure ou égale à 1, elle représente le pourcentage de la largeur de la zone de texte par rapport à la largeur de la vidéo de sortie. Si la valeur est supérieure à 1, elle indique un nombre de pixels.

FontUrl

String

Non

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

EffectColorStyle

String

Non

L'effet de style artistique appliqué au texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Pour plus d'informations sur les effets de style artistique, consultez la rubrique Style artistique de texte.

SubtitleEffects

SubtitleEffect[]

Non

Les effets multicouches appliqués au texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Vous pouvez configurer des contours multicouches, des ombres multicouches, des flous gaussiens et des effets d'arrière-plan pour les sous-titres. Les flous gaussiens ne sont pris en charge que si une ombre est appliquée au texte du sous-titre.

Remarque :

• Si vous spécifiez SubtitleEffects, les paramètres Outline et Shadow dans SubtitleTrackClip deviennent invalides.

• Si vous configurez des contours multicouches, des ombres multicouches ou des effets d'arrière-plan pour les sous-titres, les effets sont superposés selon l'ordre des éléments du tableau SubtitleEffects. Le calque correspondant au premier effet de sous-titre du tableau est placé en bas, tandis que celui correspondant au dernier effet est placé en haut.

EnableLocalStyleAutoScale

Boolean

Non

Lors de la configuration du style local du sous-titre, indique si la taille de police, l'épaisseur du trait et la taille de l'ombre du style local sont mises à l'échelle en fonction de la taille de la vidéo de sortie et de la taille FECanvas. La valeur par défaut est False, ce qui signifie que le style local n'est pas mis à l'échelle.

SupportBidi

Boolean

Non

Indique s'il faut activer le rendu bidirectionnel du texte. Lorsqu'un texte de sous-titre contient à la fois du texte de gauche à droite (LTR, comme l'anglais, les chiffres, les lettres latines) et du texte de droite à gauche (RTL), il est recommandé d'activer cette option. Désactivé par défaut.

ScrollStartY

Float

Non

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

ScrollEndY

Float

Non

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

ScrollSpeed

Float

Non

La vitesse de défilement vertical (haut ou bas) du sous-titre. Ce paramètre s'applique si un effet de défilement de sous-titre est configuré. Unité : pixel par seconde.

ScrollStartShift

Float

Non

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

ScrollEndShift

Float

Non

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

ScrollStartFreeze

Float

Non

La durée de pause au point de départ pour le défilement vertical. Unité : secondes.

ScrollEndFreeze

Float

Non

La durée de pause au point d'arrivée pour le défilement vertical. Unité : secondes.

ScrollDirection

String

Non

La direction du défilement horizontal. Valeurs possibles :

• Left

• Right

ScrollStartX

Float

Non

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

ScrollEndX

Float

Non

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

ScrollLoop

Boolean

Non

Indique s'il faut boucler l'effet de défilement horizontal.

AaiMotionInEffect

String

Non

L'effet d'entrée du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Pour plus d'informations sur les effets d'entrée des sous-titres, consultez la rubrique Exemples d'effets de sous-titres.

AaiMotionIn

Float

Non

La durée de l'effet d'entrée du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Unité : secondes. La valeur est précise à quatre décimales près. Si vous ne spécifiez pas AaiMotionIn, la durée par défaut de 0,5 seconde est utilisée. Si le texte est affiché pendant moins de 0,5 seconde, la durée de l'effet d'entrée correspond à la durée totale du texte moins la durée de l'effet de sortie.

AaiMotionOutEffect

String

Non

L'effet de sortie du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Pour plus d'informations sur les effets de sortie des sous-titres, consultez la rubrique Exemples d'effets de sous-titres.

AaiMotionOut

Float

Non

La durée de l'effet de sortie du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Unité : secondes. La valeur est précise à quatre décimales près. Si vous ne spécifiez pas AaiMotionOut, la durée par défaut de 0,5 seconde est utilisée. Si le texte est affiché pendant moins de 0,5 seconde, la durée de l'effet de sortie correspond à la durée totale du texte.

AaiMotionLoopEffect

String

Non

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

Ratio

Float

Non

La vitesse de l'effet de boucle du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. La valeur est précise à quatre décimales près. Si vous ne spécifiez pas ce paramètre, la valeur 1 est utilisée. Une valeur supérieure à 1 indique une vitesse plus élevée, tandis qu'une valeur inférieure à 1 indique une vitesse plus lente.

TextureURL

String

Non

L'URL de la texture du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type 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

L'ID de l'effet de bulle du texte de bannière. Ce paramètre s'applique uniquement si vous définissez Type sur Text. Pour plus d'informations sur les effets de bulle, consultez la rubrique Exemples d'effets de bulle de texte.

BubbleWidth

Float

Non

La largeur de l'image de base de la bulle par rapport à la vidéo de sortie. Ce paramètre s'applique uniquement si des sous-titres en forme de bulle sont utilisés. Une valeur supérieure à 1 indique un nombre de pixels. Une valeur inférieure ou égale à 1 indique un pourcentage.

BubbleHeight

Float

Non

La hauteur de l'image de base de la bulle par rapport à la vidéo de sortie. Ce paramètre s'applique uniquement si des sous-titres en forme de bulle sont utilisés. Une valeur supérieure à 1 indique un nombre de pixels. Une valeur inférieure ou égale à 1 indique un pourcentage.

Parameter

Type

Required

Description

Type

String

Yes

Le type de l'effet. Valeurs valides : VFX et Filter.

SubType

String

Yes

Le sous-type de l'effet.

TimelineIn

Float

No

L'heure de début de l'effet dans la timeline. Unité : secondes. La valeur est précise à quatre décimales près. Si vous ne spécifiez pas TimelineIn, la valeur 0 est utilisée.

TimelineOut

Float

No

L'heure de fin de l'effet dans la timeline. Unité : secondes. La valeur est précise à quatre décimales près. Si vous ne spécifiez pas TimelineOut, l'effet se termine à la fin de la vidéo.

Duration

Float

No

La durée de l'effet dans la timeline. Unité : secondes. La valeur est précise à quatre décimales près. Si vous ne spécifiez pas Duration, la durée de la vidéo est utilisée.

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

X

Float

No

Ce paramètre prend effet uniquement si vous définissez SubType sur mosaic_rect/blur. Il s'agit de la 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.

Vous pouvez définir la valeur sous forme de pourcentage ou en pixels. Si la valeur est comprise entre 0 et 0,9999, elle indique un pourcentage. Si la valeur est un entier supérieur ou égal à 2, elle indique un nombre de pixels.

Y

Float

No

Ce paramètre prend effet uniquement si vous définissez SubType sur mosaic_rect/blur.

Il s'agit de la 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. Vous pouvez définir la valeur sous forme de pourcentage ou en pixels. Si la valeur est comprise entre 0 et 0,9999, elle indique un pourcentage. Si la valeur est un entier supérieur ou égal à 2, elle indique un nombre de pixels.

Width

Float

No

Ce paramètre prend effet uniquement si vous définissez SubType sur mosaic_rect/blur. Il correspond à la largeur de la zone d'effet dans la vidéo de sortie. Vous pouvez définir la valeur sous forme de pourcentage ou en pixels. Si la valeur est comprise entre 0 et 0,9999, elle indique un pourcentage. Si la valeur est un entier supérieur ou égal à 2, elle indique un nombre de pixels.

Height

Float

No

Ce paramètre prend effet uniquement si vous définissez SubType sur mosaic_rect/blur. Il correspond à la hauteur de la zone d'effet dans la vidéo de sortie. Vous pouvez définir la valeur sous forme de pourcentage ou en pixels. Si la valeur est comprise entre 0 et 0,9999, elle indique un pourcentage. Si la valeur est un entier supérieur ou égal à 2, elle indique un nombre de pixels.

Parameter

Type

Required

Description

Type

String

Yes

Le type de l'effet. Valeurs valides : Outline, Shadow et Box.

Bord

Float

No

La largeur ou la hauteur du contour ou de l'ombre. Une valeur supérieure à 1 indique un nombre de pixels. Une valeur supérieure à 0 et inférieure à 1 indique la largeur ou la hauteur par rapport à la taille du texte.

XBord

Float

No

La largeur du contour ou de l'ombre. Une valeur supérieure à 1 indique un nombre de pixels. Une valeur supérieure à 0 et inférieure à 1 indique la largeur par rapport à la taille du texte. La priorité de ce paramètre est inférieure à celle de Bord.

YBord

Float

No

La hauteur du contour ou de l'ombre. Une valeur supérieure à 1 indique un nombre de pixels. Une valeur supérieure à 0 et inférieure à 1 indique la hauteur par rapport à la taille du texte. La priorité de ce paramètre est inférieure à celle de Bord.

Shift

Float

No

Le décalage horizontal ou vertical du contour ou de l'ombre. Une valeur absolue supérieure à 1 indique un nombre de pixels. Une valeur absolue supérieure à 0 et inférieure à 1 indique le décalage par rapport à la taille du texte. Vous pouvez définir ce paramètre sur une valeur négative, qui indique un décalage vers le haut ou vers la gauche.

XShift

Float

No

Le décalage horizontal du contour ou de l'ombre. Une valeur absolue supérieure à 1 indique un nombre de pixels. Une valeur absolue supérieure à 0 et inférieure à 1 indique le décalage horizontal par rapport à la taille du texte. La priorité de ce paramètre est inférieure à celle de Shift.

YShift

Float

No

Le décalage vertical du contour ou de l'ombre. Une valeur absolue supérieure à 1 indique un nombre de pixels. Une valeur absolue supérieure à 0 et inférieure à 1 indique le décalage vertical par rapport à la taille du texte. La priorité de ce paramètre est inférieure à celle de Shift.

Color

String

No

La couleur RVB. La valeur est au format dièse (#) suivi d'une valeur hexadécimale. Exemple : #ffffff.

Opacity

String

No

L'opacité du sous-titre. Une valeur de 1 indique que le sous-titre est complètement opaque. Une valeur de 0 indique que le sous-titre est complètement transparent.

Blur

Float

No

La plage de flou gaussien en pixels. Ce paramètre prend effet uniquement si vous définissez Type sur Shadow. Après configuration de ce paramètre, le contour du sous-titre émet une lueur.

Radius

Float

No

Le rayon de bordure de l'arrière-plan de couleur unie du texte. Ce paramètre prend effet uniquement si vous définissez Type sur Box. Après configuration de ce paramètre, l'arrière-plan du sous-titre présente des coins arrondis.

ImageUrl

String

No

L'URL de l'image d'arrière-plan personnalisée du sous-titre. Ce paramètre prend effet uniquement si vous définissez Type sur Box. Après configuration de ce paramètre, un effet de bulle personnalisé peut être mis en œuvre. Vous pouvez utiliser 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

No

La largeur de la carte de base de la bulle source. Ce paramètre est requis si des sous-titres à bulles personnalisés sont utilisés.

Height

Float

No

La hauteur de la carte de base de la bulle source. Ce paramètre est requis si des sous-titres à bulles personnalisés sont utilisés.

TextArea

String

No

La zone de texte dans la carte de base de la bulle. Ce paramètre est requis si des sous-titres à bulles personnalisés sont utilisés. La zone de texte contient quatre nombres à virgule flottante dont les valeurs sont comprises entre 0 et 1, séparés par des virgules (,). Par exemple, si vous spécifiez 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, et la largeur et la hauteur de la zone de texte par rapport à la bulle sont 0,8 et 0,6.

Parameter

Type

Required

Description

Bold

Boolean

No

Indique si la police est en gras.

Italic

Boolean

No

Indique si la police est en italique.

Underline

Boolean

No

Indique si la police est soulignée.

Parameter

Type

Required

Description

Type

String

Yes

Le type de l'effet. Valeurs valides :

• Text : ajoute du texte de bannière à une ressource dans une piste vidéo.

• DeWatermark : applique un flou au filigrane d'une ressource dans une piste vidéo.

• Crop : recadre une ressource dans une piste vidéo.

• Pad : ajoute des marges intérieures à une ressource dans une piste vidéo.

• Scale : met à l'échelle une ressource dans une piste vidéo.

• Transition : ajoute un effet de transition à une ressource dans une piste vidéo.

• VFX : ajoute un effet visuel à une ressource dans une piste vidéo.

• Volume : ajuste le volume d'une ressource dans une piste audio.

• AFade : configure le fondu entrant et sortant audio pour une ressource dans une piste audio.

• AI_ASR : génère des sous-titres à partir de l'audio dans une piste audio ou vidéo.

SubType

String

No

Le sous-type de l'effet.

• Si vous définissez Type sur Transition, ce paramètre spécifie le sous-type de l'effet de transition.

• Si vous définissez Type sur VFX, ce paramètre spécifie le sous-type de l'effet visuel.

• Si vous définissez Type sur Filter, ce paramètre spécifie le sous-type de l'effet de filtre. Pour plus d'informations, consultez Exemples de filtres.