オンライン編集データ型-古いエディター - ApsaraVideo VOD

このトピックでは、ApsaraVideo VODのオンライン編集に関連するAPI操作のデータ型について説明します。

EditingProject: オンライン編集プロジェクトに関する情報

パラメーター	タイプ	説明
ProjectId	String	オンライン編集プロジェクトのID。
タイトル	String	オンライン編集プロジェクトのタイトル。
CreationTime	String	オンライン編集プロジェクトが作成された時刻。日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。時刻は UTC で表示されます。たとえば、値2017-01-11T12:00:00Zは、2017年1月11日の20:00:00を示します。
ModifiedTime	String	オンライン編集プロジェクトが最後に変更された時刻。日時は ISO 8601 規格 (yyyy-MM-ddTHH:mm:ssZ 形式) に準拠します。時刻は UTC で表示されます。たとえば、値2017-01-11T12:00:00Zは、2017年1月11日の20:00:00を示します。
Status	String	オンライン編集プロジェクトのステータス。
説明	String	オンライン編集プロジェクトの説明。
タイムライン	String	オンライン編集プロジェクトのタイムライン。値はJSON文字列です。
有効期間	String	オンライン編集プロジェクトの期間。期間はタイムラインの期間と同じでなければなりません。
CoverURL	String	オンライン編集プロジェクトのサムネイルURL。

タイムライン: オンライン編集プロジェクトのタイムラインに関する情報

パラメーター	タイプ	説明
Id	String	オンライン編集プロジェクトのID。
タイトル	String	オンライン編集プロジェクトのタイトル。
CreationTime	String	タイムラインが作成された時刻。
ModifiedTime	String	タイムラインが最後に変更された時刻。
有効期間	Float	タイムラインの合計期間。単位は秒です。値は小数点以下4桁まで正確です。
CurrentRuler	Float	タイムライン定規のサイズ。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。
CurrentPosition	Float	オンライン編集プロジェクトの再生ヘッドの現在の位置。単位は秒です。値は小数点以下4桁まで正確です。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。
VideoTracks	VideoTrack []	ビデオトラック。

VideoTrack: ビデオトラックに関する情報

パラメーター	タイプ	説明
集計	Int	ビデオクリップの総数。
有効期間	String	ビデオトラックの合計時間。
VideoTrackClips	VideoTrackClip []	ビデオクリップ。

VideoTrackClip: ビデオクリップに関する情報

パラメーター	タイプ	説明
Id	String	ビデオクリップのID。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。タイムラインを使用してデータを編集する場合は、このパラメーターをタイムライン内で一意の値に設定する必要があります。
VideoId	String	クリップのビデオID。
タイプ	String	クリップのタイプ。有効な値：ビデオイメージデフォルト値: Video。
タイトル	String	ビデオクリップのタイトル。タイトルはビデオのタイトルと同じでなければなりません。
Index	Int	タイムライン内のビデオクリップのシーケンス番号。シーケンス番号はゼロから始まります。
CutFlag	Boolean	ビデオクリップをトリミングするかどうかを指定します。有効な値は、true および false です。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。
TextFlag	Boolean	バナーテキストをビデオクリップに追加するかどうかを指定します。有効な値は、true および false です。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。
DeWatermarkFlag	Boolean	ビデオクリップの一部をマスクするかどうかを指定します。有効な値は、true および false です。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。
URL	String	ビデオクリップの編集に使用されるストリームのURL。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。
CoverURL	String	ビデオクリップのサムネイルURL。デフォルトでは、このサムネイルURLはビデオのものと同じです。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。
SpriteURL	String	ビデオクリップのスプライトスナップショットURL。複数のURLはコンマ (,) で区切ります。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。
幅	Int	ビデオクリップを編集するストリームの幅。単位: ピクセル。このパラメーターは、バナーのテキストやマスクなどの特殊効果のないビデオ制作にのみタイムラインを使用する場合はオプションです。
Height	Int	ビデオクリップを編集するストリームの高さ。単位: ピクセル。このパラメーターは、バナーのテキストやマスクなどの特殊効果のないビデオ制作にのみタイムラインを使用する場合はオプションです。
FPS	Float	ビデオクリップのフレームレート。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。
ビットレート	Float	ビデオクリップを編集するストリームのビットレート。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。
この場合、顧客 ID、つまり MD5 (customer-id) のハッシュ値を計算し、ファイル名のプレフィックスとして数文字のハッシュプレフィックスを組み合わせることができます。	Float	ビデオ内のビデオクリップの開始時刻。単位は秒です。値は小数点以下4桁まで正確です。
アウト	Float	ビデオ内のビデオクリップの終了時刻。単位は秒です。値は小数点以下4桁まで正確です。
有効期間	Float	ビデオクリップの長さ。単位は秒です。値は小数点以下4桁まで正確です。
VirginDuration	Float	ビデオクリップが属するビデオの合計期間。単位は秒です。値は小数点以下4桁まで正確です。タイムラインがビデオ制作にのみ使用される場合、このパラメーターはオプションです。
TimelineIn	Float	タイムラインでのビデオクリップの開始時刻。単位は秒です。値は小数点以下4桁まで正確です。
TimelineOut	Float	タイムラインでのビデオクリップの終了時刻。単位は秒です。値は小数点以下4桁まで正確です。
効果	効果 []	ビデオクリップに追加されたエフェクト。

