メディア処理のパラメータ - - Alibaba Cloud ドキュメントセンター

EncryptConfig: HLS暗号化の設定を指定します。

パラメーター	データ型	必須／任意	説明
CipherText	String	必須	The ciphertext key that is used to obtain the plaintext key.
DecryptKeyUri	String	必須	暗号文キーに基づいて復号化キーを取得するために使用されるアドレス。例: `http://example.aliyundoc.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt`
KeyServiceType	String	必須	キーサービスのタイプ。デフォルト値: KMS。Alibaba CloudのKey Management Serviceを示します。

EncryptConfigパラメーターの例

{
  "CipherText":"ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt" 、
  "DecryptKeyUri":"http://example.aliyundoc.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt" 、
  "KeyServiceType":"KMS"
}

OverrideParams: コード変換ジョブの設定を指定します。

パラメーター	データ型	必須／任意	説明
透かし加工	透かし []	任意	透かしの設定。透かしを置き換えるには、このパラメーターを設定する必要があります。
サブタイトル設定	サブタイトル設定	任意	字幕の設定。字幕ファイルを置き換えるには、このパラメーターを設定する必要があります。説明使用するトランスコードテンプレートに対して、字幕パラメーターが事前に設定されていることを確認してください。それ以外の場合は、字幕設定を変更できません。字幕パラメーターの設定方法の詳細については、「基本データ型」トピックの「SubtitleConfig」セクションをご参照ください。字幕ファイルの保存に使用される新しいURLは、`http://out-ddawewsrrrw86223.cn-shanghai.aliyuncs.com/subtitle/subtitle.ass`などのHTTPベースのObject Storage Service (OSS) URLである必要があります。 CDN URLとHTTPSベースのOSS URLはサポートされていません。
PackageSubtitleSetting	PackageSubtitleSetting []	任意	字幕パッケージの設定。アダプティブビットレートストリーミングテンプレートの字幕ファイルの格納に使用されるURLを置き換えるには、このパラメーターを設定する必要があります。
TranscodeTemplateList	TranscodeTemplate []	任意	コード変換テンプレートの設定。トランスコードテンプレートの設定を変更するには、このパラメーターを設定する必要があります。コード変換テンプレートのVideo、Audio、Clip、Rotate、TranscodeFileRegularパラメーターを変更できます。元の品質テンプレートのパラメーターは変更できません。トランスコードテンプレートの設定を変更するには、TranscodeTemplateIdパラメーターを設定する必要があります。

説明

You can modify only the URL of an image watermark or the content of a text watermark.

TranscodeTemplateListパラメーターの例

        [
                {
                  "TranscodeTemplateId":"9580424e49b28c952a46544e3e8f2268" 、
                  "ビデオ":{
                          "幅":720、
                          "高さ":480、
                          "ビットレート":"600"
                  },
                  "オーディオ":{
                          "ビットレート":128
                  }, 
                  "クリップ":{
                          "TimeSpan":{
                                "シーク":"1"
                                "期間":"5"
                        },
                  "回転":"270" 、
                  "TranscodeFileRegular":"{MediaId}/{JobId}/{PlayDefinition}"
                  }
                }
        ]

透かし: 透かしの設定を指定します。

パラメーター	データ型	必須／任意	説明
WatermarkId	String	必須	The watermark ID that is associated with the transcoding template. ApsaraVideo VODコンソールで透かしIDを照会できます。詳細については、「透かしの管理」をご参照ください。
FileUrl	String	任意	The OSS URL of the watermark file. 画像の透かしを置き換えるには、このパラメーターを設定する必要があります。 For more information about how to obtain OSS URLs, see CreateUploadAttachedMedia.
Content	String	任意	テキスト透かしの内容。 To replace a text watermark, you must set this parameter.

注意

The OSS URL of the watermark file must belong to the same origin as the video resource.

SubtitleSetting: 字幕ファイルを指定します。

パラメーター	データ型	必須／任意	説明
SubtitleList	字幕	必須	字幕ファイル。

Subtitle: specifies the subtitle configurations

パラメーター	データ型	必須／任意	説明
SubtitleUrl	String	必須	The OSS URL of the subtitle file. HTTPSベースのOSS URLはサポートされていません。
CharEncode	String	必須	字幕コンテンツのエンコード形式。設定可能な値は以下のとおりです。オート: 自動検出 UTF-8 GBK BIG5

パラメーター

データ型

必須／任意

説明

SubtitleUrl

String

必須

The OSS URL of the subtitle file. HTTPSベースのOSS URLはサポートされていません。

CharEncode

String

必須

字幕コンテンツのエンコード形式。設定可能な値は以下のとおりです。

オート: 自動検出
UTF-8
GBK
BIG5

注: ビジネス要件に基づいて、CharEncodeパラメーターを有効なエンコード形式に設定することを推奨します。パラメーターをautoに設定すると、検出されたエンコード形式が実際のエンコード形式ではない場合があります。

