Image interface
入力ビデオからサムネイルを生成するための基本的なプロパティについて説明します
- Extends
プロパティ
| odata |
ポリモーフィック判別器。このオブジェクトで使用できるさまざまな型を指定します。 |
| range | サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止する PT5M30S)、またはフレーム数 (たとえば、300 は、開始時刻のフレームから 300 番目のフレームで停止する場合) です。この値が 1 の場合は、開始時に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム期間の半分で停止する場合は 50%) を意味します。 既定値は 100% です。これは、ストリームの末尾で停止することを意味します。 |
| start | サムネイルの生成を開始する場所からの入力ビデオ内の位置。 この値は、ISO 8601 形式 (たとえば、PT05S の場合は 5 秒で開始する)、フレーム数 (たとえば、10 の場合は 10 番目のフレームで開始する)、またはストリーム期間に対する相対値 (たとえば、10% の場合はストリーム期間の 10% で開始する) とすることができます。 また、マクロ {Best} もサポートされています。これにより、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示が送られ、ステップと範囲の他の設定に関係なく、1 つのサムネイルのみが生成されることになります。 既定値はマクロ {Best} です。 |
| step | サムネイルが生成される間隔。 この値は、ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、フレーム数 (30 フレームごとに 1 つのイメージの場合は 30)、またはストリーム期間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10% のイメージ) にすることができます。 注: ステップ値は、最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは異なることがあります。 これは、最初の出力として開始時刻からステップ位置までの間で最適なサムネイルを選択しようとするエンコーダーが原因です。 既定値は 10% であるため、ストリームの期間が長い場合は、最初に生成されたサムネイルが起動時に指定されたものから遠く離れている可能性があることを意味します。 最初のサムネイルが開始時刻に近づくと予想される場合は[ステップ] に適切な値を選択し、開始時にサムネイルが 1 つだけ必要な場合は Range 値を 1 に設定します。 |
継承されたプロパティ
| key |
2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。 |
| label | コーデックの省略可能なラベル。 ラベルを使用して、多重化の動作を制御できます。 |
| stretch |
サイズ変更モード - 入力ビデオを目的の出力解像度に合わせてサイズ変更する方法。 既定値は AutoSize です |
| sync |
ビデオ同期モード |
プロパティの詳細
odataType
ポリモーフィック判別器。このオブジェクトで使用できるさまざまな型を指定します。
odataType: "#Microsoft.Media.Image" | "#Microsoft.Media.JpgImage" | "#Microsoft.Media.PngImage"プロパティ値
"#Microsoft.Media.Image" | "#Microsoft.Media.JpgImage" | "#Microsoft.Media.PngImage"
range
サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止する PT5M30S)、またはフレーム数 (たとえば、300 は、開始時刻のフレームから 300 番目のフレームで停止する場合) です。この値が 1 の場合は、開始時に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム期間の半分で停止する場合は 50%) を意味します。 既定値は 100% です。これは、ストリームの末尾で停止することを意味します。
range?: stringプロパティ値
string
start
サムネイルの生成を開始する場所からの入力ビデオ内の位置。 この値は、ISO 8601 形式 (たとえば、PT05S の場合は 5 秒で開始する)、フレーム数 (たとえば、10 の場合は 10 番目のフレームで開始する)、またはストリーム期間に対する相対値 (たとえば、10% の場合はストリーム期間の 10% で開始する) とすることができます。 また、マクロ {Best} もサポートされています。これにより、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示が送られ、ステップと範囲の他の設定に関係なく、1 つのサムネイルのみが生成されることになります。 既定値はマクロ {Best} です。
start: stringプロパティ値
string
step
サムネイルが生成される間隔。 この値は、ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、フレーム数 (30 フレームごとに 1 つのイメージの場合は 30)、またはストリーム期間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10% のイメージ) にすることができます。 注: ステップ値は、最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは異なることがあります。 これは、最初の出力として開始時刻からステップ位置までの間で最適なサムネイルを選択しようとするエンコーダーが原因です。 既定値は 10% であるため、ストリームの期間が長い場合は、最初に生成されたサムネイルが起動時に指定されたものから遠く離れている可能性があることを意味します。 最初のサムネイルが開始時刻に近づくと予想される場合は[ステップ] に適切な値を選択し、開始時にサムネイルが 1 つだけ必要な場合は Range 値を 1 に設定します。
step?: stringプロパティ値
string
継承されたプロパティの詳細
keyFrameInterval
2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。
keyFrameInterval?: stringプロパティ値
string
label
stretchMode
サイズ変更モード - 入力ビデオを目的の出力解像度に合わせてサイズ変更する方法。 既定値は AutoSize です
stretchMode?: stringプロパティ値
string