TargetVideo パラメータリファレンス - IMM

パラメーター	タイプ	説明	例
	object	動画処理のパラメーターを指定します。
DisableVideo	boolean	ビデオストリームの生成を無効にするかどうかを指定します。有効値は次のとおりです。 `true`：ビデオストリームを無効にします。出力ファイルにはビデオストリームが含まれません。 `false`（デフォルト）：ビデオストリームを有効にします。	false
Stream	array	処理対象とするソースファイル内のビデオストリームインデックスのリストです。空のまま（デフォルト）の場合、サービスは最も小さいインデックス（最初のビデオストリーム）を持つビデオストリームを処理します。100 を超えるインデックスは、すべてのビデオストリームを処理することを示します。例：`[0,1]` はインデックス 0 および 1 のビデオストリームを処理し、`[1]` はインデックス 1 のビデオストリームを処理し、`[101]` はすべてのビデオストリームを処理します。説明サービスは、既存のビデオストリームに対応しないインデックスを無視します。
	integer	処理対象とするビデオストリームのインデックスです。	0
TranscodeVideo	object	動画トランスコーディングのパラメーターを指定します。このパラメーターを空のままにすると、動画処理が無効になり、出力ファイルにはビデオストリームが含まれません。説明このパラメーターを空にして動画処理を無効にすることは推奨されません。`DisableVideo` パラメーターを使用してください。
Codec	string	ビデオコーデックです。有効値は次のとおりです。 `CreateMediaConvert` API 呼び出しの場合：`copy`（デフォルト）、`h264`、`h265`、および `vp9`。警告このパラメーターを `copy` に設定すると、選択されたビデオストリームは再エンコードせずにそのまま出力ファイルにコピーされます。この場合、TranscodeVideo 配下の他のパラメーターは無視されます。`copy` 値は動画結合には使用できず、通常はリマキシングに使用されます。 `GenerateVideoPlaylist` API 呼び出しの場合：`h264`（デフォルト）および `h265`。	h264
PixelFormat	string	ピクセルフォーマットです。デフォルトではソース動画のピクセルフォーマットが使用されます。有効値は次のとおりです。 `yuv420p` `yuv422p` `yuv444p` `yuv420p10le` `yuv422p10le` `yuv444p10le` `yuva420p` 説明 `yuva420p` 値は `CreateMediaConvert` API 呼び出しでのみ使用可能で、Codec パラメーターが `vp9` である必要があります。	yuv420p
FrameRateOption	string	フレームレートオプションです。有効値は次のとおりです。 `fixed`：常に指定されたターゲットフレームレートを使用します。 `adaptive`：ソースフレームレートがターゲットフレームレートより低い場合は、ソースフレームレートを使用します。 `fall`：ソースフレームレートがターゲットフレームレートより低い場合、タスクは失敗します。デフォルト値： `CreateMediaConvert` API 呼び出しの場合、デフォルトは `fixed` です。 `GenerateVideoPlaylist` API 呼び出しの場合、デフォルトは `adaptive` です。説明このパラメーターは FrameRate パラメーターと併せて設定する必要があります。	fixed
FrameRate	number	ビデオフレームレートです。デフォルトではソース動画のフレームレートが使用されます。	25
ResolutionOption	string	解像度オプションです。有効値は次のとおりです。 `fixed`：常に指定されたターゲット解像度を使用します。 `adaptive`：ソース解像度の面積がターゲット解像度の面積より小さい場合は、ソース解像度を使用します。 `fall`：ソース解像度の面積がターゲット解像度の面積より小さい場合、タスクは失敗します。デフォルト値： `CreateMediaConvert` API 呼び出しの場合、デフォルトは `fixed` です。 `GenerateVideoPlaylist` API 呼び出しの場合、デフォルトは `adaptive` です。説明このパラメーターは Resolution パラメーターと併せて設定する必要があります。	fixed
Resolution	string	出力動画の解像度を `widthxheight` 形式で指定します。デフォルトではソース動画の再生解像度が使用されます。幅、高さ、またはその両方を指定できます。また、AdaptiveResolutionDirection パラメーターを使用して長辺と短辺を設定することも可能です。片側の値は (0, 4096] の範囲内である必要があります。例 1：AdaptiveResolutionDirection が `false` の場合、`1280x720` は幅を 1280、高さを 720 に設定し、`1280x` は幅を 1280 に設定してソースの高さを維持し、`x720` は高さを 720 に設定してソースの幅を維持します。例 2：AdaptiveResolutionDirection が `true` の場合、`1280x720` は長辺を 1280、短辺を 720 に設定し、`1280x` は長辺を 1280 に設定してソースの短辺を維持し、`x720` は短辺を 720 に設定してソースの長辺を維持します。説明ソース動画に回転メタデータが含まれる場合、システムは回転後の動画に基づいて幅、高さ、および長辺・短辺を決定します。これは再生解像度に対応します。	640x480
AdaptiveResolutionDirection	boolean	長辺と短辺に対する適応的サイズ変更を有効にするかどうかを指定します。有効値は次のとおりです。 `true`（デフォルト）：有効。Resolution パラメーターは `long_sidexshort_side` として解釈されます。 `false`：無効。Resolution パラメーターは `widthxheight` として解釈されます。	true
ScaleType	string	スケーリングモードです。有効値は次のとおりです。 `stretch`（デフォルト）：指定されたディメンションに合わせて動画を引き伸ばします。これにより縦横比が変更される可能性があります。 `crop`：動画を比例的に拡大縮小して指定されたディメンション以上になるようにし、その後中央を切り抜きます。 `fill`：動画を比例的に拡大縮小して指定されたディメンション内に収まるようにし、その後黒枠を追加します（中央に配置）。 `fit`：動画を比例的に拡大縮小して指定されたディメンション内に収め、切り抜きや黒枠を追加しません。説明このパラメーターは Resolution パラメーターと併せて設定する必要があります。	crop
Rotation	integer	時計回りの回転角度（度単位）です。有効値は次のとおりです。 `0`（デフォルト） `90` `180` `270`	90
BitrateOption	string	ビデオビットレートオプションです。有効値は次のとおりです。 `fixed`：常に指定されたターゲットビデオビットレートを使用します。 `adaptive`：ソースビデオビットレートがターゲットビデオビットレートより低い場合は、ソースビデオビットレートを使用します。 `fall`：ソースビデオビットレートがターゲットビデオビットレートより低い場合、タスクは失敗します。デフォルト値： `CreateMediaConvert` API 呼び出しの場合、デフォルトは `fixed` です。 `GenerateVideoPlaylist` API 呼び出しの場合、デフォルトは `adaptive` です。説明このパラメーターは Bitrate パラメーターと併せて設定する必要があります。	fixed
Bitrate	integer	ビデオビットレート（bps 単位）です。説明このパラメーターは CRF と相互排他です。このパラメーターと CRF パラメーターの両方が省略された場合、システムはデフォルトの CRF 値 23 で動画をエンコードします。	128000
GOPSize	integer	キーフレーム間隔（フレーム単位）です。デフォルト：150。説明このパラメーターは `GenerateVideoPlaylist` API 呼び出しではサポートされていません。	60
CRF	number	Constant Rate Factor（CRF）を指定します。このパラメーターは Bitrate と相互排他です。有効範囲は [0, 51] です。値が大きいほど品質が低下します。推奨範囲は [18, 38] です。	18
BufferSize	integer	可変ビットレートエンコーディング時のデコードバッファーサイズ（bps 単位）です。説明このパラメーターは CRF パラメーターと併用した場合にのみ有効です。	4000000
MaxBitrate	integer	可変ビットレートエンコーディング時の最大ビットレートを設定します。このパラメーターには `BufferSize` パラメーターが必要です。説明このパラメーターは CRF パラメーターと併用した場合にのみ有効です。	128000
BFrames	integer	連続 B フレーム数です。デフォルト：3。	3
Refs	integer	リファレンスフレーム数です。デフォルト：2。	2
VideoSlim	integer	Video Slim モードを有効にするかどうかを指定します。有効値は次のとおりです。 `0`：（デフォルト）無効。 `1`：有効。Video Slim モードで動画をトランスコードします。説明最適な結果を得るには、Video Slim によるトランスコード時に推奨される `Bitrate` または `CRF` パラメーターを使用してください。重要 Video Slim は H.264 および H.265 コーデック、`yuv420p` ピクセルフォーマット、および 8 ビット深度のみをサポートしています。複数のターゲット動画出力へのトランスコードや動画結合はサポートしていません。詳細については、「Video Slim」をご参照ください。	0
FilterVideo	object	動画フィルタリングのパラメーターを指定します。TranscodeVideo が空であるか、TranscodeVideo.Codec が `copy` の場合、このパラメーターは無視されます。説明このパラメーターは `GenerateVideoPlaylist` API 呼び出しではサポートされていません。
Watermarks	array	適用する動画ウォーターマークのリストです。
	object	動画ウォーターマークの構成です。
