このトピックでは、テキストオーバーレイのパラメーターについて説明します。 このトピックでは、フルタイム間隔でのオーバーレイと指定された時間間隔でのオーバーレイの例も示します。 次の例は、テキストオーバーレイ用にタイムラインデータを整理する方法を示しています。

概要

ビデオ編集と、メディア編集サービスの使用方法に関する2つの方法が、[概要] で紹介されています。 ProduceEditingProjectVideo操作を呼び出して、メディア編集サービスを開始および実装できます。 タイムラインは、メディア編集サービスによって処理される重要なデータであり、ビデオ編集のコアオブジェクトです。 タイムラインの内部パラメーターは、さまざまなビジネスシナリオの要件を満たすために複数の方法で整理できます。

Parameters

パラメーター 説明
出力ビデオにオーバーレイされたテキストの座標
  • X: テキストの左上隅と出力ビデオの左上隅との間の水平距離。
  • Y: テキストの左上隅と出力ビデオの左上隅との間の垂直距離。
値をパーセンテージまたはピクセル数に設定できます。
  • 値が0〜0.9999以内の場合、出力ビデオの幅または高さに対するテキストの水平方向または垂直方向のオフセット距離の割合。 Xは幅の割合を示し、Yは高さの割合を示します。
  • 値が8以上の整数である場合、値はピクセルの数を示す。
テキスト属性
  • Content: テキストコンテンツ。
  • フォント: テキストで使用されるフォント。 デフォルト値: SimSun。

    設定可能な値は以下のとおりです。

    • シムサン
    • WenQuanYi Zen Hei
    • WenQuanYi Zen Hei Mono
    • WenQuanYi Zen Heiシャープ
    • ユアンティSCボールド
    • Yuanti SCライト
    • ユアンティSCレギュラー
  • FontSize: フォントサイズ。 単位: ピクセル デフォルト値は 20 です。
  • FontColor: フォントの色。16進カラー値です。 値は数字記号 (#) で始まります。 例: #FFFFFF。 デフォルト値:# FFFFFFFFFont。
  • FontColorOpacity: フォントの色の透明度。 有効な値は 0~1 です。 値1は、色が完全に不透明であることを示します。 値0は、色が完全に透明であることを示します。 デフォルト値:1。
  • FontFace: フォントのスタイルで、次のパラメータが含まれています。
    • 太字: フォントが太字かどうかを指定します。 規定値: false
    • Italic: フォントがイタリックかどうかを指定します。 規定値: false
    • 下線: フォントに下線を付けるかどうかを指定します。 規定値: false
テキストが出力ビデオにオーバーレイされる時間間隔
  • TimelineIn: タイムラインを基準としたテキストの開始時刻。
  • TimelineOut: タイムラインを基準としたテキストの終了時刻。

フルタイム間隔でのオーバーレイの例

このアクションは、ビデオ全体の開始時間から終了時間まで、ビデオにテキストをオーバーレイします。 TimelineInまたはTimelineOutパラメーターを設定する必要はありません。 出力ビデオ内のテキストの位置は、XYで指定されます。例:

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf ****" 、
                    "エフェクト": [
                        {
                            "タイプ": "テキスト" 、
                            "X": 31、
                            "Y": 93、
                            "フォント": "WenQuanYi Zen Hei Mono" 、
                            "コンテンツ": "テストテキスト" 、
                            "FontSize": 26、
                            "FontColorOpacity": 0.2、
                            "FontColor": "#000000" 、
                            "FontFace": {
                                "太字": true、
                                "Italic": false、
                                "下線": false
                            }
                        },
                        {
                            "タイプ": "テキスト" 、
                            "X": 30、
                            "Y": 92、
                            "フォント": "WenQuanYi Zen Hei Mono" 、
                            "コンテンツ": "テストテキスト" 、
                            "FontSize": 26、
                            "FontColorOpacity": 1、
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "タイプ": "テキスト" 、
                            "X": 0.8123、
                            "Y": 0.7896、
                            "フォント": "WenQuanYi Zen Hei Mono" 、
                            "コンテンツ": "テストテキスト" 、
                            "FontSize": 26、
                            "FontColorOpacity": 0.2、
                            "FontColor": "#000000"
                        },
                        {
                            "タイプ": "テキスト" 、
                            "X": 0.8223、
                            "Y": 0.7796、
                            "フォント": "WenQuanYi Zen Hei Mono" 、
                            "コンテンツ": "テストテキスト" 、
                            "FontSize": 26、
                            "FontColorOpacity": 1、
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}

指定した時間間隔でオーバーレイする

このアクションは、ビデオの指定された時間間隔でビデオにテキストをオーバーレイします。 出力ビデオ内のテキストの位置は、XYで指定されます。次のコードは、0秒から5秒まで、および5秒から10秒までのビデオにテキストをオーバーレイする方法の例を示しています。

  • デフォルトでは、TimelineInパラメーターが設定されていない場合、テキストはビデオの開始時刻からオーバーレイされます。
  • デフォルトでは、TimelineOutパラメーターが設定されていない場合、ビデオが終了するまでテキストはオーバーレイされたままになります。
  • TimelineOut値が1つのビデオの合計期間を超える場合、超過時間間隔は自動的に除外され、ビデオの終了時間までテキストがオーバーレイされたままになります。
{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf ****" 、
                    "エフェクト": [
                        {
                            "タイプ": "テキスト" 、
                            "X": 31、
                            "Y": 93、
                            "TimelineIn": 0、
                            "TimelineOut": 5、
                            "フォント": "WenQuanYi Zen Hei Mono" 、
                            "コンテンツ": "テストテキスト" 、
                            "FontSize": 26、
                            "FontColorOpacity": 0.2、
                            "FontColor": "#000000" 、
                            "FontFace": {
                                "太字": true、
                                "Italic": false、
                                "下線": false
                            }
                        },
                        {
                            "タイプ": "テキスト" 、
                            "X": 30、
                            "Y": 92、
                            "TimelineIn": 0,
                            "TimelineOut": 5、
                            "フォント": "WenQuanYi Zen Hei Mono" 、
                            "コンテンツ": "テストテキスト" 、
                            "FontSize": 26、
                            "FontColorOpacity": 1、
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "タイプ": "テキスト" 、
                            "X": 1124、
                            "Y": 516、
                            "TimelineIn": 5、
                            "TimelineOut": 10、
                            "フォント": "WenQuanYi Zen Hei Mono" 、
                            "コンテンツ": "テストテキスト" 、
                            "FontSize": 26、
                            "FontColorOpacity": 0.2、
                            "FontColor": "#000000"
                        },
                        {
                            "タイプ": "テキスト" 、
                            "X": 1123、
                            "Y": 515、
                            "TimelineIn": 5、
                            "TimelineOut": 10、
                            "フォント": "WenQuanYi Zen Hei Mono" 、
                            "コンテンツ": "テストテキスト" 、
                            "FontSize": 26、
                            "FontColorOpacity": 1、
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}