次の方法で共有


JpgImage クラス

入力ビデオから一連の JPEG 画像を生成するためのプロパティについて説明します。

Azure に送信するには、必要なすべてのパラメーターを設定する必要があります。

継承
azure.mgmt.media.models._models_py3.Image
JpgImage

コンストラクター

JpgImage(*, start: str, label: str | None = None, key_frame_interval: timedelta | None = None, stretch_mode: str | _models.StretchMode | None = None, sync_mode: str | _models.VideoSyncMode | None = None, step: str | None = None, range: str | None = None, layers: List[_models.JpgLayer] | None = None, sprite_column: int | None = None, **kwargs)

キーワードのみのパラメーター

名前 説明
label
str

コーデックの省略可能なラベル。 ラベルを使用して、多重化の動作を制御できます。

key_frame_interval

2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。

stretch_mode
str または StretchMode

サイズ変更モード - 目的の出力解像度に合わせて入力ビデオのサイズを変更する方法。 既定値は AutoSize です。 既知の値は、"None"、"AutoSize"、および "AutoFit" です。

sync_mode
str または VideoSyncMode

ビデオ同期モード。 既知の値は、"Auto"、"Passthrough"、"Cfr"、および "Vfr" です。

start
str

サムネイルの生成を開始する場所からの入力ビデオ内の位置。 この値は、ISO 8601 形式 (たとえば、PT05S の場合は 5 秒で開始する)、フレーム数 (たとえば、10 の場合は 10 番目のフレームで開始する)、またはストリーム期間に対する相対値 (たとえば、10% の場合はストリーム期間の 10% で開始する) とすることができます。 また、マクロ {Best} もサポートされています。これにより、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示が送られ、ステップと範囲の他の設定に関係なく、1 つのサムネイルのみが生成されることになります。 既定値はマクロ {Best} です。 必須。

step
str

サムネイルが生成される間隔。 値は、ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、フレーム数 (たとえば、30 フレームごとに 1 つのイメージの場合は 30)、またはストリーム継続時間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10% のイメージ) にすることができます。 注: ステップ値は最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは異なることがあります。 これはエンコーダーが原因で、開始時刻と開始時刻からのステップ位置の間の最適なサムネイルを最初の出力として選択しようとします。 既定値は 10% であるため、ストリームの期間が長い場合は、最初に生成されたサムネイルが、開始時に指定されたものから遠く離れている可能性があることを意味します。 最初のサムネイルが開始時刻に近いと予想される場合は [ステップ] に適切な値を選択するか、開始時に 1 つのサムネイルのみが必要な場合は Range 値を 1 に設定します。

range
str

サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止する PT5M30S など) またはフレーム数 (たとえば、開始時刻のフレームから 300 番目のフレームで停止する場合は 300) です。この値が 1 の場合は、開始時刻に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム継続時間の半分で停止する場合は 50%) を意味します。 既定値は 100% です。これは、ストリームの末尾で停止することを意味します。

layers

エンコーダーによって生成される出力 JPEG 画像レイヤーのコレクション。

sprite_column
int

サムネイル スプライト イメージで使用される列の数を設定します。 行数が自動的に計算され、スプライト内の各サムネイルの座標マッピングを使用して VTT ファイルが生成されます。 注: この値は正の整数にする必要があり、出力イメージの解像度が JPEG の最大ピクセル解像度制限 65535x65535 を超えないように、適切な値をお勧めします。

変数

名前 説明
odata_type
str

派生型の識別子。 必須。

label
str

コーデックの省略可能なラベル。 ラベルを使用して、多重化の動作を制御できます。

key_frame_interval

2 つのキー フレーム間の距離。 値は、ISO 8601 形式で指定された [0.5, 20] 秒の範囲で 0 以外にする必要があります。 既定値は 2 秒 (PT2S) です。 VideoSyncMode.Passthrough が設定されている場合、KeyFrameInterval 値が入力ソース設定に従う場合、この設定は無視されることに注意してください。

stretch_mode
str または StretchMode

サイズ変更モード - 目的の出力解像度に合わせて入力ビデオのサイズを変更する方法。 既定値は AutoSize です。 既知の値は、"None"、"AutoSize"、および "AutoFit" です。

sync_mode
str または VideoSyncMode

ビデオ同期モード。 既知の値は、"Auto"、"Passthrough"、"Cfr"、および "Vfr" です。

start
str

サムネイルの生成を開始する場所からの入力ビデオ内の位置。 この値は、ISO 8601 形式 (たとえば、PT05S の場合は 5 秒で開始する)、フレーム数 (たとえば、10 の場合は 10 番目のフレームで開始する)、またはストリーム期間に対する相対値 (たとえば、10% の場合はストリーム期間の 10% で開始する) とすることができます。 また、マクロ {Best} もサポートされています。これにより、ビデオの最初の数秒から最適なサムネイルを選択するようにエンコーダーに指示が送られ、ステップと範囲の他の設定に関係なく、1 つのサムネイルのみが生成されることになります。 既定値はマクロ {Best} です。 必須。

step
str

サムネイルが生成される間隔。 値は、ISO 8601 形式 (たとえば、5 秒ごとに 1 つのイメージの PT05S)、フレーム数 (たとえば、30 フレームごとに 1 つのイメージの場合は 30)、またはストリーム継続時間に対する相対値 (たとえば、ストリーム期間の 10% ごとに 10% のイメージ) にすることができます。 注: ステップ値は最初に生成されたサムネイルに影響します。これは、変換プリセットの開始時刻に指定されたサムネイルとは異なることがあります。 これはエンコーダーが原因で、開始時刻と開始時刻からのステップ位置の間の最適なサムネイルを最初の出力として選択しようとします。 既定値は 10% であるため、ストリームの期間が長い場合は、最初に生成されたサムネイルが、開始時に指定されたものから遠く離れている可能性があることを意味します。 最初のサムネイルが開始時刻に近いと予想される場合は [ステップ] に適切な値を選択するか、開始時に 1 つのサムネイルのみが必要な場合は Range 値を 1 に設定します。

range
str

サムネイルの生成を停止する入力ビデオの変換プリセット開始時刻に対する相対位置。 値は ISO 8601 形式 (たとえば、開始時刻から 5 分 30 秒で停止する PT5M30S など) またはフレーム数 (たとえば、開始時刻のフレームから 300 番目のフレームで停止する場合は 300) です。この値が 1 の場合は、開始時刻に 1 つのサムネイルのみを生成することを意味します。または、ストリームの継続時間に対する相対値 (たとえば、開始時刻からのストリーム継続時間の半分で停止する場合は 50%) を意味します。 既定値は 100% です。これは、ストリームの末尾で停止することを意味します。

layers

エンコーダーによって生成される出力 JPEG 画像レイヤーのコレクション。

sprite_column
int

サムネイル スプライト イメージで使用される列の数を設定します。 行数が自動的に計算され、スプライト内の各サムネイルの座標マッピングを使用して VTT ファイルが生成されます。 注: この値は正の整数にする必要があり、出力イメージの解像度が JPEG の最大ピクセル解像度制限 65535x65535 を超えないように、適切な値をお勧めします。