すべてのプロダクト
Search
ドキュメントセンター

:MediaConvertJobConfig

最終更新日:Mar 21, 2026

パラメーター

タイプ

説明

object

トランスコードタスクの構成です。

JobName

string

タスク名です。

  • 最大長: 64 バイト。

Name

Inputs

array

入力です。

object

入力ファイル構成です。

Name

string

入力ファイルの名前です。InputRef は出力構成でこれを参照できます。

InputVideo

InputFile

object

入力ファイルです。

Type

string

メディアファイルのタイプです。有効な値:

  • OSS: OSS オブジェクト。

  • Media: メディアアセット。

OSS

Media

string

メディアファイルの URL または ID です。

  • Type が OSS の場合、これはファイル URL (OSS または HTTP) です。認証失敗の原因となる可能性があるため、署名付き URL は使用しないでください。

  • Type が Media の場合、これはメディアアセット ID です。デフォルトではソースストリームが使用されます。

http://bucket.loction.aliyuncs.com/path/to/video.mp4

OutputGroups

array

出力グループ構成の配列です。

object

出力グループ構成です。

Name

string

出力グループの名前です。

hls-group

GroupConfig

object

この出力グループの構成です。

Type

string

出力グループのタイプです。有効な値:

  • File: 個別のファイル。

  • Hls: アダプティブビットレートストリーミング用の HLS ファイル。

Hls

OutputFileBase

object

ベース出力ディレクトリです。この OutputGroup によって生成されたすべてのファイルはこのディレクトリに配置されます。

Type

string

出力ファイルのタイプです。有効な値:

  • OSS: OSS オブジェクト。

  • Media: メディアアセット。

OSS

Media

string

メディアアセットの場所です。

  • Type が OSS の場合、これは送信先 URL (OSS または HTTP) です。

  • Type が Media の場合、これは送信先メディアアセット ID です。

oss://bucket/path/to/dir

ManifestName

string

マニフェストファイルの名前です。このパラメーターは、Type が Hls または Dash に設定されている場合にのみ適用されます。

manifest

ManifestExtend

object

既存のマニフェストファイルへの拡張を構成します。これにより、既存のマニフェストを参照し、現在の出力グループの結果と組み合わせて新しいマニフェストを生成できます。

InputRef

string

拡張するマニフェストを含む入力の Name を参照します。

Input-Manifest

Excludes

array

参照されるマニフェストから除外するストリームを指定します。単一の除外オブジェクト内の複数の条件は AND ロジックを使用して結合されます。配列内の複数の除外オブジェクトは OR ロジックを使用して結合されます。

object

ストリーム除外条件です。

Language

string

ストリームの Language フィールドに基づいてストリームを除外します。RFC 5646 に準拠する必要があります。

en

Name

string

ストリームの Name フィールドに基づいてストリームを除外します。

audio-1

Type

string

ストリームの Type フィールドに基づいてストリームを除外します。

有効な値:

  • Audio

  • Subtitle

Audio

Outputs

array

個別の出力ストリーム構成のリストです。この配列内の各オブジェクトは、特定のレンディションを定義します。

object

個別の出力ストリーム構成です。

Name

string

この出力をラベル付けするための名前です。これは識別目的のみであり、ファイル名には影響しません。

group-output

TemplateId

string

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

****96e8864746a0b6f3****

OutputFileName

string

この出力のファイル名です。GroupConfig の OutputFileBase と組み合わせて使用されます。

720p.mp4

Priority

integer

タスクの優先度 (1 から 10)。値が大きいほど優先度が高くなります。デフォルト値: 6。

6

Features

string

追加の機能パラメーターです。詳細については、「MediaConvertJobFeature」をご参照ください。

{}

OverrideParams

string

指定されたテンプレートの設定をオーバーライドするためのパラメーターの JSON 文字列です。

{}

HlsGroupConfig

object

マニフェストにおけるこのストリームの動作に関する HLS 固有の設定です。グループタイプが Hls の場合にのみ有効です。

Type

string

ストリームタイプを指定します。

有効な値:

  • video: ビデオストリーム。

  • audio: オーディオストリーム。

  • subtitle: 字幕ストリーム。

  • hybrid: オーディオとビデオの両方を含むストリーム。

デフォルト値: hybrid。

hybrid

AudioGroup

string

このビデオストリームが参照するオーディオグループです。Type が video の場合に有効です。

デフォルト値: audio。

audio

SubtitleGroup

string

このビデオまたはハイブリッドストリームが参照する字幕グループです。Type が video または hybrid の場合に有効です。

デフォルト値: subtitle。

subtitle

Name

string

HLS マニフェストにおけるこのストリームの NAME 属性です。Type が audio または subtitle の場合、必須です。

audio

Group

string

HLS マニフェストにおけるこのストリームの GROUP-ID 属性です。Type が audio または subtitle の場合に有効です。

デフォルト値: Type 値と同じ。

audio

Language

string

HLS マニフェストにおけるこのストリームの LANGUAGE 属性です (RFC 5646 に準拠する必要があります)。Type が audio または subtitle の場合に有効です。

zh

IsDefault

string

これがそのグループ内のデフォルトストリームであるかどうか。Type が audio または subtitle の場合に有効です。グループごとに 1 つのストリームのみがデフォルトにできます。

false

Forced

string

このストリームを再生必須とするかどうか。Type が audio または subtitle の場合に有効です。

true

AutoSelect

string

このストリームをプレーヤーによって自動選択するかどうか。Type が audio または subtitle の場合に有効です。

true