Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Configurations des effets

Dernière mise à jour :Aug 10, 2026

Le paramètre Effect possède différentes structures selon le type d'effet. Les sections suivantes décrivent chacune de ces structures.

Texte de bannière

Pour plus d'informations sur l'exemple de chronologie, consultez la rubrique Superposition de texte.

Paramètre

Type

Obligatoire

Description

X

Float

Non

Distance horizontale entre le coin supérieur gauche du texte et le coin supérieur gauche de la vidéo de sortie.

Vous pouvez spécifier une valeur en 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. Valeur par défaut : 0. Les coordonnées sont mises à l'échelle en fonction de la taille de la source et de la vidéo de sortie.

Y

Float

Non

Distance verticale entre le coin supérieur gauche du texte et le coin supérieur gauche de la vidéo de sortie.

Vous pouvez spécifier une valeur en 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. Valeur par défaut : 0. Les coordonnées sont mises à l'échelle en fonction de la taille de la source et de la vidéo de sortie.

TimelineIn

Float

Non

Moment d'affichage du texte dans la chronologie. Unité : secondes. La valeur est précise à quatre décimales près. Si ce paramètre n'est pas spécifié, la valeur TimelineIn du clip est utilisée.

TimelineOut

Float

Non

Moment où l'affichage du texte s'arrête dans la chronologie. Unité : secondes. La valeur est précise à quatre décimales près. Si ce paramètre n'est pas spécifié, la valeur TimelineOut du clip est utilisée.

Content

String

Oui

Contenu du texte de la bannière.

Font

String

Non

Police du texte de la bannière. Valeur par défaut : SimSun.

Pour plus d'informations sur les polices prises en charge, consultez la rubrique Liste des polices.

FontSize

Int

Oui

Taille de police du texte de la bannière. La taille de police est mise à l'échelle en fonction de la taille du média et de la vidéo de sortie.

Remarque

Vous pouvez spécifier soit FontSize, soit FixedFontSize. Si vous spécifiez à la fois FontSize et FixedFontSize, seul FontSize est pris en compte.

FixedFontSize

Int

Oui

Taille de police du texte de la bannière. La taille de police n'est pas mise à l'échelle en fonction de la taille du média et de la vidéo de sortie.

Remarque

Vous pouvez spécifier soit FontSize, soit FixedFontSize. Si vous spécifiez à la fois FontSize et FixedFontSize, seul FontSize est pris en compte.

FixedX

Float

Non

Distance horizontale entre le coin supérieur gauche du texte et le coin supérieur gauche de la vidéo de sortie.

Vous pouvez spécifier une valeur en 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. Valeur par défaut : 0. Les coordonnées ne sont pas mises à l'échelle en fonction de la taille du média et de la vidéo de sortie.

FixedY

Float

Non

Distance verticale entre le coin supérieur gauche du texte et le coin supérieur gauche de la vidéo de sortie.

Vous pouvez spécifier une valeur en 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. Valeur par défaut : 0. Les coordonnées ne sont pas mises à l'échelle en fonction de la taille du média et de la vidéo de sortie.

FontColor

String

Non