Type	string	ウォーターマークのタイプです。有効値は次のとおりです。 `text`（デフォルト）：テキストウォーターマーク。 `file`：画像またはアニメーションウォーターマーク。	text
Dx	number	水平方向のオフセットです。値の解釈はその型によって異なります。 `0`（デフォルト）：オフセットなし。整数：ピクセル（px）単位のオフセット。有効範囲：[1, 4096]。 10 進数：出力動画の幅に対する比率で指定されたオフセット。有効範囲：(0, 1)。	0
Dy	number	垂直方向のオフセットです。値の解釈はその型によって異なります。 `0`（デフォルト）：オフセットなし。整数：ピクセル（px）単位のオフセット。有効範囲：[1, 4096]。 10 進数：出力動画の高さに対する比率で指定されたオフセット。有効範囲：(0, 1)。	0
StartTime	number	ウォーターマークが最初に表示される時刻（秒単位）です。デフォルトでは、動画の開始時に表示されます。	0
Duration	number	ウォーターマークを表示する持続時間（秒単位）です。デフォルトでは、動画の終了まで表示され続けます。	0
ReferPos	string	ウォーターマークの基準位置です。有効値は次のとおりです。 `topleft`（デフォルト）：左上隅。 `topright`：右上隅。 `bottomright`：右下隅。 `bottomleft`：左下隅。	topleft
Content	string	テキストウォーターマークの内容です。デフォルト：空。重要このパラメーターは `Type` が `text` の場合にのみ有効です。	example
FontName	string	テキストウォーターマークのフォント名です。有効値は次のとおりです。 `SourceHanSans-Regular`（デフォルト） `SourceHanSans-Bold` `SourceHanSerif-Regular` `SourceHanSerif-Bold` 重要このパラメーターは `Type` が `text` の場合にのみ有効です。	SourceHanSans-Bold
FontSize	integer	テキストウォーターマークのフォントサイズです。値は (4, 120) の範囲内の整数である必要があります。デフォルト：16。重要このパラメーターは `Type` が `text` の場合にのみ有効です。	18
FontColor	string	テキストウォーターマークのフォント色です。値は `#RRGGBB` 形式または `red` や `green` などの色名で指定できます。デフォルト：`#000000`。重要このパラメーターは `Type` が `text` の場合にのみ有効です。	red
FontApha	number	テキストウォーターマークのフォントアルファ（透明度）です。値は (0, 1] の範囲内である必要があります。1（デフォルト）はテキストが完全に不透明であることを意味します。重要このパラメーターは `Type` が `text` の場合にのみ有効です。	0.8
BorderWidth	integer	テキストウォーターマークの罫線幅（ピクセル単位）です。値は [0, 4096] の範囲内の整数である必要があります。デフォルト：0。重要このパラメーターは `Type` が `text` の場合にのみ有効です。	2
BorderColor	string	テキストウォーターマークの罫線色です。値は `#RRGGBB` 形式または `red` や `green` などの色名で指定できます。デフォルト：`#000000`。重要このパラメーターは `Type` が `text` の場合にのみ有効です。	red
URI	string	ウォーターマークファイルの OSS URI です。サポートされている形式は PNG および MOV です。 OSS URI は `oss://<bucket>/<object>` 形式に従う必要があります。ここで、`<bucket>` は現在のプロジェクトと同じリージョンにある OSS バケットの名前であり、`<object>` は拡張子を含むファイルの完全なパスです。重要このパラメーターは `Type` が `file` の場合にのみ有効です。	oss://test-bucket/watermark.jpg
Width	number	ウォーターマーク画像の幅です。デフォルトでは、ウォーターマーク画像の元の幅が使用されます。値の解釈はその型によって異なります。整数：ピクセル（px）単位の幅。有効範囲：[1, 4096]。 10 進数：出力動画の幅に対する比率で指定された幅。有効範囲：(0, 1)。	80
Height	number	ウォーターマーク画像の高さです。デフォルトでは、ウォーターマーク画像の元の高さが使用されます。値の解釈はその型によって異なります。整数：ピクセル（px）単位の高さ。有効範囲：[1, 4096]。 10 進数：出力動画の高さに対する比率で指定された高さ。有効範囲：(0, 1)。	40
Delogos	array	動画の矩形領域にぼかし効果を適用します。通常、ロゴや画面上のグラフィックを削除するために使用されます。
	object	動画ぼかしのパラメーターです。
