全部產品
Search
文件中心

ApsaraVideo VOD:文字疊加

更新時間:Jul 13, 2024

本文為您介紹通過OpenAPI進行視訊剪輯時文字疊加情境的Timeline常用配置樣本,包括全程疊加文字、指定地區疊加文字等樣本。

相關API

參數說明

參數

說明

文字出現的座標

  • X:文字左上方距離輸出視頻左上方的橫向距離。

  • Y:文字左上方距離輸出視頻左上方的縱向距離。

支持度百分比和像素兩種形式:

  • 當取值範圍為0~0.9999時,表示相對輸出視頻寬/高的佔比(X相對寬,Y相對高)。

  • 當取值為≥8的整數時,表示絕對像素。

文字本身屬性

  • Content:常值內容。

  • Font:字型,該字型不填則預設為宋體。

    目前支援的字型種類有:

    • SimSun:宋體。

    • WenQuanYi Zen Hei:文泉驛正黑。

    • WenQuanYi Zen Hei Mono:文泉驛等寬正黑。

    • WenQuanYi Zen Hei Sharp:文泉驛點陣正黑。

    • Yuanti SC Bold:圓體-簡,粗體。

    • Yuanti SC Light:圓體-簡,細體。

    • Yuanti SC Regular:圓體-簡,常規體。

  • FontSize:字型大小,以像素為單位。該欄位不填則預設為20。

  • FontColor:字型顏色,形式為16進位顏色值,以#開頭,如:#FFFFFF。該欄位不填則預設為#FFFFFF。

  • ColorOpacity:字型顏色的透明度,取值範圍:0~1,1為完全不透明,0為完全透明。該欄位不填則預設為1。

  • FontFace:文字的樣式:

    • Bold:是否加粗。該欄位不填則預設為false。

    • Italic:是否斜體。該欄位不填則預設為false。

    • Underline:是否加底線。該欄位不填則預設為false。

文字在輸出視頻疊加的時間區間

  • TimelineIn:文字相對於時間軸的入點。

  • TimelineOut:文字相對於時間軸的出點。

Timeline樣本

全程疊加文字

全程疊加文字指從標題到片尾疊加文字,即視頻全程疊加文字不需要指定TimelineInTimelineOut,文字在輸出視頻中出現的位置由XY設定。樣本如下:

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
                    "Effects": [
                        {
                            "Type": "Text",
                            "X": 31,
                            "Y": 93,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "測試文字",
                            "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": "測試文字",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "Type": "Text",
                            "X": 0.8123,
                            "Y": 0.7896,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "測試文字",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000"
                        },
                        {
                            "Type": "Text",
                            "X": 0.8223,
                            "Y": 0.7796,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "測試文字",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}

指定地區疊加文字

指定地區疊加文字指文字疊加在視頻的指定時間區間,文字在輸出視頻中出現的位置由XY設定。在一個視頻的第0~5、5~10秒疊加文字,樣本如下:

  • TimelineIn不設定時,預設從0開始。

  • TimelineOut不設定時,預設到視頻的尾部。

  • TimelineOut超過視頻尾部(對單視頻來說,即視頻時間長度)時,超過的時間區間自動被忽略,仍以視頻軌的尾部為準。

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
                    "Effects": [
                        {
                            "Type": "Text",
                            "X": 31,
                            "Y": 93,
                            "TimelineIn": 0,
                            "TimelineOut": 5,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "測試文字",
                            "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": "測試文字",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "Type": "Text",
                            "X": 1124,
                            "Y": 516,
                            "TimelineIn": 5,
                            "TimelineOut": 10,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "測試文字",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000"
                        },
                        {
                            "Type": "Text",
                            "X": 1123,
                            "Y": 515,
                            "TimelineIn": 5,
                            "TimelineOut": 10,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "測試文字",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}

花字樣式

花字是基於橫幅文字特效的一種特殊的文本字幕樣式。樣本如下:

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaId": "MediaId1",
          "Effects": [
            {
              "Type": "Text",
              "X": 33,
              "Y": 34,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "帶陰影帶邊框花字-第一段測試文字",
              "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": "第二段文字",
              "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": "第三段文字",
              "FontSize": 26,
              "FontColor": "#000000"
            }
          ]
        }
      ]
    }
  ]
}

花字參數欄位說明

參數欄位

類型

描述

EffectColorStyle

string

花字樣式類型。更多花字樣式和效果,請參見花字效果樣本

OutlineColour

string

描邊顏色,使用6位十六進位RGB值表示,格式為#xxyyzz。

BackColour

string

陰影顏色,使用6位十六進位RGB值表示,格式為#xxyyzz。

Shadow

int

花字陰影深度的像素值,預設為0。推薦縮放比為2∶25,例如,字型大小設定為25號,則陰影深度設定為2。

Outline

int

花字描邊寬度的像素值,預設為0。推薦縮放比為2∶25,例如,字型大小設定為25號,則描邊寬度設定為2。

Spacing

int

花字字型之間的間距,單位為像素。

Angle

float

字幕行預先旋轉過的角度,取值範圍:[0,360]。