Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Superposition de texte

Dernière mise à jour :Aug 10, 2026

Exemples courants de configuration de la timeline pour les superpositions de texte dans le montage vidéo basé sur OpenAPI, couvrant les superpositions sur toute la durée, les superpositions dans des régions spécifiées, les sous-titres externes et les styles de texte artistique.

API associées

Paramètres

Paramètre

Description

Coordonnées du texte

  • X : distance horizontale entre le coin supérieur gauche du texte et le coin supérieur gauche de la vidéo de sortie.

  • Y : distance verticale entre le coin supérieur gauche du texte et le coin supérieur gauche de la vidéo de sortie.

La valeur peut être un pourcentage ou une valeur en pixels :

  • Si la valeur est comprise entre 0 et 0,9999, elle représente un ratio par rapport à la largeur ou à la hauteur de la vidéo de sortie. X est relatif à la largeur et Y est relatif à la hauteur.

  • Si la valeur est un entier supérieur ou égal à 8, elle indique une valeur absolue en pixels.

Propriétés du texte

  • Content : contenu du texte.

  • Font : police du texte. La police par défaut est SimSun.

    Les polices suivantes sont prises en charge :

    • SimSun est une police de type Song.

    • WenQuanYi Zen Hei

    • WenQuanYi Zen Hei Mono est également connue sous le nom de WenQuanYi Equal-Width Zen Hei.

    • WenQuanYi Zen Hei Sharp est un alias pour WenQuanYi Dot Matrix Zheng Hei.

    • Yuanti SC Bold : Yuanti-Simplified (Bold).

    • Yuanti SC Light : police légère et arrondie pour le chinois simplifié.

    • Yuanti SC Regular : Simplified Round. Regular.

  • FontSize : taille de la police en pixels. La valeur par défaut est 20.

  • FontColor : couleur de la police au format hexadécimal. La valeur doit commencer par un dièse (#), par exemple #FFFFFF. La valeur par défaut est #FFFFFF.

  • ColorOpacity : opacité de la couleur de la police. Valeurs valides : 0 (totalement transparent) à 1 (totalement opaque). Valeur par défaut : 1.

  • FontFace : style de la police.

    • Bold : indique si la police doit être mise en gras. La valeur par défaut est false.

    • Italic : indique si la police doit être mise en italique. La valeur par défaut est false.

    • Underline : indique si la police doit être soulignée. La valeur par défaut est false.

Plage temporelle de la superposition de texte

  • TimelineIn : heure de début du texte par rapport à la timeline.

  • TimelineOut : heure de fin du texte par rapport à la timeline.

Exemples de timeline

Superposition de texte sur toute la durée

Une superposition de texte sur toute la durée apparaît tout au long de la vidéo. Vous n'avez pas besoin de spécifier TimelineIn ni TimelineOut. La position du texte dans la vidéo de sortie est déterminée par X et Y. Exemple :

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
                    "Effects": [
                        {
                            "Type": "Text",
                            "X": 31,
                            "Y": 93,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000",
                            "FontFace": {
                                "Bold": true,
                                "Italic": false,
                                "Underline": false
                            }
                        },
                        {
                            "Type": "Text",
                            "X": 30,
                            "Y": 92,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "Type": "Text",
                            "X": 0.8123,
                            "Y": 0.7896,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000"
                        },
                        {
                            "Type": "Text",
                            "X": 0.8223,
                            "Y": 0.7796,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}

Superposition de texte dans une région spécifiée

Une superposition de texte dans une région spécifiée affiche du texte dans une plage temporelle donnée. La position du texte dans la vidéo de sortie est déterminée par X et Y. L'exemple suivant superpose du texte de 0 à 5 secondes et de 5 à 10 secondes :

  • Si TimelineIn n'est pas défini, la valeur par défaut est 0.

  • Si vous ne définissez pas TimelineOut, la superposition se poursuit jusqu'à la fin de la vidéo par défaut.

  • Si la valeur de TimelineOut dépasse la durée de la vidéo, la superposition s'arrête à la fin de la piste vidéo.

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
                    "Effects": [
                        {
                            "Type": "Text",
                            "X": 31,
                            "Y": 93,
                            "TimelineIn": 0,
                            "TimelineOut": 5,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000",
                            "FontFace": {
                                "Bold": true,
                                "Italic": false,
                                "Underline": false
                            }
                        },
                        {
                            "Type": "Text",
                            "X": 30,
                            "Y": 92,
                            "TimelineIn": 0,
                            "TimelineOut": 5,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "Type": "Text",
                            "X": 1124,
                            "Y": 516,
                            "TimelineIn": 5,
                            "TimelineOut": 10,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000"
                        },
                        {
                            "Type": "Text",
                            "X": 1123,
                            "Y": 515,
                            "TimelineIn": 5,
                            "TimelineOut": 10,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}

Styles de texte artistique

Le texte artistique est un style de légende spécial basé sur des effets de texte de bannière. Exemple :

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaId": "MediaId1",
          "Effects": [
            {
              "Type": "Text",
              "X": 33,
              "Y": 34,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Word art with shadow and outline - First line of test text",
              "OutlineColour": "#ee00ff",
              "BackColour": "#CE1212",
              "EffectColorStyle": "skyline",
              "Angle": 300,
              "Outline": 2,
              "Shadow": 3,
              "FontSize": 42,
              "FontColorOpacity": 1,
              "FontColor": "#000000",
              "FontFace": {
                "Bold": true,
                "Italic": false,
                "Underline": false
              }
            },
            {
              "Type": "Text",
              "X": 66,
              "Y": 256,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Second line of text",
              "EffectColorStyle": "golden",
              "Angle": 60,
              "FontSize": 38,
              "FontColorOpacity": 0.8,
              "FontColor": "#d60e0e"
            },
            {
              "Type": "Text",
              "X": 0.7123,
              "Y": 0.7896,
              "TimelineIn": 5,
              "TimelineOut": 20,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Third line of text",
              "FontSize": 26,
              "FontColor": "#000000"
            }
          ]
        }
      ]
    }
  ]
}

Paramètres du texte artistique

Paramètres

Type

Description

EffectColorStyle

string

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

OutlineColour

string

Couleur du contour. La couleur est une valeur RVB hexadécimale à 6 chiffres au format #xxyyzz.

BackColour

string

Couleur de l'ombre. La couleur est une valeur RVB hexadécimale à 6 chiffres au format #xxyyzz.

Shadow

int

Profondeur de l'ombre en pixels pour le texte artistique. Valeur par défaut : 0. Le ratio recommandé entre la profondeur de l'ombre et la taille de la police est de 2:25. Par exemple, si la taille de la police est de 25, définissez la profondeur de l'ombre sur 2.

Outline

int

Largeur du contour en pixels pour le texte artistique. Valeur par défaut : 0. Le ratio recommandé entre la largeur du contour et la taille de la police est de 2:25. Par exemple, si la taille de la police est de 25, définissez la largeur du contour sur 2.

Spacing

int

Espacement entre les caractères, en pixels.

Angle

float

Angle de pré-rotation de la ligne de sous-titre, en degrés. Valeurs valides : 0 à 360.