StartTime	number	ぼかし効果を適用する開始時刻（秒単位）です。デフォルトでは、動画の開始から効果が適用されます。	0
Duration	number	ぼかし効果を適用する持続時間（秒単位）です。デフォルトでは、動画の終了まで効果が続きます。	15
Dx	number	水平方向のオフセットです。値の解釈はその型によって異なります。 `0`（デフォルト）：オフセットなし。整数：ピクセル（px）単位のオフセット。有効範囲：[1, 4096]。 10 進数：出力動画の幅に対する比率で指定されたオフセット。有効範囲：(0, 1)。	0
Dy	number	垂直方向のオフセットです。値の解釈はその型によって異なります。 `0`（デフォルト）：オフセットなし。整数：ピクセル（px）単位のオフセット。有効範囲：[1, 4096]。 10 進数：出力動画の高さに対する比率で指定されたオフセット。有効範囲：(0, 1)。	0
Width	number	ぼかし領域の幅です。デフォルトでは、値は 1.0（10 進数）で、出力動画の全幅をカバーします。値の解釈はその型によって異なります。整数：ピクセル（px）単位の幅。有効範囲：[1, 4096]。 10 進数：出力動画の幅に対する比率で指定された幅。有効範囲：(0, 1)。	100
Height	number	ぼかし領域の高さです。デフォルトでは、値は 1.0（10 進数）で、出力動画の全高をカバーします。値の解釈はその型によって異なります。整数：ピクセル（px）単位の高さ。有効範囲：[1, 4096]。 10 進数：出力動画の高さに対する比率で指定された高さ。有効範囲：(0, 1)。	40
ReferPos	string	ぼかし領域の基準位置です。有効値は次のとおりです。 `topleft`（デフォルト）：左上隅。 `topright`：右上隅。 `bottomright`：右下隅。 `bottomleft`：左下隅。	topleft
Speed	number	動画再生速度の倍率です。有効範囲は [0.5, 1.0] です。デフォルト：1.0。説明このパラメーターは、トランスコード後のファイルの再生速度とソースファイルの再生速度の比率を設定します。速度トランスコーディングは実行しません。重要このパラメーターは `CreateMediaConvertTask` API 呼び出しでのみ適用されます。	1.0
Desensitization	object	動画の機微情報マスキング設定を指定します。重要このパラメーターは `CreateMediaConvertTask` API 呼び出しでのみ適用されます。
Face	object	顔の機微情報マスキング設定を指定します。説明この機能はパブリックベータ版です。ご質問がある場合は、フィードバック用の DingTalk グループにご参加ください。グループ番号については、「お問い合わせ」をご参照ください。
Confidence	number	顔検出の信頼度しきい値です。このしきい値未満の信頼度スコアを持つ顔はマスキングされません。有効範囲：0.0 ～ 1.0。デフォルト：0.0（信頼度フィルタリングなし）。	0.4
MinSize	integer	最小顔サイズしきい値です。このしきい値未満の幅または高さを持つ顔はマスキングされません。単位：ピクセル。デフォルト：0（サイズ制限なし）。	0.4
LicensePlate	object	ナンバープレートの機微情報マスキング設定を指定します。説明この機能はパブリックベータ版です。ご質問がある場合は、フィードバック用の DingTalk グループにご参加ください。グループ番号については、「お問い合わせ」をご参照ください。
Confidence	number	ナンバープレート検出の信頼度しきい値です。このしきい値未満の信頼度スコアを持つナンバープレートはマスキングされません。有効範囲：0.0 ～ 1.0。デフォルト：0.0（信頼度フィルタリングなし）。	0.4
MinSize	integer	最小ナンバープレートサイズしきい値です。このしきい値未満の幅または高さを持つナンバープレートはマスキングされません。単位：ピクセル。デフォルト：0（サイズ制限なし）。	0.4