エフェクト: エフェクトに関する情報

パラメーター	タイプ	説明
タイプ	String	エフェクトのタイプ。有効な値：テキスト: ビデオクリップにバナーテキストを追加します。 DeWatermark: ビデオクリップの特定の部分をマスクします。
名前	String	エフェクトの名前。
サブタイプ	String	エフェクトのサブタイプ。 TypeパラメーターがDeWatermarkに設定されている場合、このパラメーターはDelogo_Blurに設定されます。
この場合、顧客 ID、つまり MD5 (customer-id) のハッシュ値を計算し、ファイル名のプレフィックスとして数文字のハッシュプレフィックスを組み合わせることができます。	Float	ビデオクリップに追加されたエフェクトの開始時刻。単位は秒です。値は小数点以下4桁まで正確です。
アウト	Float	ビデオクリップに追加されたエフェクトの終了時刻。単位は秒です。値は小数点以下4桁まで正確です。
TimelineIn	Float	タイムラインでのエフェクトの開始時刻。単位は秒です。値は小数点以下4桁まで正確です。
TimelineOut	Float	タイムラインでのエフェクトの終了時刻。単位は秒です。値は小数点以下4桁まで正確です。
X	String	エフェクトのX座標。ビデオ画像の左上隅は、座標原点として使用される。値は整数または小数にすることができます。値が整数の場合、値は8から4096の範囲です。単位: ピクセル。値が10進数の場合、値は0〜1の範囲で、出力ビデオの幅に対する効果領域の幅の比率を示します。 10進数は、0.9999など、小数点第4位まで正確にすることができます。余分な数字は自動的に削除されます。
Y	String	エフェクトのY座標。ビデオ画像の左上隅は、座標原点として使用される。値は整数または小数にすることができます。値が整数の場合、値は8から4096の範囲です。単位: ピクセル。値が10進数の場合、値は0〜1の範囲で、出力ビデオの高さに対する効果領域の高さの比率を示します。 10進数は、0.9999など、小数点第4位まで正確にすることができます。余分な数字は自動的に削除されます。
幅	Int	エフェクトが追加される領域の幅。値は整数または小数にすることができます。値が整数の場合、値は8から4096の範囲です。単位: ピクセル。値が10進数の場合、値は0から1の範囲であり、出力ビデオの幅に対する効果領域の幅の比率を示します。 10進数は、0.9999など、小数点第4位まで正確にすることができます。余分な数字は自動的に削除されます。
Height	Int	エフェクトが追加される領域の高さ。値は整数または小数にすることができます。値が整数の場合、値は8から4096の範囲です。単位: ピクセル。値が10進数の場合、値は0〜1の範囲で、出力ビデオの高さに対する効果領域の高さの比率を示します。 10進数は、0.9999など、小数点第4位まで正確にすることができます。余分な数字は自動的に削除されます。
FEWidth	Float	編集中のビデオ画像の表示幅。単位: ピクセル。
FEHeight	Float	編集中に表示されるビデオ画像の高さ。単位: ピクセル。
フォント	String	フォント。値をSimSunに設定します。
フォントフェイス	FontFace	フォントの外観。
FontColor	String	フォントの色。値は、16進形式の数値記号 (#) で始まる必要があります。例: #ffffff.
FontSize	Int	フォントのサイズ。
FontColorOpacity	Float	フォントの透明度。有効な値は 0～1 です。 1はフォントが透明でないことを示し、0はフォントが完全に透明であることを示します。
Content	String	バナーテキストの内容。

FontFace: フォントスタイル

パラメーター	タイプ	説明
太さ	Boolean	フォントが太字かどうかを示します。
イタリック	Boolean	フォントが斜体かどうかを示します。
下線	Boolean	フォントに下線が付いているかどうかを示します。

MediaMetadata: メディアリソースのメタデータ

パラメーター	タイプ	説明
タイトル	String	制作されたビデオのタイトル。値の長さは最大128バイトで、UTF-8でエンコードする必要があります。
説明	String	作成されたビデオの説明。値の長さは最大1,024バイトで、UTF-8でエンコードする必要があります。
CoverURL	String	作成されたビデオのカスタムサムネイルのURL。
CateId	String	作成されたビデオのカテゴリID。カテゴリIDを変更または表示するには、次の操作を実行します。ApsaraVideo VODコンソールにログインします。左側のナビゲーションウィンドウで、[設定管理] > [メディア管理] > [カテゴリ] を選択します。
タグ	String	制作されたビデオのタグ。各タグ名の長さは最大32バイトです。最大16個のタグを指定できます。複数入力する場合は、コンマ (,) で区切ります。文字列はUTF-8形式でエンコードする必要があります。

ProduceConfig: 構成のビデオ制作

パラメーター	タイプ	説明
TemplateGroupId	String	生成されたビデオのトランスコードに使用されるトランスコードテンプレートグループのID。生成されたビデオファイルは、トランスコードのソースファイルとして使用されます。コード変換プロセスは、ファイルがアップロードされた後に実行されるプロセスと同様です。このパラメーターはオプションです。このパラメーターを空のままにすると、デフォルトのテンプレートグループがトランスコードに使用されます。このパラメーターを指定すると、指定されたテンプレートグループがトランスコードに使用されます。テンプレートグループIDを表示するには、ApsaraVideo VODコンソールの [トランスコードテンプレートグループ] ページに移動します。
TemplateId	String	ビデオ制作に使用されるテンプレートのID。生成されたメディアファイルは、メディアリソースのソースファイルとして使用される。このパラメーターはオプションです。このパラメーターを空のままにすると、ApsaraVideo VODはビデオ制作に組み込みのオンライン編集テンプレートを使用します。ビデオファイルを作成する場合、組み込みテンプレートのエンコード形式はH.264、コンテナ形式はMP4です。動画制作用のカスタムパラメータを作成する場合は、Yidaでリクエストを送信してください。たとえば、アニメーションステッカーを作成したり、字幕をインテリジェントに作成したり、M3U8プレイリストに基づいてビデオを編集したり、カスタム制作パラメータを使用したりする場合は、Yidaにリクエストを送信して特定のテンプレートを申請します。
幅	Integer	生成されたビデオの幅。単位: ピクセル。このパラメーターはオプションです。デフォルトの幅は、タイムラインで使用されるビデオクリップのソースファイルの最大幅です。たとえば、タイムラインでは3つのビデオクリップが使用されます。ソースファイルの解像度は、1280 × 720ピクセル、1920 × 1080ピクセル、720 × 1280ピクセルです。この場合、生成される映像の出力解像度は1920 × 1280画素となります。
Height	Integer	制作されたビデオの高さ。単位: ピクセル。このパラメーターはオプションです。デフォルトの幅は、タイムラインで使用されるビデオクリップのソースファイルの最大幅です。たとえば、タイムラインでは3つのビデオクリップが使用されます。ソースファイルの解像度は、1280 × 720ピクセル、1920 × 1080ピクセル、720 × 1280ピクセルです。この場合、生成される映像の出力解像度は1920 × 1280画素となります。
StorageLocation	String	生成されたファイルの格納アドレス。このパラメータは、生成されたファイルが中国 (上海) 以外のリージョンに格納されている場合に必要です。

素材: オンライン編集プロジェクトの素材に関する情報

説明

オンライン編集プロジェクトの資料は、メディアライブラリ内のメディアアセットまたはビデオの資料です。

パラメーター	タイプ	説明
MaterialId	String	マテリアルのID。
タイトル	String	素材のタイトル。
説明	String	材料の説明。
有効期間	Float	材料の持続時間。単位は秒です。値は小数点以下4桁まで正確です。
CoverURL	String	マテリアルのサムネイルURL。
Status	String	マテリアルのステータス。
CreationTime	String	マテリアルが作成された時刻。時刻は UTC で表示されます。
Size	Long	ソースファイルのサイズ。単位はバイトです。
CateId	Long	マテリアルのカテゴリID。
CateName	String	マテリアルのカテゴリ名。
タグ	String	材料のタグ。複数のタグはコンマ (,) で区切ります。
スナップショット	String[]	マテリアルスナップショットのURL。値は配列です。
スプライト	String[]	マテリアルスプライトのスナップショットのURL。値は配列です。

ProjectStatus: オンライン編集プロジェクトのステータス

有効値	説明	補足
正常	オンライン編集プロジェクトがドラフトステータスになっています。	これは、オンライン編集プロジェクトの初期ステータスです。
制作	ビデオ制作が行われています。	なし。
生産	ビデオ制作は成功しています。	なし。
ProduceFaile	ビデオの制作に失敗しました。	なし。