PackageSubtitleSetting: 字幕パッケージを指定します。

パラメーター	データ型	必須／任意	説明
PackageSubtitleList	PackageSubtitle []	必須	字幕パッケージ。複数の字幕ファイルを置き換えるには、このパラメーターを設定する必要があります。

PackageSubtitleSetting: 字幕パッケージの設定を指定します。

パラメーター	データ型	必須／任意	説明
SubtitlePackageTemplateId	String	必須	字幕パッケージテンプレートのID。
Language	String	必須	en-USなどの字幕言語のタグ。詳細については、「RFC 5646」をご参照ください。説明 This parameter is used only to query the URLs of the subtitle files to be replaced and cannot be used to change the subtitle language.
SubtitleUrl	String	必須	字幕ファイルのOSS URL。 OSS URLはHTTP URLである必要があります。 CDN URLとHTTPSベースのOSS URLはサポートされていません。説明指定できるHTTP URLは1つだけです。字幕ファイルは、ApsaraVideo VODによって割り当てられたOSSバケットにのみ保存できます。

説明

SubtitlePackageTemplateIdおよびLanguageパラメーターは、置換する字幕ファイルのURLの照会にのみ使用され、字幕言語の変更には使用できません。

OverrideParamsパラメーターの例

{
  "透かし":[
    {
      "WatermarkId":"watermark1" 、
      "FileUrl":"http://test.bucket.aliyuncs.com/image/replace.png"
    },
    {
      "WatermarkId":"watermark2" 、
      "Content":"Watermark Test"
    }
  ],
  "SubtitleSetting":{
          "SubtitleList":[
                {
                "SubtitleUrl":"http://outin-40564284ef051100163e1403e7.oss-cn-shanghai.aliyuncs.com/subtitles/7b850b-724c-4011-b885-dd16cc112.ass" 、
                "CharEncode":"UTF-8"
                },
                {
                "SubtitleUrl":"http://outin-40564284ef0511e0163e1403e7.oss-cn-shanghai.aliyuncs.com/subtitles/7b86db-724c-4011-b885-dd161d1cyy.srt",
                "CharEncode":"auto"
                }
        ]
  },
  "PackageSubtitleSetting": {
    "PackageSubtitleList": [
      {
        "言语": "en-US" 、
        "SubtitlePackageTemplateId": "32d665807c08d25d4a5d513395ad6cd5" 、 
        "SubtitleUrl": "http://outin-4056428.oss-cn-shanghai.aliyuncs.com/789679188D1F36A00AEB7-3-3.vtt" 
      },
      {
        "言语": "ja" 、  
        "SubtitlePackageTemplateId": "32d665807c08d25d4a5d513395ad6cd5" 、
        "SubtitleUrl": "http://outin-4056428.oss-cn-shanghai.aliyuncs.com/F43FD90FF4B936A00AEB7-3-3.vtt"
      }
    ]
  }
}

WatermarkConfig: 透かしの設定を指定します。

画像透かしのパラメータ

パラメーター	データ型	必須／任意	説明
Dx	String	必須	透かしの水平オフセット。次のタイプの値がサポートされています。 Pixel value: [8,4096] イメージの比率 :( 0,1)
Dy	String	必須	透かしの垂直オフセット。次のタイプの値がサポートされています。ピクセル値: [8,4096] イメージの比率 :( 0,1)
幅	String	必須	透かしの幅。 The following types of values are supported: ピクセル値: [8,4096] Image ratio: (0,1)
Height	String	必須	透かしの高さ。次のタイプの値がサポートされています。ピクセル値: [8,4096] イメージの比率 :( 0,1)
ReferPos	String	必須	透かしの位置。設定可能な値は以下のとおりです。 BottomRight BottomLeft TopRight トップ左
タイムライン	タイムライン	任意	開始時刻と終了時刻を含む、透かし表示のタイムライン。 The value is a JSON string.

注意

このパラメータは、画像透かしに対してのみ有効です。

テキスト透かしのパラメータ

パラメーター	データ型	必須／任意	説明
Content	String	必須	テキスト透かしの内容。例: "テキスト透かし" 。
FontName	String	任意	フォントの名前。The name of the font.
FontColor	String	任意	フォントの色です。
FontAlpha	String	任意	フォントの透明度。有効な値: (0,1) 。デフォルト値 : 1.0
BorderColor	String	任意	フォントアウトラインの色です。
上	Integer	任意	テキストの透かしの上余白。整数値のみがサポートされています。デフォルト値は 0 です。有効な値: [0,4096] 。
左揃え	Integer	任意	テキストの透かしの左マージン。整数値のみがサポートされています。デフォルト値は 0 です。有効な値: [0,4096] 。
FontSize	Integer	任意	フォントのサイズ。整数値のみがサポートされています。デフォルト値: 16。有効な値: (4,120) 。
BorderWidth	Integer	任意	フォントアウトラインの幅。整数値のみがサポートされています。デフォルト値は 0 です。有効な値: [0,4096] 。