object

動画処理のパラメーターを指定します。

DisableVideo

boolean

ビデオストリームの生成を無効にするかどうかを指定します。有効値は次のとおりです。

true：ビデオストリームを無効にします。出力ファイルにはビデオストリームが含まれません。
false（デフォルト）：ビデオストリームを有効にします。

false

Stream

array

処理対象とするソースファイル内のビデオストリームインデックスのリストです。空のまま（デフォルト）の場合、サービスは最も小さいインデックス（最初のビデオストリーム）を持つビデオストリームを処理します。100 を超えるインデックスは、すべてのビデオストリームを処理することを示します。

例：[0,1] はインデックス 0 および 1 のビデオストリームを処理し、[1] はインデックス 1 のビデオストリームを処理し、[101] はすべてのビデオストリームを処理します。

説明

サービスは、既存のビデオストリームに対応しないインデックスを無視します。

integer

処理対象とするビデオストリームのインデックスです。

0

TranscodeVideo

object

動画トランスコーディングのパラメーターを指定します。このパラメーターを空のままにすると、動画処理が無効になり、出力ファイルにはビデオストリームが含まれません。

説明

このパラメーターを空にして動画処理を無効にすることは推奨されません。DisableVideo パラメーターを使用してください。

Codec

string

ビデオコーデックです。有効値は次のとおりです。