Couleur du texte au format hexadécimal. La valeur commence par un dièse (#).

Exemple : #ffffff.

FontColorOpacity

String

Non

Transparence du texte de la bannière. Valeurs possibles : de 0 à 1. 1 indique que le texte n'est pas transparent et 0 indique que le texte est complètement transparent. Valeur par défaut : 1.

FontFace

FontFace

Non

Apparence du texte de la bannière.

Spacing

Integer

Non

Espacement entre les mots du texte de la bannière. Unité : pixels. Valeur par défaut : 0.

Angle

Float

Non

Angle de rotation du texte de la bannière dans le sens inverse des aiguilles d'une montre. Unité : degrés. Valeur par défaut : 0.

BorderStyle

Int

Non

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

Outline

Int

Non

Épaisseur du contour du texte de la bannière. Unité : pixels. Valeur par défaut : 0.

OutlineColour

String

Non

Couleur du contour du texte de la bannière au format hexadécimal. La valeur commence par un dièse (#). Exemple : #ffffff.

Shadow

Int

Non

Taille de l'ombre du texte de la bannière. Unité : pixels. Valeur par défaut : 0.

BackColour

String

Non

Couleur de l'ombre du texte de la bannière au format hexadécimal. La valeur commence par un dièse (#). Exemple : #ffffff.

Alignment

String

Non

Emplacement du texte de la bannière. Valeur par défaut : TopLeft. Valeurs possibles :

  • TopLeft

  • TopCenter

  • TopRight

  • CenterLeft

  • CenterCenter

  • CenterRight

  • BottomLeft

  • BottomCenter

  • BottomRight

AdaptMode

String

Non

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

  • AutoWrap : active le retour à la ligne automatique

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

  • AutoWrapAtSpaces : effectue automatiquement le retour à la ligne en utilisant uniquement les espaces lorsque le texte est affiché en anglais.

TextWidth

String

Non

Largeur de la zone de texte. Ce paramètre prend effet lorsque AdaptMode est spécifié. Il est utilisé lors de l'activation du retour à la ligne automatique ou de la mise à l'échelle automatique. Si ce paramètre n'est pas spécifié, le retour à la ligne automatique ou la mise à l'échelle automatique est effectué en fonction de la largeur de la vidéo. Unité : pixels.

FontUrl

String

Non

URL du fichier de police dans Object Storage Service (OSS). 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

Effet de style artistique appliqué au texte de la bannière.

Pour plus d'informations sur les effets de style artistique, consultez la rubrique Exemples d'effets de style artistique.

AaiMotionInEffect

String

Non

Effet d'entrée du texte de la bannière.

Pour plus d'informations sur les effets d'entrée, consultez la rubrique Effets d'entrée.

AaiMotionIn

Float

Non

Durée de l'effet d'entrée. Unité : secondes. La valeur est précise à quatre décimales près. Si AaiMotionIn n'est pas spécifié, la valeur par défaut de ce paramètre est de 0,5 seconde. Si le texte de la bannière est affiché pendant moins de 0,5 seconde, la durée de l'effet d'entrée correspond à la durée totale du texte de la bannière moins la durée de l'effet de sortie.

AaiMotionOutEffect

String

Non

Effet de sortie du texte de la bannière.

Pour plus d'informations sur les effets de sortie, consultez la rubrique Effets de sortie.

AaiMotionOut

Float

Non

Durée de l'effet de sortie. Unité : secondes. La valeur est précise à quatre décimales près. Si AaiMotionOut n'est pas spécifié, la valeur par défaut de ce paramètre est de 0,5 seconde. Si le texte de la bannière est affiché pendant moins de 0,5 seconde, la durée de l'effet de sortie correspond à la durée totale du texte de la bannière.

AaiMotionLoopEffect

String

Non

Effet de boucle du texte de la bannière. L'effet de boucle ne peut pas être activé simultanément avec l'effet d'entrée ou l'effet de sortie.

Pour plus d'informations sur les effets de boucle, consultez la rubrique Effets de boucle.

Ratio

Float

Non

Vitesse de l'effet de boucle. La valeur est précise à quatre décimales près. Si ce paramètre n'est pas spécifié, la valeur par défaut est 1. Une valeur supérieure à 1 indique une vitesse de boucle plus élevée et une valeur inférieure à 1 indique une vitesse de boucle plus lente.

Masquage

|
**Parameter**
|
**Type**
|
**Required**
|
**Description**
| | --- | --- | --- | --- | |
X
|
Float
|
No
|
Distance horizontale entre le coin supérieur gauche de la zone floutée et le coin supérieur gauche de la vidéo de sortie. Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 le nombre de pixels. Valeur par défaut : 0.
| |
Y
|
Float
|
No
|
Distance verticale entre le coin supérieur gauche de la zone floutée et le coin supérieur gauche de la vidéo de sortie. Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 le nombre de pixels. Valeur par défaut : 0.
| |
Width
|
Float
|
Yes
|
Largeur de la zone floutée dans la vidéo de sortie. Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 le nombre de pixels.
| |
Height
|
Float
|
Yes
|
Hauteur de la zone floutée dans la vidéo de sortie. Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 le nombre de pixels.
| |
TimelineIn
|
Float
|
No
|
Moment où le floutage commence dans la chronologie, en secondes. La valeur est précise à quatre décimales. Si ce paramètre n'est pas spécifié, la valeur TimelineIn du clip est utilisée.
| |
TimelineOut
|
Float
|
No
|
Moment où le floutage s'arrête dans la chronologie, en secondes. La valeur est précise à quatre décimales. Si ce paramètre n'est pas spécifié, la valeur TimelineOut du clip est utilisée.
|























































Recadrage

Pour plus d'informations sur l'exemple de chronologie, consultez la rubrique Supprimer les bandes noires.

|
**Parameter**
|
**Type**
|
**Required**
|
**Description**
| | --- | --- | --- | --- | |
X
|
Float
|
No
|
Distance horizontale entre le coin supérieur gauche de l'image vidéo après recadrage et le coin supérieur gauche de la vidéo de sortie.


Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 le nombre de pixels. Valeur par défaut : 0.
| |
Y
|
Float
|
No
|
Distance verticale entre le coin supérieur gauche de l'image vidéo après recadrage et le coin supérieur gauche de la vidéo de sortie.


Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 le nombre de pixels. Valeur par défaut : 0.
| |
Width
|
Float
|
Yes
|
Largeur de l'image vidéo dans la vidéo de sortie après recadrage.


Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 le nombre de pixels.
| |
Height
|
Float
|
Yes
|
Hauteur de l'image vidéo dans la vidéo de sortie après recadrage.


Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 le nombre de pixels.
|



















































Mise à l'échelle

Pour plus d'informations sur l'exemple de chronologie, consultez la rubrique Configurer l'incrustation d'image.

Remarque

Si la largeur ou la hauteur du média diffère de celle de la vidéo de sortie et qu'aucune mise à l'échelle n'est configurée, le système met automatiquement le média à l'échelle pour l'adapter, le centre et ajoute des bandes noires pour remplir la zone restante.

|
**Parameter**
|
**Type**
|
**Required**
|
**Description**
| | --- | --- | --- | --- | |
Width
|
Float
|
Yes
|
Largeur de l'image vidéo dans la vidéo de sortie après mise à l'échelle.


Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 à 1, elle représente le nombre de pixels.
| |
Height
|
Float
|
Yes
|
Hauteur de l'image vidéo dans la vidéo de sortie après mise à l'échelle.


Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 à 1, elle représente le nombre de pixels.
|





























Remplissage

Remarque

Si le rapport d'aspect du média diffère de celui de la vidéo de sortie et qu'aucun remplissage n'est configuré, le système met automatiquement le média à l'échelle pour l'adapter, le centre et ajoute un remplissage pour combler la zone restante.

|
**Parameter**
|
**Type**
|
**Required**
|
**Description**
| | --- | --- | --- | --- | |
Left
|
Float
|
No
|
Distance entre le côté gauche du média et le côté gauche de la vidéo de sortie.


Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 à 1, elle représente le nombre de pixels.
| |
Right
|
Float
|
No
|
Distance entre le côté droit du média et le côté droit de la vidéo de sortie.


Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 à 1, elle représente le nombre de pixels.
| |
Top
|
Float
|
No
|
Distance entre le haut du média et le haut de la vidéo de sortie.


Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 à 1, elle représente le nombre de pixels.
| |
Bottom
|
Float
|
No
|
Distance entre le bas du média et le bas de la vidéo de sortie.


Vous pouvez définir la valeur sous forme de pourcentage ou en nombre de 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 à 1, elle représente le nombre de pixels.
| |
Color
|
String
|
No
|
Couleur des zones de remplissage au format hexadécimal. La valeur doit commencer par un dièse (#). Exemple : #000000. La couleur par défaut est le noir.
|



























































Paramètres d'arrière-plan

Si la taille du média diffère de celle de la vidéo de sortie, vous pouvez flouter la zone vide ou la remplir avec une couleur spécifique.

Les paramètres d'arrière-plan peuvent être combinés avec des effets tels que le recadrage, la mise à l'échelle et les transitions.

Parameter

Type

Required

Description

SubType

String

Yes

Type de paramètre d'arrière-plan. Valeurs possibles :

Blur

Color

Radius

Float

No

Rayon de flou. Ce paramètre prend effet uniquement lorsque SubType est défini sur Blur. Valeurs possibles : [0,01 ; 1].

Color

String

No

Valeur de couleur RVB au format hexadécimal. Ce paramètre prend effet uniquement lorsque SubType est défini sur Color.

Exemple : #FFFFFF.

Transitions

Un effet de transition relie deux clips en superposant la fin du clip précédent avec le début du clip suivant. Il vous suffit de spécifier la durée de la transition pour le clip précédent. L'ajout d'une transition réduit la durée totale de la longueur de la transition.

Par exemple, une piste vidéo contient deux clips : Clip 1 (10 secondes) et Clip 2 (8 secondes). Si vous ajoutez une transition de 4 secondes entre eux, la durée totale passe de 18 secondes à 14 secondes.

|
**Parameter**
|
**Type**
|
**Required**
|
**Description**
| | --- | --- | --- | --- | |
SubType
|
String
|
Yes
|
Type d'effet de transition. Vous pouvez spécifier plusieurs effets de transition en les séparant par des virgules (,). Le système en sélectionne alors un aléatoirement. Vous pouvez également spécifier random pour laisser le système choisir aléatoirement un effet parmi tous les effets disponibles. Pour plus d'informations sur les valeurs valides et les effets, consultez la rubrique [Effets de transition](t2346537.dita#).


Exemple : directional.
| |
Duration
|
Float
|
No
|
Durée de l'effet de transition, en secondes. La valeur est précise à quatre décimales. Valeur par défaut : 1.
|


























Effets visuels

Parameter

Type

Required

Description

SubType

String

Yes

Le type d'effet visuel. Vous pouvez sélectionnez plusieurs effets visuels et les séparer par des virgules (,). Le système en choisira alors un au hasard. Vous pouvez également spécifiez la valeur random pour laisser le système choisir aléatoirement un effet parmi tous les effets disponibles. Pour plus d'informations sur les valeurs valides et les effets correspondants, consultez Exemples d'effets spéciaux.

Exemple : colorfulradial.

X

Float

No

Ce paramètre ne s'applique que lorsque SubType est définissez sur mosaic_rect ou blur. Il indique la distance horizontale entre le coin supérieur gauche de la zone d'effet visuel et le coin supérieur gauche de la vidéo de sortie.

Vous pouvez indiquer une valeur en 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

No

Ce paramètre ne s'applique que lorsque SubType est définissez sur mosaic_rect ou blur.

Il indique la distance verticale entre le coin supérieur gauche de la zone d'effet visuel et le coin supérieur gauche de la vidéo de sortie.

Vous pouvez indiquer une valeur en 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

No

Ce paramètre ne s'applique que lorsque SubType est définissez sur mosaic_rect ou blur. Il indique la largeur de la zone d'effet visuel dans la vidéo de sortie.

Vous pouvez indiquer une valeur en 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

No

Ce paramètre ne s'applique que lorsque SubType est définissez sur mosaic_rect ou blur. Il indique la hauteur de la zone d'effet visuel dans la vidéo de sortie.

Vous pouvez indiquer une valeur en 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.

Filtres

|
**Parameter**
|
**Type**
|
**Required**
|
**Description**
| | --- | --- | --- | --- | |
SubType
|
String
|
Yes
|
Le type de filtre. Vous pouvez sélectionnez plusieurs filtres et les séparer par des virgules (,). Le système en choisira alors un au hasard. Vous pouvez également spécifiez la valeur random pour laisser le système choisir aléatoirement un filtre parmi tous les filtres disponibles. Pour plus d'informations sur les valeurs valides et les effets correspondants, consultez [Exemples d'effets de filtre](t2346541.dita#).


Exemple : M1.
| |
TimelineIn
|
Float
|
No
|
L'instant d'application du filtre dans la timeline, exprimé en secondes. La valeur est précise à quatre décimales près. Si ce paramètre n'est pas spécifiez, la valeur TimelineIn du clip est utilisée.
| |
TimelineOut
|
Float
|
No
|
L'instant de désactivation du filtre dans la timeline, exprimé en secondes. La valeur est précise à quatre décimales près. Si ce paramètre n'est pas spécifiez, la valeur TimelineOut du clip est utilisée.
| |
ExtParams
|
String
|
No
|
Les paramètres associés aux filtres. Ce paramètre ne s'applique que lorsque SubType est définissez sur color. Dans ce cas, un filtre de colorimétrie est appliqué. Pour plus d'informations sur la configuration d'ExtParams, consultez [ExtParams](#title-zh9-xgj-sc5).
|

ExtParams

Pour plus d'informations sur l'exemple de timeline, consultez Utiliser des filtres de rendu.

|
**Parameter**
|
**Type**
|
**Valid value**
|
**Description**
|
**Default value**
| | --- | --- | --- | --- | --- | |
brightness
|
int
|
[-255,255]
|
Luminosité
|
0
| |
contrast
|
int
|
[-100,100]
|
Contraste
|
0
| |
saturation
|
int
|
[-100,100]
|
Saturation
|
0
| |
kelvin_temperature
|
int
|
[1000,40000]
|
La température de couleur. Ce paramètre s'applique lorsque temperature_ratio est spécifiez.


temperature_ratio
|
6000
| |
temperature_ratio
|
int
|
[0,100]
|
Le ratio de température de couleur.
|
0
| |
tint
|
int
|
[-100,100]
|
Teinte
|
0
| |
dark_corner_ratio
|
int
|
[0,100]
|
Vignetage
|
0
|





























































































































Réglage du volume

Pour plus d'informations sur les exemples de timeline, consultez Exemple de mise en sourdine d'une vidéo entière et Exemple de réglage du volume d'une vidéo et de doublage avec une ressource audio dont le volume est également ajusté.

|
**Parameter**
|
**Type**
|
**Required**
|
**Description**
| | --- | --- | --- | --- | |
Gain
|
Float
|
No
|
Le volume. Valeurs valides : 0 à 10. Une valeur plus faible indique un volume plus bas. 0 correspond au mode muet, 1 correspond au volume d'origine. Valeur par défaut : 1.
|















Fondu audio entrant et sortant

Pour plus d'informations sur les exemples de timeline, consultez Exemple de <b>configuration</b> d'un fondu audio entrant et sortant pour une vidéo et Exemple de <b>configuration</b> d'un fondu audio entrant et sortant.

Parameter

Type

Required

Description

SubType

String

Yes

Le type de fondu audio. Valeurs valides :

  • In

  • Out

Duration

Float

No

La durée du fondu audio. Le fondu entrant s'applique au début d'un élément multimédia et le fondu sortant à la fin. Valeur par défaut : 0. La valeur 0 indique qu'aucun fondu audio n'est appliqué.

Curve

String

No

La courbe de volume du fondu audio. Valeur par défaut : exp.

Valeurs valides :

  • exp : courbe exponentielle

  • tri : courbe linéaire

Rotation

Vous pouvez faire pivoter un élément multimédia de 90, 180 ou 270 degrés dans la piste vidéo ou la piste image.

Pour plus d'informations sur l'exemple de timeline, consultez Configurer la rotation d'un élément multimédia.

|
**Parameter**
|
**Type**
|
**Required**
|
**Description**
| | --- | --- | --- | --- | |
Degree
|
Integer
|
Yes
|
L'angle de rotation dans le sens horaire. Vous ne pouvez faire pivoter un élément multimédia que de 90, 180 ou 270 degrés.
|















Capture aléatoire de clip

Vous pouvez capturer aléatoirement un clip à partir du contenu multimédia d'origine et l'ajouter à la timeline.

Pour plus d'informations sur l'exemple de timeline, consultez Utiliser un effet aléatoire.

|
**Parameter**
|
**Type**
|
**Required**
|
**Description**
| | --- | --- | --- | --- | |
SubType
|
String
|
Yes
|
Le type de capture. Valeur valide : RandomClip.
| |
ClipDuration
|
Float
|
Yes
|
La durée du clip de la piste vidéo.
|























Retournement

Vous pouvez retourner des vidéos ou des images d'une piste vidéo selon l'axe x ou l'axe y.

Parameter

Type

Required

Description

Direction

String

Yes

  • horizontal : retourne les vidéos ou les images selon l'axe x

  • vertical : retourne les vidéos ou les images selon l'axe y

Effet Ken Burns

Vous pouvez ajouter l'effet Ken Burns aux vidéos et aux images présentes dans la piste vidéo.

Limites :

  • Cet effet s'applique uniquement aux images et aux vidéos. L'effet Ken Burns peut être combiné avec des effets visuels, des filtres et des transitions.

  • Spécifiez les paramètres WindowW et WindowH pour configurer la largeur et la hauteur de la vidéo de sortie. Une fois ces paramètres définis, vous ne pouvez pas recadrer, mettre à l'échelle, ajouter de bordures ni configurer l'arrière-plan de l'image vidéo de sortie.

Paramètre

Type

Obligatoire

Description

Exemple

Duration

Float

Non

Durée de l'effet. La valeur par défaut correspond à la durée du clip. Unité : secondes. Valeur maximale : 10.

5

WindowW

Float

Non

Largeur du clip. La valeur par défaut correspond à la largeur de la vidéo de sortie. Unité : pixels.

Si la valeur de WindowW est comprise dans l'intervalle (0,1], il s'agit d'une valeur relative. Si la valeur est supérieure à 1, il s'agit d'une valeur absolue.

1

WindowH

Float

Non

Hauteur du clip. La valeur par défaut correspond à la hauteur de la vidéo de sortie. Unité : pixels.

Si la valeur de WindowH est comprise dans l'intervalle (0,1], il s'agit d'une valeur relative.

Si la valeur est supérieure à 1, il s'agit d'une valeur absolue.

1

Start

String

Non

Position de la zone d'effet avant l'application de l'effet Ken Burns. La position est déterminée par les coordonnées x et y du coin supérieur gauche ainsi que par la largeur et la hauteur de la zone d'effet. Ces paramètres sont facultatifs. Les valeurs doivent être séparées par des virgules (,).

« StartX,StartY,StartW,StartH »

Les règles suivantes s'appliquent :

0 < StartX + StartW <=1

0 < StartY + StartH <=1

« 0,0,0.9,0.9 »

StartX

Float

Non

Coordonnée x du coin supérieur gauche de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur de StartX est comprise dans l'intervalle [0,1), il s'agit d'une valeur relative.

Si la valeur est supérieure ou égale à 1, il s'agit d'une valeur absolue.

0

StartY

Float

Non

Coordonnée y du coin supérieur gauche de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur de StartY est comprise dans l'intervalle [0,1), il s'agit d'une valeur relative.

Si la valeur est supérieure ou égale à 1, il s'agit d'une valeur absolue.

0

StartW

Float

Non

Largeur de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur de StartW est comprise dans l'intervalle (0,1], il s'agit d'une valeur relative.

Si la valeur est supérieure à 1, il s'agit d'une valeur absolue.

0.9

StartH

Float

Non

Hauteur de la zone d'effet avant l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur de StartH est comprise dans l'intervalle (0,1], il s'agit d'une valeur relative.

Si la valeur est supérieure à 1, il s'agit d'une valeur absolue.

0.9

End

String

Non

Position de la zone d'effet après l'application de l'effet Ken Burns. La position est déterminée par les coordonnées x et y du coin supérieur gauche ainsi que par la largeur et la hauteur de la zone d'effet. Ces paramètres sont facultatifs. Les valeurs doivent être séparées par des virgules (,).

« EndX,EndY,EndW,EndH »

Les règles suivantes s'appliquent :

0 < EndX + EndW <=1

0 < EndY + EndH <=1

« 0,0,1,1 »

EndX

Float

Non

Coordonnée x du coin supérieur gauche de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur de StartX est comprise dans l'intervalle [0,1), il s'agit d'une valeur relative.

Si la valeur est supérieure ou égale à 1, il s'agit d'une valeur absolue.

0

EndY

Float

Non

Coordonnée y du coin supérieur gauche de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur de StartY est comprise dans l'intervalle [0,1), il s'agit d'une valeur relative.

Si la valeur est supérieure ou égale à 1, il s'agit d'une valeur absolue.

0

EndW

Float

Non

Largeur de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur de StartW est comprise dans l'intervalle (0,1], il s'agit d'une valeur relative.

Si la valeur est supérieure à 1, il s'agit d'une valeur absolue.

1

EndH

Float

Non

Hauteur de la zone d'effet après l'application de l'effet Ken Burns. Unité : pixels.

Si la valeur de StartH est comprise dans l'intervalle (0,1], il s'agit d'une valeur relative.

Si la valeur est supérieure à 1, il s'agit d'une valeur absolue.

1

Zoom

Vous pouvez ajouter des effets de zoom aux clips.

Important

Les effets de zoom s'appliquent uniquement aux clips présents dans la piste vidéo.

Paramètre

Type

Obligatoire

Description

StartRate

Float

Non

  • Valeur actuelle du zoom.

  • Valeur par défaut : 1,0

  • Plage de valeurs valides : [1,0 ; 5,0].

EndRate

Float

Non

  • Valeur de zoom souhaitée.

  • Valeur par défaut : valeur de StartRate plus 0,3.

  • Plage de valeurs valides : [StartRate ; 5,0]

Duration

Float

Non

  • Durée de l'effet de zoom.

  • Valeur par défaut : durée de rendu du clip.

  • Plage de valeurs valides : [0 ; durée de rendu du clip]