すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Media Processing:パラメーター詳細

    ドキュメントセンター

    ApsaraVideo Media Processing:パラメーター詳細

    最終更新日:Sep 08, 2026

    このトピックでは、ApsaraVideo Media Processing (MPS) API で使用されるパラメーターについて、そのタイプ、説明、有効な値などを解説します。これらの API パラメーターを設定することで、トランスコーディング、MPS キュー、ワークフローなどの MPS の機能を利用できます。

    入力の詳細

    Input パラメーターは、SubmitJobs オペレーションで参照されます。

    パラメーター

    タイプ

    必須

    説明

    Bucket

    String

    はい

    入力ファイルを格納する Object Storage Service (OSS) バケット。

    OSS バケットの詳細については、「用語」をご参照ください。

    Location

    String

    はい

    OSS バケットのデータセンター (OSS リージョン) を入力します。

    • OSS バケットは MPS と同じリージョンに存在する必要があります。

    • リージョンは OSS リージョンの定義に従う必要があります。詳細については、「基本概念」をご参照ください。

    Object

    String

    はい

    入力ファイルの OSS パス。OSS パスは、入力ファイルの名前を含む完全なパスです。

    • オブジェクトキーという用語の詳細については、「用語」をご参照ください。

    • OSS オブジェクトのパスは、MPS で使用する前に UTF-8 で URL エンコードする必要があります。詳細については、「URL エンコード」をご参照ください。

    • たとえば、Alibaba Cloud/mts HD+.mp4 は %E9%98%BF%E9%87%8C%E4%BA%91/mts%20HD%2B.mp4 のようにエンコードされます。

    Referer

    String

    いいえ

    ホットリンク保護の設定。OSS バケットのホットリンク保護機能を有効にして、ホワイトリスト内の特定の Referer のみファイルのダウンロードを許可する場合、このパラメーターを指定する必要があります。OSS バケットのホットリンク保護機能を有効にしない場合、このパラメーターを指定する必要はありません。詳細については、「ホットリンク保護」をご参照ください。

    • ワークフローのトランスコーディングを使用するには、コンソールで Referer を設定する必要があります。詳細については、「ホットリンク保護の設定」をご参照ください。

    • API オペレーションを呼び出してトランスコーディングジョブを送信する場合、リクエストでこのパラメーターを指定する必要があります。

    出力の詳細

    Output パラメーターは、SubmitJobs、AddMediaWorkflow、UpdateMediaWorkflow オペレーションで参照されます。

    パラメーター

    タイプ

    必須

    説明

    OutputObject

    String

    はい

    出力ファイルの OSS パス。OSS パスは、出力ファイルの名前を含む完全なパスです。

    • オブジェクトキーという用語の詳細については、「用語」をご参照ください。

    • プレースホルダーがサポートされています。詳細については、本トピックの「プレースホルダーの置換ルール」セクションをご参照ください。

    • ファイル名拡張子を指定するルール：

      • ワークフロー：ファイル名拡張子を指定する必要はありません。MPS は、トランスコーディングテンプレートのコンテナ形式に基づいて、OutputObject パラメーターの値にファイル名拡張子を自動的に追加します。

      • トランスコーディングジョブ：ファイル名拡張子を指定する必要があり、ファイル名拡張子はトランスコーディングテンプレートのコンテナ形式と一致する必要があります。コンテナ形式が M3U8 の場合、MPS は自動的にファイル名拡張子 .m3u8 をプレイリストに追加します。5 桁のシリアル番号がプレイリスト名のサフィックスとして自動的に追加され、メディアセグメントファイルの名前が生成されます。5 桁のシリアル番号は 00001 から始まり、ハイフン (-) でプレイリスト名に接続されます。メディアセグメントファイルのファイル名拡張子は .ts です。たとえば、プレイリストのファイル名が filename.m3u8 の場合、最初のメディアセグメントファイルの名前は filename-00001.ts です。

    • OSS オブジェクトのパスは、MPS で使用する前に UTF-8 で URL エンコードする必要があります。詳細については、「URL エンコード」をご参照ください。

    • たとえば、入力ファイルのパスが a/b/example.flv で、出力ファイルのパスを a/b/c/example+test.mp4 に設定する場合、プレースホルダーを使用して出力ファイルのパスを {ObjectPrefix}/c/{FileName}+test.mp4 の形式で指定できます。URL エンコード後、パスは %7BObjectPrefix%7D/c/%7BFileName%7D%2Btest.mp4 と表示されます。

    TemplateId

    String

    はい

    トランスコーディングテンプレートの ID。

    Container

    Object

    いいえ

    コンテナ形式。詳細については、本トピックの「コンテナ」セクションをご参照ください。

    • このパラメーターを指定すると、指定したトランスコーディングテンプレートの対応するパラメーターが上書きされます。

    Video

    Object

    いいえ

    動画トランスコーディングに関連するパラメーター。詳細については、本トピックの「ビデオ」セクションをご参照ください。

    • このパラメーターを指定すると、指定したトランスコーディングテンプレートの対応するパラメーターが上書きされます。

    Audio

    Object

    いいえ

    音声トランスコーディングに関連するパラメーター。詳細については、本トピックの「オーディオ」セクションをご参照ください。

    • このパラメーターを指定すると、指定したトランスコーディングテンプレートの対応するパラメーターが上書きされます。

    TransConfig

    Object

    いいえ

    トランスコーディングプロセスに関連するパラメーター。詳細については、本トピックの「TransConfig」セクションをご参照ください。

    • このパラメーターを指定すると、指定したトランスコーディングテンプレートの対応するパラメーターが上書きされます。

    • 例：{"TransMode":"onepass","AdjDarMethod":"none","IsCheckVideoBitrateFail":"true","IsCheckAudioBitrateFail":"true"}。

    VideoStreamMap

    String

    いいえ

    入力ファイルで保持するビデオストリームの識別子。有効な値：

    • 指定なし：デフォルトのビデオストリームが選択されます。

    • 0:v:{シリアル番号}：特定のビデオストリームが選択されます。シリアル番号はビデオストリームの添字を指定します。シリアル番号は 0 から始まります。たとえば、0:v:1 は、2 番目のビデオストリームがトランスコーディング用に選択されることを指定します。

    • 0:v：すべてのビデオストリームが選択されます。

    AudioStreamMap

    String

    いいえ

    入力ファイルで保持する音声ストリームの識別子。有効な値：

    • 指定なし：デフォルトの音声ストリームが選択されます。ほとんどの場合、中国語、マルチサウンドチャンネル、高品質の音声ストリームが優先されます。

    • 0:a:{シリアル番号}：特定の音声ストリームが選択されます。シリアル番号は音声ストリームの添字を指定します。シリアル番号は 0 から始まります。たとえば、0:a:1 は、2 番目の音声ストリームがトランスコーディング用に選択されることを指定します。

    • 0:a：すべての音声ストリームが選択されます。この値は、多言語吹き替えシナリオに適用されます。

    Rotate

    String

    いいえ

    ビデオを時計回りに回転させる角度。

    • 有効な値：0、90、180、270。

    • デフォルト値：0。ビデオを回転させないことを指定します。

    WaterMarks

    Object[]

    いいえ

    ウォーターマーク。ウォーターマークは、ビデオ画像に追加される画像またはテキストです。このパラメーターを指定すると、指定したウォーターマークテンプレートの対応するパラメーターが上書きされます。詳細については、本トピックの「WaterMarks」セクションをご参照ください。

    • 1 つのトランスコーディングジョブに最大 4 つのウォーターマークを追加できます。

    • 次のコードは、単一の画像ウォーターマークの例を示しています：["WaterMarkTemplateId":"88c6ca184c0e47098a5b665e2a12****"},{"InputFile":{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"},{"Timeline":{"Start":"0","Duration":"ToEND"}}]。

    • 単一のテキストウォーターマークの例：["Type":"Text","TextWaterMark":{"Content":"5rWL6K+V5paH5a2X5rC05Y2w","FontName":"SimSun","FontSize":"16","Top":2,"Left":10}]。

    DeWatermark

    Object

    いいえ

    ぼかし処理を実行できます。詳細については、「ぼかし処理の詳細」をご参照ください。

    • 例：{"0": [{"l":10,"t":10,"w":10,"h":10},{"l":100,"t":0.1,"w":10,"h":10}],"128000": [],"250000": [{"l":0.2,"t":0.1,"w":0.01,"h":0.05}]}。

    SubtitleConfig

    Object

    いいえ

    ハード字幕の設定。このパラメーターを使用すると、外部字幕ファイルをビデオに追加できます。詳細については、本トピックの「SubtitleConfig」セクションをご参照ください。

    • 1 つのトランスコーディングジョブに最大 4 つの字幕ファイルを追加できます。

    • 例：{"ExtSubtitleList":[{"Input":{"Bucket":"example-bucket-****","Location":"oss-cn-hangzhou","Object":"example.srt"},"CharEnc":"UTF-8"}]}。

    Clip

    Object

    いいえ

    クリップ。詳細については、本トピックの「Clip」セクションをご参照ください。

    • 例：{"TimeSpan":{"Seek":"00:01:59.999","End":"18000.30"},"ConfigToClipFirstPart":false}。これは、クリップが 1 分 59 秒 999 ミリ秒で開始し、ビデオの終了 5 分 30 ミリ秒前の時点で終了することを指定します。クリップは、複数の入力ファイルをマージして形成されたビデオから切り取られます。

    MergeList

    Object[]

    いいえ

    マージリスト。複数の入力ファイルとクリップを順番にマージして、新しいビデオを生成できます。詳細については、本トピックの「MergeList」セクションをご参照ください。

    • MergeList と MergeConfigUrl のいずれか 1 つのパラメーターのみ指定できます。MergeConfigUrl パラメーターは MergeList パラメーターよりも優先度が高くなります。

    • 1 つのトランスコーディングジョブに最大 4 つの MergeURL パラメーターを追加できます。トランスコーディングジョブにさらに MergeURL パラメーターを追加するには、MergeConfigUrl パラメーターを指定する必要があります。

    • 単一の MergeURL パラメーターを指定する例：[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4"}]。

    • 2 つの MergeURL パラメーターを指定する例：[{"MergeURL":"http://exampleBucket****m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4","Start":"1","Duration":"20"},{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_comm_02.mp4","Start":"5.4","Duration":"10.2"}]。

    MergeConfigUrl

    String

    いいえ

    クリップをマージするための設定ファイルの OSS パス。

    • MergeList と MergeConfigUrl のいずれか 1 つのパラメーターのみ指定できます。MergeConfigUrl パラメーターは MergeList パラメーターよりも優先度が高くなります。

    • ファイルは OSS バケットに保存する必要があります。例：http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/mergeConfigfile。

    • ファイルには複数の MergeURL パラメーターが含まれています。対応するクリップをマージする順序で MergeURL パラメーターを指定します。最大 50 個の MergeURL パラメーターを指定できます。形式の詳細については、本トピックの「MergeList」セクションをご参照ください。設定ファイルの内容の例：{"MergeList":[{"MergeURL":"http://exampleBucket****m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4","Start":"1","Duration":"20"},{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_comm_02.mp4","Start":"5.4","Duration":"10.2"}]}。

    OpeningList

    Object[]

    いいえ

    オープニングパート。オープニングは、入力ビデオの冒頭にオープニングパートを埋め込むことができる特殊なマージ効果です。オープニングパートはピクチャーインピクチャー (PiP) モードで表示されます。詳細については、本トピックの「OpeningList」セクションをご参照ください。

    • 1 つのトランスコーディングジョブに最大 2 つのオープニングパートを追加できます。出力ビデオにオープニングパートを埋め込む順序でオープニングパートを指定します。

    • 例：[{"OpenUrl":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv","Start":"1","Width":"1920","Height":"1080"},{"OpenUrl":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/opening_02.flv","Start":"1","Width":"-1","Height":"full"}]。

    TailSlateList

    Object[]

    いいえ

    エンディングパート。エンディングは、入力ビデオの末尾にエンディングパートを追加できる特殊なマージ効果です。エンディングパートはフェードイン・フェードアウトモードで表示されます。詳細については、本トピックの「TailSlateList」セクションをご参照ください。

    • 1 つのトランスコーディングジョブに最大 2 つのエンディングパートを追加できます。出力ビデオにエンディングパートを埋め込む順序でエンディングパートを指定します。

    • 例：[{"TailUrl":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_01.flv","Start":"1","BlendDuration":"2","Width":"1920","Height":"1080","IsMergeAudio":false,"BgColor":"White"}]。

    Amix

    Object[]

    いいえ

    オーディオミキシング設定。このパラメーターは、ビデオ内の複数のオーディオトラックをマージしたり、BGM を追加したりするシナリオに適しています。詳細については、本トピックの「Amix」セクションをご参照ください。

    • 1 つのトランスコーディングジョブに最大 4 つのミキシングオーディオファイルを追加できます。

    • 入力ファイルの 2 つの音声ストリームをミキシングする例：[{"AmixURL":"input","MixDurMode":"longest","Start":"1","Duration":"2"}]。

    • 外部ファイルを追加して入力ファイルとミキシングする例：[{"AmixURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail.flv","Map":"0:a:1","MixDurMode":"longest","Start":"1","Duration":"2"}]。

    MuxConfig

    Object

    いいえ

    パッケージング設定。詳細については、本トピックの「MuxConfig」セクションをご参照ください。

    • このパラメーターを指定すると、指定したトランスコーディングテンプレートの対応するパラメーターが上書きされます。

    • 例：{"Segment":{"Duration":"10","ForceSegTime":"1,2,4,6,10,14,18"}}。これは、ビデオが 1、2、4、6、10、14、18、20、30、40、50... 秒で強制的にセグメント化されることを指定します。

    M3U8NonStandardSupport

    Object

    いいえ

    M3U8 形式の非標準サポート。詳細については、本トピックの「M3U8NonStandardSupport」セクションをご参照ください。

    • 例：{"TS":{"Md5Support":true,"SizeSupport":true}}。これは、各 TS ファイルの MD5 値とサイズが出力 M3U8 ビデオに含まれることを指定します。

    Encryption

    String

    いいえ

    暗号化設定。このパラメーターは、Container パラメーターが m3u8 に設定されている場合にのみ有効です。詳細については、「暗号化パラメーターの詳細」をご参照ください。

    • 例：{"Type":"hls-aes-128","Key":"ZW5jcnlwdGlvbmtleTEyMw","KeyType":"Base64","KeyUri":"aHR0cDovL2FsaXl1bi5jb20vZG9jdW1lbnQvaGxzMTI4LmtleQ=="}。

    UserData

    String

    いいえ

    カスタムデータ。最大 1,024 バイトまで指定できます。

    Priority

    String

    いいえ

    MPS キュー内のトランスコーディングジョブの優先度。

    • 有効な値：[1,10]。値 1 は最も低い優先度を指定し、値 10 は最も高い優先度を指定します。

    • デフォルト値：6。

    • ベストプラクティス：MPS キューには同時実行数の制限があります。多数のジョブを送信すると、ジョブがキューに入れられる可能性があります。高い時間パフォーマンスを必要とするジョブや重要なコンテンツを処理するジョブには、より高い優先度を設定することを推奨します。

    Metadata

    Map

    いいえ

    出力ビデオのコンテナ形式の metadata。 JSON のキーと値のペアとして指定します。例：{"key1":"value1","key2":"value2"}。

    • key の最大長：64。

    • value の最大長：512。

    • 最大 4 つの metadata キーと値のペアを追加できます。

    コンテナの詳細

    このパラメーターは Output.Container のリファレンスとして機能します。

    パラメーター

    タイプ

    必須

    説明

    Format

    String

    いいえ

    コンテナ形式。

    • サポートされている形式と互換性のあるコーデックの詳細については、「サポートされている形式」をご参照ください。

      • サポートされているビデオ形式：3GP、AVI、FLV、F4V、fMP4、MKV、MOV、MP4、TS、MXF、WebM、M3U8、HLS-fMP4、MPD、CMAF-HLS、CMAF-DASH。

      • サポートされているオーディオ形式：AAC、M4A、MP2、MP3、MP4、Ogg、FLAC、M3U8、HLS-fMP4、MPD、CMAF-HLS、CMAF-DASH。

      • アニメーション画像：GIF、WebP。

    • デフォルト形式：MP4。

    TransConfig の詳細

    このパラメーターは Output.TransConfig で参照されます。

    パラメーター

    タイプ

    必須

    説明

    TransMode

    String

    いいえ

    動画トランスコーディングモード。このパラメーターは、Codec パラメーターが H.264、H.265、または AV1 に設定され、Bitrate および Crf パラメーターが有効な値に設定されている場合にのみ有効です。詳細については、本トピックの「ビットレート制御モード」セクションをご参照ください。有効な値：

    • CBR：ビットレートは固定です。

    • onepass：Bitrate パラメーターが ABR に設定されている場合、このパラメーターを onepass に設定できます。このモードのエンコーディング速度は twopass モードよりも高速です。

    • twopass：Bitrate パラメーターが VBR に設定されている場合、このパラメーターを twopass に設定できます。このモードのエンコーディング速度は onepass モードよりも低速です。

    • fixCRF：CRF 品質制御モードを指定します。

    • デフォルト値：Bitrate パラメーターを指定した場合、このパラメーターのデフォルト値は onepass です。Bitrate パラメーターを指定しない場合、このパラメーターのデフォルト値は fixCRF で、Crf パラメーターのデフォルト値が使用されます。

    AdjDarMethod

    String

    いいえ

    解像度を調整するために使用されるメソッド。このパラメーターは、Width と Height の両方のパラメーターが指定されている場合にのみ有効です。このパラメーターは LongShortMode パラメーターと一緒に使用できます。

    • 有効な値：rescale、crop、pad、none。

    • デフォルト値：none。

    • 詳細については、「解像度の設定方法」をご参照ください。

    IsCheckReso

    String

    いいえ

    ビデオ解像度をチェックするかどうかを指定します。IsCheckReso と IsCheckResoFail のいずれか 1 つのパラメーターのみ指定できます。IsCheckResoFail パラメーターは IsCheckReso パラメーターよりも優先度が高くなります。有効な値：

    • true：ビデオ解像度をチェックします。入力ビデオの幅または高さが出力ビデオよりも小さい場合、入力ビデオの解像度がトランスコーディングに使用されます。

    • false：チェックを実行しません。

    • デフォルト値：false。

    IsCheckResoFail

    String

    いいえ

    ビデオ解像度をチェックするかどうかを指定します。このパラメーターは IsCheckResoFail と相互排他的であり、優先されます。

    • true：ビデオ解像度をチェックします。入力ビデオの幅または高さが出力ビデオよりも小さい場合、トランスコーディングジョブは失敗します。

    • false：チェックは実行されません。

    • デフォルト値：false。

    IsCheckVideoBitrate

    String

    いいえ

    ビデオビットレートをチェックするかどうかを指定します。IsCheckVideoBitrate と IsCheckVideoBitrateFail のいずれか 1 つのパラメーターのみ指定できます。IsCheckVideoBitrateFail パラメーターは IsCheckVideoBitrate パラメーターよりも優先度が高くなります。有効な値：

    • true：ビデオビットレートをチェックします。入力ビデオのビットレートが出力ビデオのビットレートよりも低い場合、入力ビデオのビットレートがトランスコーディングに使用されます。

    • false：チェックは実行されません。

    • デフォルト値：false。

    IsCheckVideoBitrateFail

    String

    いいえ

    ビデオビットレートをチェックするかどうかを指定します。このパラメーターは IsCheckVideoBitrateFail と相互排他的であり、優先されます。

    • true：ビデオビットレートをチェックします。入力ビデオのビットレートが出力ビデオのビットレートよりも低い場合、トランスコーディングジョブは失敗します。

    • false：チェックは実行されません。

    • デフォルト値：false。

    IsCheckAudioBitrate

    String

    いいえ

    音声ビットレートをチェックするかどうかを指定します。IsCheckAudioBitrate と IsCheckAudioBitrateFail のいずれか 1 つのパラメーターのみ指定できます。IsCheckAudioBitrateFail パラメーターは IsCheckAudioBitrate パラメーターよりも優先度が高くなります。有効な値：

    • true：音声ビットレートをチェックします。入力音声のビットレートが出力音声のビットレートよりも低い場合、入力音声のビットレートがトランスコーディングに使用されます。

    • false：チェックは実行されません。

    • デフォルト値：

      • パラメーターが空で、コーデックが入力ソースと異なる場合：false。

      • パラメーターが空の場合にコーデックが入力ソースと同じ場合：true。

    IsCheckAudioBitrateFail

    String

    いいえ

    音声ビットレートをチェックするかどうかを指定します。このパラメーターは IsCheckAudioBitrateFail と相互排他的であり、優先度が高くなります。

    • true：音声ビットレートをチェックします。入力音声のビットレートが出力音声のビットレートよりも低い場合、トランスコーディングジョブは失敗します。

    • false：チェックされません。

    • デフォルト値：false。

    ビットレート制御モード

    TransMode、Bitrate、vbv (Maxrate、Bufsize)、および Crf パラメーターをビデオビットレート制御モードに基づいて設定できます。

    ビットレート制御モード

    TransMode パラメーターの設定

    ビットレート関連パラメーターの設定

    固定ビットレート (CBR)

    CBR

    Bitrate、Maxrate、Bufsize は等しくなければなりません。

    平均ビットレート (ABR)

    OnePass または指定なし

    Bitrate パラメーターは必須です。

    Maxrate および Bufsize パラメーターはオプションで、ピーク時のビットレート範囲を設定するために使用できます。

    可変ビットレート (VBR)

    twopass

    Bitrate、Maxrate、Bufsize パラメーターは必須です。

    CRF 品質制御

    fixCRF

    CRF 値は必須です。Crf パラメーターが指定されていない場合、指定された Codec 値に対応する Crf パラメーターのデフォルト値が有効になります。

    Maxrate および Bufsize パラメーターはオプションで、ピーク時のビットレート範囲を設定するために使用できます。

    指定なし

    Bitrate パラメーターを空のままにすると、指定された Codec 値に対応する Crf パラメーターのデフォルト値が有効になります。

    ビデオの詳細

    このパラメーターは Output.Video で参照されます。

    パラメーター

    タイプ

    必須

    説明

    Remove

    String

    いいえ

    ビデオストリームを削除するかどうかを指定します。有効な値：

    • true：ビデオストリームを削除します。このパラメーターを true に設定すると、すべてのビデオ関連パラメーターが無効になります。

    • false：項目は保持されます。

    • デフォルト値：false。

    Codec

    String

    いいえ

    ビデオエンコード形式。

    • 有効な値：H.264、H.265、AV1、GIF、WEBP。サポートされている形式と互換性のあるコンテナ形式の詳細については、「サポートされている形式」をご参照ください。

    • デフォルト値：H.264。

    Width

    String

    いいえ

    出力ビデオの幅または長辺。LongShortMode パラメーターが false または空のままの場合、このパラメーターは出力ビデオの幅を指定します。LongShortMode パラメーターが true に設定されている場合、このパラメーターは出力ビデオの長辺を指定します。

    • 単位：ピクセル。

    • 有効な値：[128,4096]。値は偶数である必要があります。

    • デフォルト値：

      • Width も Height パラメーターも指定されていない場合、デフォルト値は入力ビデオの幅または長辺になります。

      • Height パラメーターのみが指定されている場合、デフォルト値は入力ビデオのアスペクト比に基づいて計算されます。

    Height

    String

    いいえ

    出力ビデオの高さまたは短辺。LongShortMode パラメーターが false または空のままの場合、このパラメーターは出力ビデオの高さを指定します。LongShortMode パラメーターが true に設定されている場合、このパラメーターは出力ビデオの短辺を指定します。

    • 単位：ピクセル。

    • 有効な値：[128,4096]。値は偶数である必要があります。

    • デフォルト値：

      • Width も Height も設定されていない場合、入力ビデオの短い方のディメンションが使用されます。

      • Width パラメーターのみが指定されている場合、デフォルト値は入力ビデオのアスペクト比に基づいて計算されます。

    LongShortMode

    String

    いいえ

    自動回転 (長辺と短辺への適応) を有効にするかどうかを指定します。この設定は、`Width` または `Height` が指定されている場合にのみ有効です。

    • true：機能は有効です。

    • false：シャットダウン。

    • デフォルト値：false。

    • ベストプラクティス：入力ビデオに 横向きと縦向きの両方のビデオが含まれている場合、自動回転機能を有効にし、解像度パラメーターに基づいて比例スケーリングを設定して、ビデオの引き伸ばしや歪みを防ぎます。例については、「自動回転の設定」をご参照ください。

    Fps

    String

    いいえ

    ビデオストリームのフレームレート。

    • 単位：フレーム/秒。

    • 有効な値：(0,60]。

    • デフォルト値：入力ファイルのフレームレート。入力ファイルのフレームレートが 60 を超える場合は 60 が使用されます。

    • 一般的な値：24、25、30。

    MaxFps

    String

    いいえ

    最大フレームレート。

    Gop

    String

    いいえ

    時間またはフレーム数で隣接する I フレーム間の間隔を設定します。

    説明

    GOP (Group of Pictures) の値が大きいほど、圧縮率が高くなり、エンコード速度が遅くなり、ストリーミングメディアの単一セグメントの長さが長くなり、シークへの応答時間が長くなります。詳細については、「用語」の GOP という用語の説明をご参照ください。

    • 2 つの連続する I フレーム間の最大時間間隔の形式：{時間}s。有効な値：[1,100000]。

    • 2 つの連続する I フレーム間の最大フレーム間隔の形式：{フレーム数}。有効な値：[1,100000]。

    • デフォルト値：10s。2 つの連続する I フレーム間の時間間隔が 10 秒であることを指定します。

    • ベストプラクティス：ストリーミングメディアシナリオでは、再生開始までの時間とシークへの応答時間を短縮するために、パラメーターを 2 ～ 7 秒の時間間隔に設定することを推奨します。

    Bitrate

    String

    いいえ

    出力ビデオの平均ビットレート。CRB、ABR、または VBR ビットレート制御モードを使用する場合、Bitrate パラメーターを指定し、TransMode パラメーターを有効な値に設定する必要があります。詳細については、本トピックの「ビットレート制御モード」セクションをご参照ください。

    • 単位：Kbit/s。

    • 有効な値：-1 および [10,50000]。値 -1 は、入力ビデオの元のビットレートが使用されることを示します。

    • ベストプラクティス：

      • CBR：TransMode パラメーターを CBR に設定し、Bitrate、Maxrate、Bufsize パラメーターを同じ値に設定します。

      • ABR：TransMode パラメーターを onepass に設定し、Bitrate パラメーターを指定します。Maxrate および Bufsize パラメーターを指定してビットレート範囲を制御することもできます。

      • VBR：TransMode パラメーターを twopass に設定し、Maxrate または BitrateBnd パラメーターと Bufsize パラメーターを指定します。

    BitrateBnd

    String

    いいえ

    出力ビデオの平均ビットレート範囲。

    • このパラメーターは、Codec パラメーターが H.264 に設定されている場合にのみ有効です。

    • 例：{"Max":"5000","Min":"1000"}。

    Maxrate

    String

    いいえ

    出力ビデオのピークビットレート。詳細については、本トピックの「ビットレート制御モード」セクションをご参照ください。

    • 単位：Kbit/s。

    • 有効な値：[10,50000]。

    Bufsize

    String

    いいえ

    ビットレート制御のためのバッファサイズ。このパラメーターを指定してビットレートの変動を制御できます。詳細については、本トピックの「ビットレート制御モード」セクションをご参照ください。

    説明

    Bufsize の値が大きいほど、ビットレートの変動が大きくなり、ビデオ品質が高くなります。

    • 単位：Kbit。

    • 有効な値：[1000,128000]。

    • デフォルト値：6000。

    Crf

    String

    いいえ

    品質制御係数。CRF モードを使用するには、Crf パラメーターを指定し、TransMode パラメーターを fixCRF に設定する必要があります。詳細については、本トピックの「ビットレート制御モード」セクションをご参照ください。

    説明

    Crf パラメーターの値が大きいほど、ビデオ品質が低くなり、圧縮率が高くなります。

    • 有効な値：[20,51]。

    • Codec パラメーターが H.264 に設定されている場合、デフォルト値は 23 です。Codec パラメーターが H.265 に設定されている場合、デフォルト値は 26 です。Codec パラメーターが AV1 に設定されている場合、デフォルト値は 32 です。

    • ベストプラクティス：

      • 値 0 はビデオが無損失であることを指定します。値 51 は画質が最も悪いことを指定します。値を 23 ～ 29 の範囲の数値に設定することを推奨します。ビデオ画像の複雑さに応じて値を調整できます。値を 6 増減させると、ビットレートは半分または 2 倍になります。同じ解像度では、アニメーション漫画の値をショットビデオよりも高く設定できます。

      • CRF モードはビデオ品質を優先し、出力ビデオのビットレートは予測できません。Maxrate および Bufsize パラメーターを指定してビットレート範囲を制御できます。

    Qscale

    String

    いいえ

    ビデオ品質制御の係数の値。このパラメーターは、VBR モードを使用する場合に有効です。

    説明

    Qscale パラメーターの値が大きいほど、ビデオ品質が低くなり、圧縮率が高くなります。

    • このパラメーターは、Codec パラメーターが H.264 に設定されている場合にのみ有効です。

    • 有効な値：[0,51]。

    Profile

    String

    いいえ

    エンコードプロファイルを指定します。詳細については、「用語」をご参照ください。

    • このパラメーターは、Codec が H.264 に設定されている場合にのみ有効です。

    • 有効な値：baseline、main、high。

    • デフォルト値：high。

    • ベストプラクティス：同じビデオから複数の解像度の出力ビデオを生成する場合、最も低い解像度に対してこのパラメーターを baseline に設定することを推奨します。これにより、出力ビデオがすべてのデバイスで再生できるようになります。他の解像度の出力ビデオを生成する場合は、このパラメーターを main または high に設定します。

    Preset

    String

    いいえ

    H.264 エンコーダーのプリセットモード。

    説明

    選択するモードが速いほど、ビデオ品質は低くなります。

    • このパラメーターは、Codec パラメーターが H.264 に設定されている場合にのみ有効です。

    • 有効な値：veryfast、fast、medium、slow、slower。

    • デフォルト値：medium。

    ScanMode

    String

    いいえ

    スキャンモード。有効な値：

    • このパラメーターを空のままにすると、入力ファイルのスキャンモードが使用されます。

    • auto：インターレース解除を自動的に実行します。

    • progressive：シーケンシャルなラインごとのスキャン。

    • interlaced：スキャンはインターレースです。

    • デフォルト値：なし。

    ベストプラクティス：インターレーススキャンモードはプログレッシブスキャンモードよりもデータトラフィックを節約しますが、画質は劣ります。そのため、主流のビデオ制作ではプログレッシブスキャンモードが一般的に使用されます。

    • ScanMode パラメーターを progressive または interlaced に設定し、このスキャンモードが入力ファイルのスキャンモードと一致しない場合、ファイルのトランスコーディングは失敗します。

    • 互換性を向上させるために、元のビデオモードまたは自動インターレース解除を設定することを推奨します。

    PixFmt

    String

    いいえ

    ビデオのカラーフォーマット。

    • 元のカラーフォーマットを使用するには、PixFmt を "" に設定します。

    • 有効な値には、yuv420p、yuvj420p、yuv422p、yuvj422p、yuv444p、yuvj444p、yuv444p、yuv444p161e、pc、bt470bg、smpte170m が含まれます。Codec パラメーターが GIF に設定されている場合、bgr8 がサポートされます。

    Crop

    String

    いいえ

    ビデオをトリミングするために使用されるメソッド。境界線を自動的に検出して削除できます。ビデオを手動でトリミングすることもできます。

    • 入力ビデオの解像度が出力ビデオの解像度よりも大きい場合は、このパラメーターを指定します。このパラメーターが指定されている場合は、AdjDarMethod パラメーターを指定しないでください。

    • 自動黒枠境界除去。

    • カスタムトリミング方法を使用するには、パラメーターを {width}:{height}:{left}:{top} の形式で設定します。

      • width：トリミング後の出力ビデオの幅。

      • height：トリミング後の出力ビデオの高さ。

      • left：出力画像と元の画像の間の左マージン。

      • top：出力画像と元の画像の間の上マージン。

    • カスタムトリミングの例：1920:800:0:140。示例

    Pad

    String

    いいえ

    ビデオは黒枠でパディングされます。

    • 入力ビデオの解像度が出力ビデオの解像度よりも小さい場合は、このパラメーターを指定します。このパラメーターが指定されている場合は、IsCheckReso、IsCheckResoFail、または AdjDarMethod パラメーターを指定しないでください。

    • 形式：{width}:{height}:{left}:{top}。

      • width：黒枠が追加された後の出力ビデオの幅。

      • height：黒枠が追加された後の出力ビデオの高さ。

      • left：出力フレームに対するソースフレームの左マージン。

      • top：出力フレームの上部と元のフレームの上部の間のマージン。

    • 例：1920:1080:0:140。视频贴黑边

    オーディオの詳細

    このパラメーターは Output.Audio で使用されます。

    パラメーター

    タイプ

    必須

    説明

    Remove

    String

    いいえ

    音声ストリームを削除するかどうかを指定します。

    • true：音声ストリームを削除します。このパラメーターを true に設定すると、すべての音声関連パラメーターが無効になります。

    • false：リソースは保持されます。

    • デフォルト値：false。

    Codec

    String

    いいえ

    音声コーデック形式。

    • 有効な値：AAC、AC3、EAC3、MP2、MP3、FLAC、OPUS、VORBIS、WMA-V1、WMA-V2、pcm_s16le。サポートされている形式と互換性のあるコンテナ形式の詳細については、「サポートされている形式」をご参照ください。

    • デフォルト値：AAC。

    Profile

    String

    いいえ

    音声エンコードプロファイル。

    • このパラメーターは、Codec パラメーターが AAC に設定されている場合にのみ有効です。

    • 有効な値：aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。エンコードプロファイルという用語の詳細については、「用語」をご参照ください。

    • デフォルト値：aac_low。

    Bitrate

    String

    いいえ

    出力ファイルの音声ビットレート。

    • 単位：Kbit/s。

    • 有効な値：[8,1000]。

    • デフォルト値：128。

    • 一般的な値：64、128、256。

    Samplerate

    String

    いいえ

    サンプリングレート。

    • 単位：Hz。

    • 有効な値：22050、32000、44100、48000、96000。

      説明

      サポートされているサンプリングレートは、エンコード形式とコンテナ形式によって異なります。詳細については、「音声サンプルレート」をご参照ください。たとえば、Codec が MP3 に設定されている場合、このパラメーターを 96000 に設定することはできません。Codec が FLV に設定されている場合、このパラメーターは 22050 または 44100 にのみ設定できます。

    • デフォルト値：44100。

    Channels

    String

    いいえ

    サウンドチャンネルの数。

    • 有効な値：0、1、2、4、5、6、8。

      • Codec パラメーターが MP3 または OPUS に設定されている場合、このパラメーターを 0、1、または 2 に設定できます。

      • Codec パラメーターが AAC または FLAC に設定されている場合、このパラメーターを 0、1、2、4、5、6、または 8 に設定できます。

      • Codec パラメーターが VORBIS に設定されている場合、このパラメーターを 2 に設定できます。

      • Format パラメーターが MPD に設定されている場合、このパラメーターを 8 に設定することはできません。

    • デフォルト値：2。

    • 元のサウンドチャンネル数を維持したい場合は、このパラメーターを 0 に設定します。

    Volume

    String

    いいえ

    音量設定。詳細については、本トピックの「音量」セクションをご参照ください。

    • このパラメーターは、出力音声ストリームが 1 つだけ設定されている場合にのみサポートされます。複数の出力音声ストリームが設定されている場合、このパラメーターはサポートされません。

    音量制御の詳細

    このパラメーターは Output.Audio.Volume で使用されます。

    パラメーター

    タイプ

    必須

    説明

    Method

    String

    いいえ

    音量の調整

    • auto：設定は自動的に調整されます。

    • dynamic：値は動的に調整されます。

    • linear：一定のレートでの調整。

    • デフォルト値：dynamic。

    Level

    String

    いいえ

    入力音声の音量に基づいて実行される音量調整のレベル。

    • このパラメーターは、Method パラメーターが linear に設定されている場合にのみ有効です。

    • 単位：デシベル。

    • 値の範囲：最大 20 dB。

    • デフォルト値：-20 dB。

    IntegratedLoudnessTarget

    String

    いいえ

    対象のボリューム

    • このパラメーターは、Method パラメーターが dynamic に設定されている場合にのみ有効です。

    • 単位：デシベル。

    • 有効な値：[-70,-5]。

    • デフォルト値：-6。

    TruePeak

    String

    いいえ

    最大音量。

    • このパラメーターは、Method パラメーターが dynamic に設定されている場合にのみ有効です。

    • 単位：デシベル。

    • 有効な値：[-9,0]。

    • デフォルト値：-1。

    LoudnessRangeTarget

    String

    いいえ

    ターゲット音量からの許容偏差。

    • このパラメーターは、Method パラメーターが dynamic に設定されている場合にのみ有効です。

    • 単位：デシベル。

    • 有効な値：[1,20]。

    • デフォルト値：8。

    トランスコーディングウォーターマークパラメーターの詳細

    このパラメーターは Output.WaterMarks で使用されます。

    パラメーター

    タイプ

    必須

    説明

    Type

    String

    いいえ

    ウォーターマークのタイプ。有効な値：

    • Text：テキストウォーターマーク。このパラメーターを Text に設定する場合、TextWaterMark パラメーターを指定する必要があります。

    • Image：画像ウォーターマーク。このパラメーターを Image に設定する場合、画像ウォーターマークに関連するパラメーターを指定する必要があります。

    • デフォルト値：Image。

    TextWaterMark

    Object

    いいえ

    テキストウォーターマークの設定。詳細については、本トピックの「TextWaterMark」セクションをご参照ください。

    • Type パラメーターが Text に設定されている場合、このパラメーターは必須です。

    • 例：{"Content":"5rWL6K+V5paH5a2X5rC05Y2w","FontName":"SimSun","FontSize":"16","Top":2,"Left":10}。

    InputFile

    Object

    いいえ

    画像ウォーターマークとして使用するファイル。Bucket、Location、Object パラメーターを使用してファイルの場所を指定できます。

    • サポートされているファイルの種類：.png 形式の PNG 静止画像、.apng 形式の PNG アニメーション画像、.mov 形式の MOV ファイル、.gif 形式の GIF ファイル。

    • ファイルは OSS バケットに保存する必要があります。詳細については、本トピックの「入力」セクションをご参照ください。

    • ApsaraVideo Media Processing API では、Object は使用前に URL エンコーディング (UTF-8 ベース) が必要です。

    • 例：{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"}。

    説明

    HDR 以外のタイプの画像ウォーターマークを HDR ビデオに追加すると、画像ウォーターマークの色が不正確になる場合があります。

    WaterMarkTemplateId

    String

    いいえ

    画像ウォーターマークテンプレートの ID。このパラメーターを指定しない場合、画像ウォーターマークに関連するパラメーターには次のデフォルト設定が使用されます：

    • 画像ウォーターマークの位置は TopRight です。

    • Dx と Dy：0。

    • 幅：出力ビデオの幅の 0.12 倍。

    • 高さ：画像ウォーターマークの幅に基づいて比例的にスケーリングされます。

    • 画像ウォーターマークの表示時間：全期間。

    ReferPos

    String

    いいえ

    画像ウォーターマークの位置。

    • 有効な値：TopRight、TopLeft、BottomRight、BottomLeft。

    Dx

    String

    いいえ

    出力ビデオに対する画像ウォーターマークの水平オフセット。このパラメーターを指定すると、指定したウォーターマークテンプレートの対応するパラメーターが上書きされます。次の値のタイプがサポートされています：

    • 整数：水平オフセットのピクセル値。

      • 単位：ピクセル。

      • 有効な値：[8,4096]。

    • 10 進数：出力ビデオの幅に対する水平オフセットの比率。

      • 有効な値：(0,1)。

      • 小数点以下 4 桁までサポートされます (例：0.9999)。超過した小数点以下の桁は破棄されます。

    Dy

    String

    いいえ

    出力ビデオに対する画像ウォーターマークの垂直オフセット。次の値のタイプがサポートされています：

    • 整数：垂直オフセットのピクセル値。

      • 単位：ピクセル。

      • 有効な値：[8,4096]。

    • 10 進数：出力ビデオの高さに対する垂直オフセットの比率。

      • 有効な値：(0,1)。

      • 小数点以下 4 桁までサポートされます (例：0.9999)。超過した小数点以下の桁は破棄されます。

    Width

    String

    いいえ

    画像ウォーターマークの幅は 2 つの方法で設定できます：

    • 整数：ウォーターマークの幅のピクセル値。

      • 範囲：[8,4096]。

      • 単位：ピクセル。

    • 出力ビデオの幅をパーセンテージで表す 10 進数値。

      • 範囲：(0,1)。

      • 小数点以下 4 桁までサポートされます (例：0.9999)。超過した小数点以下の桁は自動的に破棄されます。

    Height

    String

    いいえ

    画像ウォーターマークの高さは 2 つの方法で設定できます：

    • 整数：ウォーターマークの高さのピクセル値。

      • 範囲：[8,4096]。

      • 単位：ピクセル。

    • 出力ビデオの高さに対する高さを指定する 10 進数値。

      • 範囲：(0,1)。

      • 小数点以下 4 桁までサポートされます (例：0.9999)。超過した小数点以下の桁は自動的に破棄されます。

    Timeline

    String

    いいえ

    画像ウォーターマークの表示時間。詳細については、本トピックの「Timeline」セクションをご参照ください。

    テキストウォーターマークパラメーターの詳細

    このパラメーターは Output.WaterMarks.TextWaterMark で参照されます。

    パラメーター

    タイプ

    必須

    説明

    Content

    String

    はい

    ウォーターマークとして表示するテキスト。テキストは Base64 形式でエンコードする必要があります。

    • たとえば、テキストウォーターマーク「テストテキストウォーターマーク」を追加するには、Content を「5rWL6K+V5paH5a2X5rC05Y2w」に設定します。

    説明

    テキストに絵文字や単一引用符 (') などの特殊文字が含まれている場合、ウォーターマークが切り捨てられたり、追加に失敗したりする可能性があります。特殊文字を追加する前にエスケープする必要があります。

    FontName

    String

    いいえ

    フォント。

    • サポートされているフォントの詳細については、「フォント」をご参照ください。

    • デフォルト値：SimSun。

    FontSize

    Int

    いいえ

    フォントサイズ。

    • 有効な値：(4,120)。

    • デフォルト値：16。

    FontColor

    String

    いいえ

    フォントの色。

    • サポートされている色の詳細については、「FontColor」の名前列をご参照ください。

    • デフォルト値：black。

    FontAlpha

    Float

    いいえ

    テキストの透明度。

    • 有効な値：(0,1]。

    • デフォルト値：1.0。

    BorderWidth

    Int

    いいえ

    枠線の幅

    • 単位：ピクセル。

    • 有効な値：[0,4096]。

    • デフォルト値：0。

    BorderColor

    String

    いいえ

    枠線の色。

    • サポートされている色の詳細については、「BorderColor」の名前列をご参照ください。

    • デフォルト値：Black。

    Top

    Int

    いいえ

    テキストの上マージン。

    • 単位：ピクセル。

    • 有効な値：[0,4096]。

    • デフォルト値：0。

    Left

    Int

    いいえ

    左マージン。

    • 単位：ピクセル。

    • 有効な値：[0,4096]。

    • デフォルト値：0。

    Timeline パラメーターの詳細

    Output.WaterMarks.Timeline パラメーターはこのパラメーターを参照します。

    パラメーター

    タイプ

    必須

    説明

    Start

    String

    いいえ

    画像ウォーターマークが表示される時間範囲の開始。

    • 形式：sssss[.SSS]。

    • 有効な値の範囲は [0.000, 86399.999] です。開始時間が持続時間を超えると、トランスコーディングプロセスは失敗します。

    • デフォルト値：0。

    • 例：18000.30。

    Duration

    String

    いいえ

    画像ウォーターマークが表示される時間範囲。

    • パラメーターが ToEND に設定されている場合、ウォーターマークはビデオが終了するまで継続的に表示されます。

    • 形式：sssss[.SSS]。単位：秒。

    • デフォルト値：ToEND。

    ウォーターマークテンプレート設定の詳細

    Config パラメーターは、AddWaterMarkTemplate および UpdateWaterMarkTemplate オペレーションで参照されます。

    パラメーター

    タイプ

    必須

    説明

    Type

    String

    いいえ

    ウォーターマークのタイプ。

    • Image：画像ウォーターマーク。

    • デフォルト値：Image。

    ReferPos

    String

    いいえ

    画像ウォーターマークの位置。

    • 有効な値：TopRight、TopLeft、BottomRight、BottomLeft。

    • 次の図は、ReferPos、Dx、Dy パラメーターを使用して画像ウォーターマークの位置を指定する方法の例を示しています。

    Dx

    String

    いいえ

    出力ビデオに対する画像ウォーターマークの水平オフセット。次の値のタイプがサポートされています：

    • 整数：水平オフセットのピクセル値。

      • 単位：ピクセル。

      • 有効な値：[8,4096]。

    • 10 進数：出力ビデオの幅に対する水平オフセットの比率。

      • 有効な値：(0,1)。

      • 小数点以下 4 桁までサポートされます (例：0.9999)。超過した小数点以下の桁は破棄されます。

    Dy

    String

    いいえ

    出力ビデオに対する画像ウォーターマークの垂直オフセット。次の値のタイプがサポートされています：

    • 整数：垂直オフセットのピクセル値。

      • 単位：ピクセル。

      • 有効な値：[8,4096]。

    • 10 進数：出力ビデオの高さに対する垂直オフセットの比率。

      • 有効な値：(0,1)。

      • 小数点以下 4 桁までサポートされます (例：0.9999)。超過した小数点以下の桁は破棄されます。

    Width

    String

    いいえ

    画像ウォーターマークの幅。次の値のタイプがサポートされています：

    • 整数：ウォーターマークの幅のピクセル値。

      • 単位：ピクセル。

      • 範囲：[8,4096]。

    • 10 進数タイプ：出力ビデオ解像度の幅の比率。

      • 値の範囲：(0,1)。

      • 小数点以下 4 桁までサポートされます (例：0.9999)。超過した小数点以下の桁は自動的に破棄されます。

    Height

    String

    いいえ

    画像ウォーターマークの高さは、次の 2 つの方法のいずれかで設定できます：

    • 整数：ウォーターマークの高さのピクセル値。

      • 単位：ピクセル。

      • 範囲：[8,4096]。

    • 10 進数値：出力ビデオ解像度の高さに対する比率。

      • 値の範囲：(0,1)。

      • 小数点以下 4 桁までサポートされます (例：0.9999)。超過した小数点以下の桁は自動的に破棄されます。

    Timeline

    String

    いいえ

    動的ウォーターマーク：詳細については、「Timeline パラメーターの詳細」をご参照ください。

    次の図は、ReferPos、Dx、Dy パラメーターを使用して画像ウォーターマークの位置を指定する方法の例を示しています。

    Width および Height パラメーターを指定する際は、次の点にご注意ください：

    • Width も Height パラメーターも指定しない場合、ウォーターマークの幅は出力ビデオの幅の 0.12 倍になり、ウォーターマークの高さはウォーターマークの幅と元の画像のアスペクト比に基づいて比例的にスケーリングされます。

    • Width パラメーターのみを指定した場合、ウォーターマークの高さは指定された幅と元の画像のアスペクト比に基づいて比例的にスケーリングされます。Height パラメーターのみを指定した場合、ウォーターマークの幅は指定された高さと元の画像のアスペクト比に基づいて比例的にスケーリングされます。

    • Width と Height の両方のパラメーターを指定した場合、ウォーターマークは指定された幅と高さで表示されます。

    ぼかしの詳細

    このパラメーターは Output.DeWatermark で使用されます。

    {
// 最初のフレームからビデオ画像内の 2 つのウォーターマークをぼかします。最初のウォーターマークはビデオ画像の左上隅から 10 × 10 ピクセル離れており、サイズは 10 × 10 ピクセルです。2 番目のウォーターマークはビデオ画像の左側から 100 ピクセル離れており、サイズは 10 × 10 ピクセルです。ビデオ画像の上部とウォーターマークの間の距離は、ビデオ画像の高さに 0.1 を掛けて計算されます。
       "0": [
              {
                "l": 10,
                "t": 10,
                "w": 10,
                "h": 10
              },
              {
                "l": 100,
                "t": 0.1,
                "w": 10,
                "h": 10
              }
            ],
  // 128,000 ミリ秒でロゴのぼかしを停止します。この場合、ロゴはビデオの開始から 128,000 ミリ秒までぼかされます。
     "128000": [],
  // 250,000 ミリ秒からビデオ画像内のウォーターマークをぼかします。ウォーターマークの幅はビデオ画像の幅の 0.01 倍、ウォーターマークの高さはビデオ画像の高さの 0.05 倍です。ビデオ画像の左側とウォーターマークの間の距離は、ビデオ画像の幅に 0.2 を掛けて計算されます。ビデオ画像の上部とウォーターマークの間の距離は、ビデオ画像の高さに 0.1 を掛けて計算されます。
  "250000": [
              {
                "l": 0.2,
                "t": 0.1,
                "w": 0.01,
                "h": 0.05
              }
            ]
 }

    説明

    • pts：フレームが表示される時点 (ミリ秒単位)。

    • l：ぼかし領域の左マージン。

    • t：ぼかし領域の上マージン。

    • w：ぼかし領域の幅。

    • h：ぼかし領域の高さ。

    l、t、w、h パラメーターの値が 1 より大きい場合、それらはピクセル値として解釈されます。それ以外の場合は、ビデオのディメンションに対する比率として解釈されます。値は最も近い整数に四捨五入され、ぼかし領域が定義されます。

    SubtitleConfig の詳細

    このパラメーターは Output.SubtitleConfig で参照されます。

    パラメーター

    タイプ

    必須

    説明

    ExtSubtitleList

    Object[]

    いいえ

    外部字幕。詳細については、本トピックの「ExtSubtitle」セクションをご参照ください。

    • 1 つのトランスコーディングジョブに最大 4 つの字幕ファイルを追加できます。

    • 例：[{"Input":{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.srt"},"CharEnc":"UTF-8"}]。

    ExtSubtitle の詳細

    このパラメーターは、Output.SubtitleConfig.ExtSubtitle パラメーターのリファレンスです。

    パラメーター

    タイプ

    必須

    説明

    Input

    String

    はい

    外部字幕ファイル。Bucket、Location、Object パラメーターを使用してファイルの場所を指定できます。

    • SRT および ASS 形式がサポートされています。字幕ファイルの色情報を読み取ることができます。

    • ファイルは OSS バケットに保存する必要があります。詳細については、本トピックの「入力」セクションをご参照ください。

    • プレースホルダーがサポートされています。詳細については、本トピックの「プレースホルダーの置換ルール」セクションをご参照ください。

    • OSS オブジェクトのパスは、MPS で使用する前に UTF-8 で URL エンコードする必要があります。詳細については、「URL エンコード」をご参照ください。

    • たとえば、入力ファイルのパスが a/b/example.flv で、字幕ファイルのパスが a/b/example-cn.mp4 の場合、プレースホルダーを使用してオブジェクトを次の形式で指定できます：{ObjectPrefix}{FileName}-cn.srt。パスが URL エンコードされた後、オブジェクトは {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"%7bObjectPrefix%7d%7bFileName%7d-cn.srt"} になります。

    説明

    字幕ファイルの長さがビデオの長さを超える場合、ビデオの長さが優先されます。字幕の文字が多すぎて 1 行に表示できない場合、字幕は切り捨てられます。

    CharEnc

    String

    いいえ

    外部字幕のエンコード形式。

    • 有効な値：UTF-8、GBK、BIG5、auto。

    • デフォルト値：auto。

    説明

    このパラメーターを auto に設定すると、検出された文字セットが実際の文字セットではない可能性があります。このパラメーターを別の値に設定することを推奨します。

    FontName

    String

    いいえ

    字幕のフォント。

    • サポートされているフォントの詳細については、「フォント」をご参照ください。

    • デフォルト値：SimSun。

    FontSize

    Int

    いいえ

    字幕のフォントサイズ。

    • 有効な値：(4,120)。

    • デフォルト値：16。

    Clip の詳細

    このパラメーターは Output.Clip で使用されます。

    パラメーター

    タイプ

    必須

    説明

    TimeSpan

    String

    いいえ

    入力ファイルからクリップをトリミングするタイムスパン。詳細については、本トピックの「TimeSpan」セクションをご参照ください。

    • Duration パラメーターを使用してタイムスパンを指定する例：{"Seek":"00:01:59.999","Duration":"180.30"}。これは、クリップが 1 分 59 秒 999 ミリ秒で開始し、5 分 30 ミリ秒で終了することを指定します。

    • End パラメーターを使用してタイムスパンを指定する例：{"Seek":"00:01:59.999","End":"180.30"}。これは、クリップが 1 分 59 秒 999 ミリ秒で開始し、ビデオの終了 5 分 30 ミリ秒前の時点で終了することを指定します。

    ConfigToClipFirstPart

    Boolean

    いいえ

    最初のセグメントでビデオ編集を実行するかどうかを指定します。

    • true：クリップマージの前にファイルの最初の部分をクリップにトリミングします。

    • false：コンテンツは最初に連結 (トランスコード) されてから編集されます。

    • デフォルト値：false。

    TimeSpan の詳細

    このパラメーターは Output.Clip.TimeSpan で使用されます。

    パラメーター

    タイプ

    必須

    説明

    Seek

    String

    いいえ

    クリップの開始時点。このパラメーターを使用してクリップの開始時点を指定できます。デフォルトの開始時点はビデオの冒頭です。

    • 形式：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効な値：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    • 例：00:01:59.999 または 180.30。

    Duration

    String

    いいえ

    クリップの長さ。Seek パラメーターで指定された時点からのクリップの長さを指定できます。デフォルトでは、クリップの長さは Seek パラメーターで指定された時点からビデオの終わりまでです。Duration と End のいずれか 1 つのパラメーターのみ指定できます。End パラメーターを指定した場合、Duration パラメーターの設定は無効になります。

    • 形式：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効な値：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    • 例：00:01:59.99 または 180.30。

    End

    String

    いいえ

    トリミングする元のビデオのエンディング部分の長さ。Duration と End のいずれか 1 つのパラメーターのみ指定できます。End パラメーターを指定した場合、Duration パラメーターの設定は無効になります。

    • 形式：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効な値：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    • 例：00:01:59.999 または 180.30。

    MergeList 連結パラメーターの詳細

    このパラメーターは Output.MergeList で参照されます。

    パラメーター

    タイプ

    必須

    説明

    MergeURL

    String

    はい

    マージするクリップの OSS パス。

    • OSS オブジェクトのパスは、MPS で使用する前に UTF-8 で URL エンコードする必要があります。詳細については、「URL エンコード」をご参照ください。

    • 例：http://exampleBucket****m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4。

    Start

    String

    いいえ

    出力クリップが元のクリップから切り取られる時点。ビデオの一部のみを出力ファイルにマージする場合は、このパラメーターを指定します。デフォルトの開始時点はビデオの冒頭です。

    • 形式：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効な値：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    • 例：01:59:59.999 または 32000.23。

    Duration

    String

    いいえ

    ミキシングされたビデオの長さ。長さは Start パラメーターで指定された開始時点からの相対的なものです。ビデオの一部のみを出力ファイルにマージする場合は、このパラメーターを指定します。デフォルトでは、長さは Start パラメーターで指定された開始時点からビデオの終わりまでの期間です。

    • 形式：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効な値：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    • 例：01:59:59.999 または 32000.23。

    OpeningList の詳細

    このパラメーターは Output.OpeningList のリファレンスです。

    パラメーター

    タイプ

    必須

    説明

    OpenUrl

    String

    はい

    オープニングパートの OSS パス。

    • OSS オブジェクトのパスは、MPS で使用する前に UTF-8 で URL エンコードする必要があります。詳細については、「URL エンコード」をご参照ください。

    • 例：http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv。

    Start

    String

    いいえ

    入力ビデオが再生されてからオープニングシーンが再生されるまでの経過時間。値は 0 から始まります。

    • 単位：秒。

    • デフォルト値：0。

    Width

    String

    いいえ

    出力ビデオの幅は 3 つの方法で設定できます：

    • 幅：ピクセル単位の幅。値は 0 から 4096 までの整数である必要があります。

    • -1：幅は入力ビデオのオープニングスレートの幅と同じです。

    • Full：ビデオは再生領域全体を埋めます。

    • デフォルト値：-1。

    説明

    出力オープニングパートは、メインパートの中心点を基準に中央揃えされます。オープニングパートの幅は、メインパートの幅以下である必要があります。そうでない場合、結果は不明です。

    Height

    String

    いいえ

    出力ビデオの高さは 3 つの方法で設定できます：

    • 幅：ピクセル単位の幅。値は 0 から 4096 までの整数である必要があります。

    • -1：入力ビデオの高さと同じ。

    • full：ビデオフレーム全体を埋めます。

    • デフォルト値：-1。

    説明

    出力オープニングパートは、メインパートの中心点を基準に中央揃えされます。オープニングパートの高さは、メインパートの高さ以下である必要があります。そうでない場合、結果は不明です。

    TailSlateList の詳細

    このパラメーターは Output.TailSlateList で参照されます。

    パラメーター

    タイプ

    必須

    説明

    TailUrl

    String

    はい

    OSS 内のエンディング動画の URL。

    • OSS オブジェクトのパスは、MPS で使用する前に UTF-8 で URL エンコードする必要があります。詳細については、「URL エンコード」をご参照ください。

    • 例：http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_01.flv。

    BlendDuration

    String

    いいえ

    メインパートの終わりとエンディングパートの始まりの間の時間。トランジション中、メインパートの最後のフレームはフェードアウトし、エンディングパートの最初のフレームはフェードインします。

    • 単位：秒。

    • デフォルト値：0。

    Width

    String

    いいえ

    出力エンディングパートの幅。有効な値：

    • 幅：ピクセル単位の幅は [0, 4096] の範囲内である必要があります。

    • -1：幅は入力アウトロビデオの幅と同じです。

    • full：ビデオはフレーム全体を埋めます。

    • デフォルト値：-1。

    説明

    出力エンディングパートは、メインパートの中心点を基準に中央揃えされます。エンディングパートの幅は、メインパートの幅以下である必要があります。そうでない場合、結果は不明です。

    Height

    String

    いいえ

    出力エンディングスレートの高さには 3 つの設定があります：

    • 幅：ピクセル単位の幅。値は 0 から 4096 までの整数である必要があります。

    • -1：入力スレートビデオの高さ。

    • full：ビデオは再生領域を埋めます。

    • デフォルト値：-1。

    説明

    出力エンディングパートは、メインパートの中心点を基準に中央揃えされます。エンディングパートの高さは、メインパートの高さ以下である必要があります。そうでない場合、結果は不明です。

    IsMergeAudio

    Boolean

    いいえ

    アウトロビデオの音声を付加するかどうかを指定します。

    • true：連結を有効にします。

    • false：連結は行われません。

    • デフォルト値：true。

    BgColor

    String

    いいえ

    エンディングパートの幅と高さがメインパートよりも小さい場合のマージンの色。

    • サポートされている色の詳細については、「bgcolor」の名前列をご参照ください。

    • デフォルト値：White。

    Amix ミックスの詳細

    Output.Amix はこのパラメーターを参照します。

    パラメーター

    タイプ

    必須

    説明

    AmixURL

    String

    はい

    ミキシングする音声ストリームは 2 つのモードをサポートします：

    • input：入力ファイルの複数の音声ストリームをミキシングします。入力ファイルの 2 つの音声ストリームをミキシングできます。

    • OSS パス：外部音声ストリームを追加します。たとえば、BGM を追加できます。入力ファイルの音声ストリームを OSS パスで指定された音声ストリームとミキシングできます。例：http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail.flv。

    Map

    String

    いいえ

    AmixURL でミキシングするターゲット音声ストリームを選択するには、AudioStreamMap パラメーターを使用して入力ファイル内の音声ストリームの序数を指定します。

    • 形式：0:a:{シリアル番号}。シリアル番号は音声ストリームの添字を指定します。シリアル番号は 0 から始まります。

    • たとえば、0:a:1 は 2 番目の音声ストリームを指定します。

    MixDurMode

    String

    いいえ

    ミキシングされた出力ファイルの持続時間。

    • first：入力ファイルの長さが使用されます。

    • longest：入力ファイルと AmixURL パラメーターで指定された音声ストリームの長さのうち、長い方が使用されます。

    • デフォルト値：longest。

    Start

    String

    いいえ

    音声ストリームの開始時点。音声の一部のみを出力ファイルにミキシングする場合は、このパラメーターを指定します。デフォルトの開始時点は音声の冒頭です。

    • 形式：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効な値：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    • 例：00:01:59.999 または 18000.30。

    Duration

    String

    いいえ

    ミキシングされた音声の長さ。長さは Start パラメーターで指定された開始時点からの相対的なものです。音声の一部のみを出力ファイルにミキシングする場合は、このパラメーターを指定します。デフォルトでは、長さは Start パラメーターで指定された開始時点から音声の終わりまでの期間です。

    • 形式：hh:mm:ss[.SSS] または sssss[.SSS]。

    • 有効な値：[00:00:00.000,23:59:59.999] または [0.000,86399.999]。

    • 例：00:01:59.999 または 18000.30。

    MuxConfig の詳細

    このパラメーターは Output.MuxConfig に適用されます。

    パラメーター

    タイプ

    必須

    説明

    Segment

    String

    いいえ

    セグメント設定。詳細については、本トピックの「セグメント」セクションをご参照ください。

    • このパラメーターは、コンテナ形式が M3U8、HLS-FMP4、MPD、または CMAF に設定されている場合にのみ有効です。

    • 例：{"Duration":"10","ForceSegTime":"1,2,4,6,10,14,18"}。これは、ビデオが 1、2、4、6、10、14、18、20、30、40、50... 秒で強制的にセグメント化されることを指定します。

    セグメントの詳細

    このパラメーターは Output.MuxConfig.Segment で参照されます。

    パラメーター

    タイプ

    必須

    説明

    Duration

    Int

    いいえ

    セグメント期間。

    • 単位：秒。

    • 有効な値：[1,60]。

    • デフォルト値：10。ビデオが 10、20、30、40 秒で強制的にセグメント化されることを指定します。

    ForceSegTime

    String

    いいえ

    ビデオが強制的にセグメント化される時点。時点をコンマ (,) で区切ります。最大 10 個の時点を指定できます。

    • 形式：{時点},{時点},{時点}。

    • タイプ：10 進数。このパラメーターは小数点以下 3 桁までサポートします。

    • 単位：秒。

    • 例：1,2,4,6,10,14,18。ビデオが 1、2、4、6、10、14、18 秒で強制的にセグメント化されることを指定します。

    非標準 M3U8 パラメーターのサポート詳細

    このパラメーターは Output.M3U8NonStandardSupport のリファレンスです。

    パラメーター

    タイプ

    必須

    説明

    TS

    Object

    いいえ

    TS ファイルの非標準サポート。詳細については、本トピックの「TS」セクションをご参照ください。

    TS パラメーターのサポート詳細

    TS パラメーターは、Output.M3U8NonStandardSupport.TS パラメーターで参照されます。

    パラメーター

    タイプ

    必須

    説明

    Md5Support

    Boolean

    いいえ

    各 TS ファイルの MD5 値を出力 M3U8 ビデオに含めるかどうかを指定します。

    SizeSupport

    Boolean

    いいえ

    各 TS ファイルのサイズを出力 M3U8 ビデオに含めるかどうかを指定します。

    暗号化パラメーターの詳細

    このパラメーターは Output.Encryption で使用されます。

    パラメーター

    タイプ

    必須

    説明

    Type

    String

    はい

    ビデオの暗号化方式。有効な値：

    • hls-aes-128：標準暗号化。

    KeyType

    String

    はい

    キー暗号化方式。

    • Base64：基本暗号化方式。

    • KMS：Key Management Service (KMS)。KMS は平文キーと暗号文キーを生成するために使用されます。

    Key

    String

    はい

    暗号化されたビデオの暗号文キー。キーの形式は暗号化方式によって決まります。

    • Base64：

      • Base64 を使用して平文キーを暗号化し、このパラメーターを生成された暗号文キーに設定します。

      • 平文キーはカスタマイズされ、最大 16 文字の長さにすることができます。

      • たとえば、平文キー「encryptionkey128」に対応する暗号文キーは「ZW5jcnlwdGlvbmtleTEyOA==」です。

    • KMS：

      • GenerateKMSDataKey オペレーションを呼び出し、カスタマーマスターキー (CMK) を渡し、KeySpec パラメーターを AES_128 に設定して、CiphertextBlob パラメーターから対応する暗号文キーを取得します。

    説明

    マスターキーは Alibaba Cloud から提供されます。キーを取得するには、チケットを送信する必要があります。

    KeyUri

    String

    はい

    これは復号サービスのエンドポイントです。サービスはご自身で設定する必要があります。

    • URL は平文で MPS に渡すことはできません。URL を Base64 で暗号化する必要があります。

    • たとえば、URL が http://aliyun.com/document/hls128.key の場合、URL は Base64 で aHR0cDovL2FsaXl1bi5jb20vZG9jdW1lbnQvaGxzMTI4LmtleQ== に暗号化されます。

    SkipCnt

    String

    いいえ

    ビデオの冒頭で暗号化されないクリップの数。これにより、起動時の読み込み時間が短縮されます。

    • 例：3。

    プレースホルダーの置換ルール

    ファイルパスでは次のプレースホルダーを使用できます。

    たとえば、入力ファイルのパスが a/b/example.flv で、出力ファイルのパスを a/b/c/example+test.mp4 にしたい場合、{ObjectPrefix} および {FileName} プレースホルダーを使用して出力ファイルのパスを指定できます。URL エンコードされたパスは %7BObjectPrefix%7D/c/%7BFileName%7D%2Btest.mp4 です。

    プレースホルダーの説明

    トランスコーディング出力ファイル

    キャプション入力

    スナップショット出力ファイル

    プレースホルダー

    説明

    ワークフローを使用してトランスコーディングを実行

    トランスコーディングジョブを送信

    字幕

    ワークフローのスクリーンショットを撮る

    スナップショットジョブを送信

    {ObjectPrefix}

    入力ファイルのプレフィックス。

    サポート

    サポートされています

    サポート

    サポート

    サポートされています

    {FileName}

    ファイル名を入力

    サポートされています

    サポート

    サポートされています

    サポートされています

    サポート

    {ExtName}

    入力ファイルのファイル名拡張子。

    サポートされています

    サポートされています

    サポート

    サポートされています

    サポート

    {DestMd5}

    出力ファイルの MD5 値。

    サポートされています

    サポート

    サポートされていません

    サポートされていません

    サポートされていません

    {DestAvgBitrate}

    出力ファイルの平均ビットレート。

    サポートされています

    サポートされています

    サポートされていません

    サポートされていません

    サポートされていません

    {SnapshotTime}

    スナップショットの時点。

    サポートされていません

    サポートされていません

    サポートされていません

    サポート

    サポートされています

    {Count}

    一度にキャプチャされる複数のスナップショット内のスナップショットのシリアル番号。

    サポートされていません

    サポートされていません

    サポートされていません

    サポート

    サポート

    {RunId}

    ワークフローの実行インスタンスの ID。

    サポート

    サポートされていません

    サポートされていません

    サポートされていません

    サポートされていません

    {MediaId}

    ワークフロー内のメディアファイルの ID。

    サポート

    サポートされていません

    サポートされていません

    サポートされていません

    サポートされていません

    SnapshotConfig

    SubmitSnapshotJob オペレーションは SnapshotConfig パラメーターを参照します。

    重要

    スナップショットジョブは同期モードまたは非同期モードで実行できます。非同期モードでは、完了時間は保証されません。スナップショットジョブを送信すると、ジョブはスケジュールおよび実行されるために MPS キューに追加されます。その結果、SubmitSnapshotJob オペレーションからの応答が返されたときにスナップショットが利用できない場合があります。ジョブが完了した後、QuerySnapshotJobList オペレーションを呼び出して実行結果をポーリングするか、MPS キューの MNS 通知を設定して結果を受信できます。詳細については、「」をご参照ください。Interval または Num パラメーターを指定した場合、ジョブは非同期モードで実行されます。

    パラメーター

    タイプ

    必須

    説明

    Num

    String

    いいえ

    キャプチャするスナップショットの数。

    • Interval または Num パラメーターのいずれかを指定した場合、デフォルトで非同期モードが使用されます。Num パラメーターの値は 0 より大きい必要があります。

    • Num および Interval パラメーターを空のままにし、Time パラメーターを指定した場合、システムは指定した時間に同期的に 1 つのスナップショットをキャプチャします。

    • Num パラメーターを 1 に設定し、Time パラメーターを指定した場合、システムは指定した時間に非同期的に 1 つのスナップショットをキャプチャします。

    • Num パラメーターを 1 より大きい値に設定した場合、システムは Time パラメーターに指定した時間に非同期的にスナップショットのキャプチャを開始し、キャプチャされたスナップショットの数が Num パラメーターに指定した数に達すると停止します。スナップショットは Interval パラメーターで指定された間隔でキャプチャされます。Interval パラメーターを指定しない場合、スナップショットは 10 秒ごとにキャプチャされます。Time + Interval × Num の結果が入力ビデオの長さを超える場合、入力ビデオの長さ内の時点でのみキャプチャされたスナップショットが生成されます。スナップショットが生成された後、実際のスナップショット数が返されます。

    • Num パラメーターを 1 より大きい値に設定し、Interval パラメーターを 0 に設定した場合、システムは Time パラメーターに指定した時点で非同期的にスナップショットのキャプチャを開始します。スナップショットの数は Num パラメーターによって決定され、スナップショットは入力ビデオの長さ内で均等にキャプチャされます。

    Time

    String

    いいえ

    システムが入力ビデオでスナップショットのキャプチャを開始する時点。

    • 単位：ミリ秒。

    • Time パラメーターの値がビデオの長さを超える場合、スナップショットの生成は失敗します。

    • このパラメーターは、特定の時点でスナップショットをキャプチャする場合は不要です。他のシナリオでは、このパラメーターは必須です。

      説明

      特定の時点でスナップショットをキャプチャするシナリオでは、MPS は TimeArray パラメーターの最小時点をミリ秒単位の値に変換します。この値はこのシナリオの Time パラメーターに使用されます。出力パスに {SnapshotTime} プレースホルダーを指定した場合、プレースホルダーは Time パラメーターの値に置き換えられます。

    Interval

    String

    いいえ

    スナップショットがキャプチャされる間隔。

    • このパラメーターを指定すると、スナップショットをキャプチャするために非同期モードが自動的に使用されます。

    • 複数のスナップショットを非同期的にキャプチャする場合は、Interval パラメーターを 0 より大きい値に設定します。単位：秒。

    • 非同期平均スクリーンショットの間隔は 0 です。

    • デフォルト値は 10 です。この値は、`Num` が設定されているがこのパラメーターが設定されていない場合に送信されます。

    TimeArray

    Array

    いいえ

    特定の時点の配列。このパラメーターは、特定の時点でスナップショットをキャプチャする場合に必須です。

    • 値はミリ秒単位の一意の整数である必要があります。

    • 時点はビデオの長さを超えることはできません。超えた場合、スナップショットはキャプチャできません。

    • 時点は順序通りまたは順序不同で指定できます。順序通りに指定することを推奨します。順序不同で指定した場合、MPS はこれらの時点をソートします。

    重要

    • このパラメーターを指定する場合、Num、Time、Interval パラメーターは指定しないでください。指定した場合、InvalidParameter.Ambiguity エラーが報告されます。

    • MPS SDK V3.3.60 以降では、特定の時点でのスナップショットキャプチャがサポートされています。SDK のバージョンを確認するには、こちらをクリックしてください。

    FrameType

    String

    いいえ

    スクリーンショットのタイプを指定します。

    • デフォルト値：intra。

    • normal：通常フレーム。通常フレームの画質はキーフレームよりも劣ります。また、通常フレームのキャプチャにはキーフレームよりも時間がかかります。ただし、通常フレームは特定の時点でキャプチャできます。

    • intra (デフォルト)：キーフレーム。ビデオのキーフレームは画質が良く、独立してデコードされるため迅速にキャプチャできます。ただし、キーフレームはビデオ内で間隔を置いて出現するため、特定の時点でキャプチャすることはできません。指定した時点が正確でない場合、システムは指定した時点に最も近いキーフレームをキャプチャします。この場合、2 つのキーフレーム間の距離がスナップショットのキャプチャ間隔よりも大きいと、生成されるスナップショットの数がキャプチャしたいスナップショットの数よりも少なくなる可能性があります。

    説明

    時点指定のスクリーンショットシナリオは、通常フレームのスクリーンショットに限定されます。

    Width

    String

    いいえ

    スナップショットの幅。

    • 単位：ピクセル。

    • 有効な値：[8,4096]。偶数を指定することを推奨します。

    • デフォルト値：

      • デフォルトでは、幅または高さを指定しない場合、入力ビデオの幅が使用されます。

      • 高さのみが指定されている場合、スナップショットの幅は入力ビデオのアスペクト比に基づいて計算されます。

    Height

    String

    いいえ

    スナップショットの高さ。

    • 単位：ピクセル。

    • 有効な値：[8,4096]。偶数を指定することを推奨します。

    • デフォルト値：

      • デフォルトでは、幅または高さを指定しない場合、入力ビデオの高さが使用されます。

      • 幅のみが指定されている場合、スナップショットの高さは入力ビデオのアスペクト比に基づいて計算されます。

    BlackLevel

    String

    いいえ

    スナップショット内の黒ピクセルの上限。スナップショット内の黒ピクセルがこの値を超えると、システムは画像がブラックスクリーンであると判断します。黒ピクセルの詳細については、PixelBlackThreshold パラメーターの説明をご参照ください。

    このパラメーターは、次の条件が満たされた場合に有効になります：

    • Time パラメーターを 0 に設定した場合、このパラメーターが有効になり、ブラックスクリーンが識別されます。Time パラメーターを 0 より大きい値に設定した場合、ブラックスクリーンは識別できません。

    • Time パラメーターを 0 に設定し、Num パラメーターを 1 に設定するか、Num パラメーターを空のままにすると、ビデオの最初の 5 秒間がチェックされます。通常のビデオ画像が存在する場合、画像がキャプチャされます。それ以外の場合、スナップショットの生成は失敗します。

    • Time パラメーターを 0 に設定し、Num パラメーターを 1 より大きい値に設定した場合、このパラメーターが有効になります。ビデオの最初の 5 秒間がチェックされます。通常のビデオ画像が存在する場合、画像がキャプチャされます。最初の 5 秒間にブラックスクリーンのみが含まれている場合、最初のフレームがキャプチャされます。

    パラメーターの説明：

    • 有効な値：[30,100]。

    • デフォルト値：100。

    • ベストプラクティス：純粋な黒を 100 に設定できます。

    • たとえば、Time パラメーターを 0 に、Num パラメーターを 10 に設定すると、純粋なブラックスクリーンはフィルターされます。

    PixelBlackThreshold

    String

    いいえ

    ピクセルの色値のしきい値。ピクセルの色値がしきい値よりも低い場合、システムはそのピクセルを黒ピクセルと判断します。

    • 有効な値：[0,255]。0 は純粋な黒ピクセルを指定し、255 は純粋な白ピクセルを指定します。

    • ブラックスクリーンのフィルタリングを改善したい場合は、このパラメーターに高い値を指定します。このパラメーターを 30 に設定し、必要に応じて値を調整することを推奨します。

    • たとえば、このパラメーターを 100 に設定すると、色値が 100 未満のピクセルは黒ピクセルと見なされます。

    Format

    String

    いいえ

    出力ファイルの形式。

    • このパラメーターを vtt に設定すると、出力ファイルは WebVTT 形式になります。WebVTT ファイルを生成するかどうかを決定するには、SubOut パラメーターを指定する必要があります。

    • デフォルトでは、このパラメーターは空のままです。この場合、出力ファイルは JPG 形式で生成されます。

    SubOut

    Object

    いいえ

    WebVTT ファイルの設定。詳細については、本トピックの「SubOut Webvtt」セクションをご参照ください。

    • このパラメーターは、Format パラメーターが vtt に設定されている場合に必須です。

    TileOut

    Object

    いいえ

    イメージスプライトの設定。詳細については、本トピックの「TileOut」セクションをご参照ください。

    • このパラメーターを設定すると、生成されたスナップショットがイメージスプライトに結合されます。TileOutputFile パラメーターは出力イメージスプライトを指定します。

    • このパラメーターを空のままにすると、イメージスプライトは生成されません。

    OutputFile

    Object

    はい

    出力は、OSS Bucket、Location、Object で指定された場所に保存される単一の小さな画像ファイルです。詳細については、「OutputFile スクリーンショットの詳細」をご参照ください。

    • スナップショットファイルは JPG 形式です。

    • 例：{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.jpg"}。

    TileOutputFile

    Object

    いいえ

    出力イメージスプライト。OSS 内のオブジェクトのストレージパスを指定する必要があります。このパラメーターの値は OutputFile パラメーターの値と似ています。

    • このパラメーターは、TileOut パラメーターを指定してイメージスプライトを生成する場合に必須です。

    • パズルファイルは JPG 形式です。

    • 例：{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.jpg"}。

    説明

    • Num パラメーターに 1 より大きい値を設定した場合、プレースホルダー {TileCount} を使用してオブジェクト名を置き換える必要があります。この名前は、MPS で使用する前にエンコードする必要があります。エンコードされたオブジェクト名のフォーマットは %7BTileCount%7D です。エンコードされたオブジェクト名を使用して、異なるオブジェクトのストレージパスを区別できます。たとえば、3 つのスナップショットをキャプチャした場合、出力ファイルの名前は 00001.jpg、00002.jpg、00003.jpg になります。

    • 元のスナップショットとイメージスプライトを保存したい場合は、ファイルが上書きされないように、元のスナップショットとイメージスプライトに異なるストレージパスを指定します。

    SubOut Webvtt 設定の詳細

    SnapshotConfig.SubOut パラメーターはこのパラメーターを参照します。

    パラメーター

    タイプ

    必須

    説明

    IsSptFrag

    String

    いいえ

    WebVTT インデックスファイルを生成するかどうかを指定します。有効な値：

    • true：WebVTT インデックスファイルを生成します。WebVTT インデックスファイルはスナップショットと同じパスに保存されます。

    • false：WebVTT インデックスファイルを生成しません。スナップショットのみがエクスポートされます。

    • デフォルト値：false。

    TileOut 結合設定の詳細

    このパラメーターは SnapshotConfig.TileOut で使用されます。

    パラメーター

    タイプ

    必須

    説明

    Lines

    Int

    いいえ

    タイル化されたスナップショットに含まれる行数。

    • 有効な値：(0,10000]。

    • デフォルト値：10。

    Columns

    Int

    いいえ

    タイル化されたスナップショットに含まれる列数。

    • 有効な値：(0,10000]。

    • デフォルト値：10。

    CellWidth

    String

    いいえ

    単一画像の幅。

    • 単位：ピクセル。

    • デフォルト値：元のスナップショットの幅。

    CellHeight

    String

    いいえ

    単一画像の高さ。

    • 単位：ピクセル。

    • デフォルト値：元のスナップショットの高さ。

    Padding

    String

    いいえ

    単一画像のピッチ

    • 単位：ピクセル。

    • デフォルト値：0。

    Margin

    String

    いいえ

    フレーム幅。

    • デフォルト値：0。

    • 単位：ピクセル。

    Color

    String

    いいえ

    背景色。マージン、スナップショット間のパディング、スナップショットが表示されない領域を埋めるために使用される背景色。

    • このパラメーターには色のキーワードまたはランダムな値を指定できます。たとえば、背景色を黒に設定したい場合は、色のキーワードを次のいずれかの形式で指定できます：Black、black、#000000。

    • デフォルト値：black。

    IsKeepCellPic

    String

    いいえ

    個々のサムネイルを保持するかどうかを決定します。

    • true：単一グラフは OutputFile に保存されます。

    • false：項目は保持されません。

    • デフォルト：false (保持されません)。

    OutputFile スクリーンショットの詳細

    パラメーター

    タイプ

    必須

    説明

    Bucket

    String

    はい

    個々の小さな画像の出力ファイルを保存する OSS バケット。

    • バケットは OSS バケットの定義に準拠する必要があります。詳細については、「基本概念」をご参照ください。

    Location

    String

    はい

    OSS バケットが存在するリージョン。

    • OSS バケットは MPS と同じリージョンに存在する必要があります。

    • OSS リージョンの定義に従ってください。詳細については、「基本概念」をご参照ください。

    Object

    String

    はい

    出力スナップショットが OSS に保存されるパス。

    • パスにはファイル名とファイル名拡張子が含まれます。オブジェクトキーという用語の詳細については、「用語」をご参照ください。

    • プレースホルダーがサポートされています。詳細については、本トピックの「プレースホルダーの置換ルール」セクションをご参照ください。

    • サポートされているファイル名拡張子は .jpg のみです。

    • OSS オブジェクトのパスは、MPS で使用する前に UTF-8 で URL エンコードする必要があります。詳細については、「URL エンコード」をご参照ください。

    説明

    • `Num` パラメーターに 1 より大きい値を設定した場合は、プレースホルダー {Count} を使用してオブジェクト名を置き換える必要があります。この名前は、MPS で使用する前にエンコードする必要があります。エンコードされたオブジェクト名のフォーマットは %7BCount%7D です。エンコードされたオブジェクト名を使用すると、異なるオブジェクトのストレージパスを区別できます。たとえば、3 つのスナップショットをキャプチャすると、出力ファイルは 00001.jpg、00002.jpg、00003.jpg という名前になります。

    • 元のスナップショットとイメージスプライトを保存したい場合は、ファイルが上書きされないように、元のスナップショットとイメージスプライトに異なるストレージパスを指定します。

    NotifyConfig の詳細

    NotifyConfig パラメーターは、AddPipeline および UpdatePipeline オペレーションで参照されます。

    パラメーター

    タイプ

    必須

    説明

    QueueName

    String

    いいえ

    アタッチする MNS キュー。MPS キュー内のジョブが完了すると、その実行結果がこのキューに送信されます。メッセージ通知の受信方法の詳細については、「メッセージ通知の受信」をご参照ください。

    • QueueName と Topic のいずれかのパラメーターを指定できます。

    • 有効な値：作成した MNS トピック。アクティブなトピックがない場合は、Simple Message Queue (旧称：MNS) に移動して作成できます。

    Topic

    String

    いいえ

    通知を受信する SMQ トピック。ジョブが完了すると、ジョブの結果が SMQ トピックにプッシュされます。その後、SMQ トピックは、トピックをサブスクライブしている複数のキューまたは URL にメッセージをプッシュします。通知の受信の詳細については、「通知の受信」をご参照ください。

    • QueueName と Topic のいずれかのパラメーターを指定できます。

    • 値は、作成した MNS トピックである必要があります。利用可能なトピックがない場合は、Simple Message Queue (旧称：MNS) コンソールに移動して作成します。

    トランスコーディングジョブの入力詳細

    パラメーター

    タイプ

    必須

    説明

    Bucket

    String

    はい

    入力ファイルを保存する OSS バケット。

    • OSS コンソールのバケット認証ページで、ApsaraVideo Media Processing に OSS バケットの読み取り権限を付与します。

    • バケットは OSS バケットの定義に準拠する必要があります。詳細については、「用語集」をご参照ください。

    Location

    String

    はい

    OSS バケットが存在するリージョン。

    OSS Location の定義に従ってください。詳細については、「用語集」をご参照ください。

    Object

    String

    はい

    入力ファイルとして使用される OSS オブジェクト。

    • OSS オブジェクトのパスは RFC 2396 に準拠し、UTF-8 で URL エンコードされている必要があります。詳細については、「URL エンコード」をご参照ください。

    • これは OSS オブジェクトの定義に準拠しています。詳細については、「用語集」をご参照ください。

    Audio

    String

    いいえ

    入力ファイルの音声設定。値は JSON オブジェクトである必要があります。

    説明

    このパラメーターは、入力ファイルが ADPCM または PCM 形式の場合に必須です。

    • 詳細については、本トピックの「InputAudio」セクションをご参照ください。

    • 例：{"Channels":"2","Samplerate":"44100"}。

    Container

    String

    いいえ

    入力ファイルのコンテナ設定。値は JSON オブジェクトである必要があります。

    説明

    このパラメーターは、入力ファイルが ADPCM または PCM 形式の場合に必須です。

    • 詳細については、本トピックの「InputContainer」セクションをご参照ください。

    • 例：{"Format":"u8"}。

    InputContainer の詳細

    パラメーター

    タイプ

    必須

    説明

    Format

    String

    はい

    入力ファイルの音声形式。

    有効な値：alaw、f32be、f32le、f64be、f64le、mulaw、s16be、s16le、s24be、s24le、s32be、s32le、s8、u16be、u16le、u24be、u24le、u32be、u32le、u8。

    InputAudio の詳細

    パラメーター

    タイプ

    必須

    説明

    Channels

    String

    はい

    入力ファイルのサウンドチャンネル数。有効な値：[1,8]。

    Samplerate

    String

    はい

    入力ファイルの音声サンプリングレート。

    • 有効な値：(0,320000]。

    • 単位：Hz。

    AnalysisConfig の詳細

    パラメーター

    タイプ

    必須

    説明

    QualityControl

    String

    いいえ

    出力ファイルの品質設定。値は JSON オブジェクトである必要があります。詳細については、本トピックの「QualityControl」セクションをご参照ください。

    PropertiesControl

    String

    いいえ

    プロパティ設定。値は JSON オブジェクトである必要があります。詳細については、本トピックの「PropertiesControl」セクションをご参照ください。

    QualityControl の詳細

    パラメーター

    タイプ

    必須

    説明

    RateQuality

    String

    いいえ

    出力ファイルの品質レベル。

    • 有効な値：(0,51)。

    • 値は整数である必要があります。

    • デフォルト値：25。

    MethodStreaming

    String

    いいえ

    再生モード。有効な値：network、local。

    デフォルト値：network。

    PropertiesControl の詳細

    パラメーター

    タイプ

    必須

    説明

    Deinterlace

    String

    いいえ

    強制スキャンモードの決定。

    • Auto は Automatic の略です。

    • Force：インターレース解除を強制的に実行します。

    • None：インターレース解除を禁止します。

    Crop

    String

    いいえ

    ビデオイメージのクロッピング構成。

    • デフォルト値は Automatic です。

    • このパラメーターを空の JSON オブジェクトに設定しない場合、Mode パラメーターは必須です。

    • 詳細については、本トピックの「Crop」セクションをご参照ください。

    Crop の詳細

    パラメーター

    タイプ

    必須

    説明

    Mode

    String

    いいえ

    このパラメーターは、Crop パラメーターの値が空の JSON オブジェクトでない場合に必須です。有効な値：

    • Auto (自動)

    • Force：トリミングを強制的に実行します。

    • None：操作は実行されません。

    Width

    Integer

    いいえ

    トリミングされた幅

    • 有効な値：[8,4096]。

    • Mode パラメーターを Auto または None に設定した場合、このパラメーターの設定は無効になります。

    Height

    Integer

    いいえ

    トリミングされた画像の高さ。

    • 有効な値：[8,4096]。

    • Mode パラメーターを Auto または None に設定した場合、このパラメーターの設定は無効になります。

    Top

    Integer

    いいえ

    トリミングする上マージン。

    • 有効な値：[8,4096]。

    • Mode パラメーターを Auto または None に設定した場合、このパラメーターの設定は無効になります。

    Left

    Integer

    いいえ

    トリミングする左マージン。

    • 有効な値：[8,4096]。

    • Mode パラメーターを Auto または None に設定した場合、このパラメーターの設定は無効になります。

    TransFeatures の詳細

    パラメーター

    タイプ

    必須

    説明

    MergeList

    String

    いいえ

    ビデオ連結の設定フィールド。

    • 値は、最大 4 つの MergeURL パラメーターを含む JSON 配列である必要があります。詳細については、本トピックの「MergeList」セクションをご参照ください。

    • 例：[{"MergeURL":"http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/k/mp4.mp4"},{"MergeURL":"http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/c/ts.ts","Start":"1:14","Duration":"29"}]。

    ジョブ出力ファイルの詳細

    パラメーター

    タイプ

    必須

    説明

    URL

    String

    いいえ

    OSS 内の入力ファイルの URL。

    • 例：http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example.flv。

    • このパラメーターを指定しない場合、Bucket、Location、Object パラメーターは必須です。

    Bucket

    String

    いいえ

    • この値は、URL を指定しない場合に必須です。

    • それ以外の場合、このパラメーターの設定は無効です。OSS バケットを指定する前に、OSS コンソールのアクセスコントロールページで MPS に OSS バケットの書き込み権限を付与します。

    • バケットという用語の詳細については、「用語集」をご参照ください。

    Location

    String

    いいえ

    • この値は、URL を指定しない場合に必須です。

    • それ以外の場合、値は無効で、OSS バケットのデータセンター (OSS Location) が出力されます。

    • これは OSS Location の定義に準拠しています。詳細については、「用語集」をご参照ください。

    Object

    String

    いいえ

    • この値は、URL を指定しない場合に必須です。

    • 値が無効な場合、出力ファイル (OSS オブジェクト) は UTF-8 でエンコードされ、RFC 2396 で指定されているように URL エンコードされます。詳細については、「URL エンコーディング」をご参照ください。

    • これは OSS オブジェクトの定義に準拠する必要があります。詳細については、「用語集」をご参照ください。

    MultiBitrateVideoStream の詳細

    パラメーター

    タイプ

    必須

    説明

    URI

    String

    いいえ

    出力ビデオストリームの名前。末尾は .m3u8 である必要があります。例：a/b/test.m3u8。形式：^[a-z]{1}[a-z0-9./-]+$。

    RefActivityName

    String

    はい

    関連付けられたアクティビティの名前。

    ExtXStreamInfo

    Json

    はい

    ストリームに関する情報。例：{"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}。

    ExtXMedia の詳細

    パラメーター

    タイプ

    必須

    説明

    Name

    String

    はい

    リソースの名前。名前は最大 64 バイトの長さで、UTF-8 でエンコードされている必要があります。このパラメーターは、HTTP Live Steaming (HLS) V5 プロトコルの NAME に対応します。

    Language

    String

    いいえ

    オプション。HLS V5 プロトコルの `LANGUAGE` 属性に対応する RFC 5646 形式の言語コード。

    URI

    String

    はい

    リソースのパス。

    形式：^[a-z]{1}[a-z0-9./-]+$。例：a/b/c/d/audio-1.m3u8。

    MasterPlayList の詳細

    パラメーター

    タイプ

    必須

    説明

    MultiBitrateVideoStreams

    JsonArray

    はい

    複数のストリームの配列。例：[{"RefActivityName": "video-1","ExtXStreamInfo": {"BandWidth": "111110","Audio":"auds","Subtitles": "subs"}}]。

    ExtXStreamInfo の詳細

    パラメーター

    タイプ

    必須

    説明

    BandWidth

    String

    はい

    帯域幅。このパラメーターは合計ビットレートの上限を指定し、HLS V5 プロトコルの BANDWIDTH に対応します。

    Audio

    String

    いいえ

    音声ストリームグループの ID。このパラメーターは HLS V5 プロトコルの AUDIO に対応します。

    Subtitles

    String

    いいえ

    字幕ストリームグループの ID。このパラメーターは HLS V5 プロトコルの SUBTITLES に対応します。

    AdaptationSet の詳細

    パラメーター

    タイプ

    必須

    説明

    Group

    String

    はい

    グループの名前。例：

    <AdaptationSet group="videostreams" mimeType="video/mp4" par="4096:1744"
              minBandwidth="258157" maxBandwidth="10285391" minWidth="426" maxWidth="4096"
              minHeight="180" maxHeight="1744" segmentAlignment="true"
              startWithSAP="1">

    Lang

    String

    いいえ

    リソースの言語。このパラメーターは、音声および字幕リソースに指定できます。

    Representation の詳細

    パラメーター

    タイプ

    必須

    説明

    Id

    String

    はい

    ストリームの ID。例：

    <Representation id="240p250kbps" frameRate="24" bandwidth="258157"
              codecs="avc1.4d400d" width="426" height="180">

    URI

    String

    はい

    リソースのパス。形式：^[a-z]{1}[a-z0-9./-]+$。例：a/b/c/d/video-1.mpd。

    InputConfig の詳細

    パラメーター

    タイプ

    必須

    説明

    Format

    String

    はい

    入力字幕ファイルの形式。有効な値：stl、ttml、vtt。

    InputFile

    String

    はい

    {"Bucket":"example-bucket-****","Location":"oss-cn-hangzhou","Object":"example-logo****.png"}
              または
              {"URL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/subtitle/test****.chs.vtt"}