CreateMediaConvert API 呼び出しの場合：copy（デフォルト）、h264、h265、および vp9。
警告このパラメーターを copy に設定すると、選択されたビデオストリームは再エンコードせずにそのまま出力ファイルにコピーされます。この場合、TranscodeVideo 配下の他のパラメーターは無視されます。copy 値は動画結合には使用できず、通常はリマキシングに使用されます。
GenerateVideoPlaylist API 呼び出しの場合：h264（デフォルト）および h265。

h264

PixelFormat

string

ピクセルフォーマットです。デフォルトではソース動画のピクセルフォーマットが使用されます。有効値は次のとおりです。

yuv420p
yuv422p
yuv444p
yuv420p10le
yuv422p10le
yuv444p10le
yuva420p

説明

yuva420p 値は CreateMediaConvert API 呼び出しでのみ使用可能で、Codec パラメーターが vp9 である必要があります。

yuv420p

FrameRateOption

string

フレームレートオプションです。有効値は次のとおりです。

fixed：常に指定されたターゲットフレームレートを使用します。
adaptive：ソースフレームレートがターゲットフレームレートより低い場合は、ソースフレームレートを使用します。
fall：ソースフレームレートがターゲットフレームレートより低い場合、タスクは失敗します。

デフォルト値：

CreateMediaConvert API 呼び出しの場合、デフォルトは fixed です。
GenerateVideoPlaylist API 呼び出しの場合、デフォルトは adaptive です。

