この Topic では、OpenAPI を使用してビデオを編集する際の、テキストオーバーレイに関する一般的なタイムライン構成の例を説明します。これらの例には、ビデオの全期間にわたるテキストのオーバーレイや、指定したリージョンでのテキストのオーバーレイが含まれます。
関連 API
パラメーター
パラメーター | 説明 |
テキスト座標 |
値には、パーセンテージまたはピクセル値を指定できます。
|
テキストプロパティ |
|
テキストオーバーレイの時間範囲 |
|
タイムラインの例
全期間のテキストオーバーレイ
全期間のテキストオーバーレイは、ビデオの開始から終了まで表示されます。TimelineIn と TimelineOut を指定する必要はありません。出力ビデオにおけるテキストの位置は、X と Y によって決まります。以下のコードは、その一例です。
{
"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"
}
]
}
]
}
]
}指定リージョンのテキストオーバーレイ
指定リージョンのテキストオーバーレイは、特定の時間範囲内でビデオにテキストを表示します。出力ビデオにおけるテキストの位置は、X と Y によって決まります。以下のコードは、ビデオの 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": "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"
}
]
}
]
}
]
}ワードアートスタイル
ワードアートは、バナーテキストエフェクトに基づいた特殊なテキスト字幕スタイルです。以下のコードは、その一例です。
{
"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"
}
]
}
]
}
]
}ワードアートのパラメーター
パラメーター | タイプ | 説明 |
EffectColorStyle | string | ワードアートスタイルのタイプ。ワードアートのスタイルとエフェクトの詳細については、「ワードアートエフェクトの例」をご参照ください。 |
OutlineColour | string | アウトラインカラー。色は #xxyyzz 形式の 6 桁の 16 進数 RGB 値です。 |
BackColour | string | 影の色。色は #xxyyzz 形式の 6 桁の 16 進数 RGB 値です。 |
Shadow | int | ワードアートの影の深度のピクセル値。デフォルト値は 0 です。影の深度とフォントサイズの推奨比率は 2:25 です。たとえば、フォントサイズが 25 の場合、影の深度を 2 に設定します。 |
Outline | int | ワードアートのアウトラインの幅のピクセル値。デフォルト値は 0 です。アウトラインの幅とフォントサイズの推奨比率は 2:25 です。たとえば、フォントサイズが 25 の場合、アウトラインの幅を 2 に設定します。 |
Spacing | int | 文字間の間隔 (ピクセル単位)。 |
Angle | float | 字幕行の事前回転角度 (度単位)。値は [0, 360] の範囲内である必要があります。 |