タイムライン: 透かしタイムラインの設定を指定します。

パラメーター	データ型	必須／任意	説明
開始	String	必須	透かしが表示される時間範囲の開始。 (単位：秒) 有効な値: 正の数。デフォルト値は 0 です。
有効期間	String	必須	ウォーターマークが表示される時間範囲。 (単位：秒) 有効な値: [Startパラメーターの値、ToEND] 。デフォルト値: ビデオの終わりを示すToEND。

注意

このパラメータは、画像透かしに対してのみ有効です。

SnapshotTemplateConfig: スナップショットテンプレートの設定を指定します。

パラメーター	データ型	必須／任意	説明
SnapshotType	String	必須	スナップショットの種類。有効値: NormalSnapshot: 通常のスナップショット SpriteSnapshot: イメージスプライト WebVttSnapshot: WebVTTベースのスナップショット
SnapshotConfig	SnapshotConfig	必須	スナップショットの設定。スナップショットの種類によって異なります。値はJSON文字列です。

SnapshotConfig: 通常のスナップショットの設定を指定します

パラメーター	データ型	必須／任意	説明
FrameType	String	必須	スナップショットのフレームタイプ。設定可能な値は以下のとおりです。 intra: keyframes normal: ノーマルフレーム
Count	Long	必須	キャプチャするスナップショットの数。
間隔	Long	必須	The snapshot interval. 値は0以上である必要があります。 (単位：秒) このパラメーターを0に設定した場合、スナップショットは、ビデオの長さをCountパラメーターの値で割った値に基づいて偶数間隔でキャプチャされます。
SpecifiedOffsetTime	Long	必須	最初のスナップショットがキャプチャされた時点。単位：ミリ秒。
幅	Integer	任意	各スナップショットの幅。有効な値: [8,4096] 。デフォルトでは、ビデオリソースファイルの幅が使用されます。単位: ピクセル
Height	Integer	任意	各スナップショットの高さ。有効な値: [8,4096] 。デフォルトでは、ビデオリソースファイルの高さが使用されます。単位: ピクセル
SpriteSnapshotConfig	SpriteSnapshotConfig	任意	イメージスプライトのスナップショット設定。イメージスプライトをキャプチャするには、このパラメーターを設定する必要があります。
形式	String	任意	ファイル形式。 Set the value to vtt. This parameter only takes effect when the SnapshotType parameter is set to WebVttSnapshot.
サブアウト	SubOut	任意	スナップショットの表示方法を指定します。このパラメーターは、SnapshotTypeパラメーターがWebVttSnapshotに設定されている場合にのみ有効です。

説明

An image sprite is composed of multiple normal snapshots. したがって、SnapshotConfigパラメーターは、イメージスプライトと通常のスナップショットの両方に必要です。

サブアウト

パラメーター	データ型	必須／任意	説明
IsSptFrag	String	必須	Specifies how snapshots are stored. 設定可能な値は以下のとおりです。 false: 各スナップショットを個別に保存します。 true: 複数のスナップショットを組み合わせてイメージスプライトを生成し、イメージスプライトを保存します。

パラメーター

データ型

必須／任意

説明

IsSptFrag

String

必須

Specifies how snapshots are stored. 設定可能な値は以下のとおりです。

false: 各スナップショットを個別に保存します。
true: 複数のスナップショットを組み合わせてイメージスプライトを生成し、イメージスプライトを保存します。

SpriteSnapshotConfig: イメージスプライトをキャプチャするための設定を指定します

パラメーター	データ型	必須／任意	説明
CellWidth	String	任意	イメージスプライトを構成する元のスナップショットの幅。デフォルト値: 通常のスナップショットの幅。単位: ピクセル
CellHeight	String	任意	イメージスプライトを構成する元のスナップショットの高さ。デフォルト値: 通常のスナップショットの高さ。単位: ピクセル
間隔	String	必須	イメージスプライトを構成する元のスナップショットのパディング。単位: ピクセル
マージン	String	必須	イメージスプライトを構成する元のスナップショットのマージン。単位: ピクセル
色	String	必須	イメージスプライトの背景色。詳細については、「カラー設定パラメーター」をご参照ください。
カラム	String	必須	イメージスプライトを構成する元のスナップショットの列数。 Valid values: [1,10000].
Lines	String	必須	イメージスプライトを構成する元のスナップショットの行数。有効な値: [1,10000] 。
KeepCellPic	String	必須	イメージスプライトを構成する元のスナップショットを保持するかどうかを指定します。設定可能な値は以下のとおりです。キープ delete

注: RGB値を使用して背景色を設定することはできません。

フォント名のパラメータ値

フォント名	説明
シムサン	SimSum
WenQuanYi Zen Hei	WenQuanYi Zen Hei
WenQuanYi Zen Hei Mono	WenQuanYi Zen Hei Mono
WenQuanYi Zen Heiシャープ	WenQuanYi Zen Heiシャープ
ユアンティSC	ユアンティSC