説明

このパラメーターは FrameRate パラメーターと併せて設定する必要があります。

fixed

FrameRate

number

ビデオフレームレートです。デフォルトではソース動画のフレームレートが使用されます。

25

ResolutionOption

string

解像度オプションです。有効値は次のとおりです。

fixed：常に指定されたターゲット解像度を使用します。
adaptive：ソース解像度の面積がターゲット解像度の面積より小さい場合は、ソース解像度を使用します。
fall：ソース解像度の面積がターゲット解像度の面積より小さい場合、タスクは失敗します。

デフォルト値：

CreateMediaConvert API 呼び出しの場合、デフォルトは fixed です。
GenerateVideoPlaylist API 呼び出しの場合、デフォルトは adaptive です。

説明

このパラメーターは Resolution パラメーターと併せて設定する必要があります。

fixed

Resolution

string

出力動画の解像度を widthxheight 形式で指定します。デフォルトではソース動画の再生解像度が使用されます。幅、高さ、またはその両方を指定できます。また、AdaptiveResolutionDirection パラメーターを使用して長辺と短辺を設定することも可能です。片側の値は (0, 4096] の範囲内である必要があります。

例 1：AdaptiveResolutionDirection が false の場合、1280x720 は幅を 1280、高さを 720 に設定し、1280x は幅を 1280 に設定してソースの高さを維持し、x720 は高さを 720 に設定してソースの幅を維持します。
例 2：AdaptiveResolutionDirection が true の場合、1280x720 は長辺を 1280、短辺を 720 に設定し、1280x は長辺を 1280 に設定してソースの短辺を維持し、x720 は短辺を 720 に設定してソースの長辺を維持します。

説明

ソース動画に回転メタデータが含まれる場合、システムは回転後の動画に基づいて幅、高さ、および長辺・短辺を決定します。これは再生解像度に対応します。

640x480

AdaptiveResolutionDirection

boolean

長辺と短辺に対する適応的サイズ変更を有効にするかどうかを指定します。有効値は次のとおりです。

true（デフォルト）：有効。Resolution パラメーターは long_sidexshort_side として解釈されます。
false：無効。Resolution パラメーターは widthxheight として解釈されます。

true

ScaleType

string

スケーリングモードです。有効値は次のとおりです。

stretch（デフォルト）：指定されたディメンションに合わせて動画を引き伸ばします。これにより縦横比が変更される可能性があります。
crop：動画を比例的に拡大縮小して指定されたディメンション以上になるようにし、その後中央を切り抜きます。
fill：動画を比例的に拡大縮小して指定されたディメンション内に収まるようにし、その後黒枠を追加します（中央に配置）。
fit：動画を比例的に拡大縮小して指定されたディメンション内に収め、切り抜きや黒枠を追加しません。

説明

このパラメーターは Resolution パラメーターと併せて設定する必要があります。

crop

Rotation

integer

時計回りの回転角度（度単位）です。有効値は次のとおりです。

0（デフォルト）
90
180
270

90

BitrateOption

string

ビデオビットレートオプションです。有効値は次のとおりです。

fixed：常に指定されたターゲットビデオビットレートを使用します。
adaptive：ソースビデオビットレートがターゲットビデオビットレートより低い場合は、ソースビデオビットレートを使用します。
fall：ソースビデオビットレートがターゲットビデオビットレートより低い場合、タスクは失敗します。

デフォルト値：

CreateMediaConvert API 呼び出しの場合、デフォルトは fixed です。
GenerateVideoPlaylist API 呼び出しの場合、デフォルトは adaptive です。

説明

このパラメーターは Bitrate パラメーターと併せて設定する必要があります。

fixed

Bitrate

integer

ビデオビットレート（bps 単位）です。

説明

このパラメーターは CRF と相互排他です。このパラメーターと CRF パラメーターの両方が省略された場合、システムはデフォルトの CRF 値 23 で動画をエンコードします。

128000

GOPSize

integer

キーフレーム間隔（フレーム単位）です。デフォルト：150。

説明

このパラメーターは GenerateVideoPlaylist API 呼び出しではサポートされていません。

60

CRF

number

Constant Rate Factor（CRF）を指定します。このパラメーターは Bitrate と相互排他です。有効範囲は [0, 51] です。値が大きいほど品質が低下します。推奨範囲は [18, 38] です。

18

BufferSize

integer

可変ビットレートエンコーディング時のデコードバッファーサイズ（bps 単位）です。

説明

このパラメーターは CRF パラメーターと併用した場合にのみ有効です。

4000000

MaxBitrate

integer

可変ビットレートエンコーディング時の最大ビットレートを設定します。このパラメーターには BufferSize パラメーターが必要です。

説明

このパラメーターは CRF パラメーターと併用した場合にのみ有効です。

128000

BFrames

integer

連続 B フレーム数です。デフォルト：3。

3

Refs

integer

リファレンスフレーム数です。デフォルト：2。

2

VideoSlim

integer

Video Slim モードを有効にするかどうかを指定します。有効値は次のとおりです。

0：（デフォルト）無効。

1：有効。Video Slim モードで動画をトランスコードします。

説明

最適な結果を得るには、Video Slim によるトランスコード時に推奨される Bitrate または CRF パラメーターを使用してください。

重要 Video Slim は H.264 および H.265 コーデック、yuv420p ピクセルフォーマット、および 8 ビット深度のみをサポートしています。複数のターゲット動画出力へのトランスコードや動画結合はサポートしていません。詳細については、「Video Slim」をご参照ください。

0

FilterVideo

object

動画フィルタリングのパラメーターを指定します。TranscodeVideo が空であるか、TranscodeVideo.Codec が copy の場合、このパラメーターは無視されます。

説明

このパラメーターは GenerateVideoPlaylist API 呼び出しではサポートされていません。

Watermarks

array

適用する動画ウォーターマークのリストです。

object

動画ウォーターマークの構成です。

Type

string

ウォーターマークのタイプです。有効値は次のとおりです。

text（デフォルト）：テキストウォーターマーク。
file：画像またはアニメーションウォーターマーク。

text

Dx

number

水平方向のオフセットです。値の解釈はその型によって異なります。

0（デフォルト）：オフセットなし。
整数：ピクセル（px）単位のオフセット。有効範囲：[1, 4096]。
10 進数：出力動画の幅に対する比率で指定されたオフセット。有効範囲：(0, 1)。

0

Dy

number

垂直方向のオフセットです。値の解釈はその型によって異なります。

0（デフォルト）：オフセットなし。
整数：ピクセル（px）単位のオフセット。有効範囲：[1, 4096]。
10 進数：出力動画の高さに対する比率で指定されたオフセット。有効範囲：(0, 1)。

0

StartTime

number

ウォーターマークが最初に表示される時刻（秒単位）です。デフォルトでは、動画の開始時に表示されます。

0

Duration

number

ウォーターマークを表示する持続時間（秒単位）です。デフォルトでは、動画の終了まで表示され続けます。

0

ReferPos

string

ウォーターマークの基準位置です。有効値は次のとおりです。

topleft（デフォルト）：左上隅。
topright：右上隅。
bottomright：右下隅。
bottomleft：左下隅。

topleft

Content

string

テキストウォーターマークの内容です。デフォルト：空。