Intelligent Media Services:ハイライトモンタージュ

パラメーター

タイプ

説明

例

必須

MediaArray

List<String>

• テレビ番組や映画のビデオ素材。ビデオのみがサポートされています。メディアアセット ID または OSS URL のリストを入力できます。ビデオの合計時間は 2 時間を超えることはできず、ビデオの最大数は 30 です。

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

  重要

  字幕や人の声がないビデオ素材はサポートされていません。

「パラメーターの例」をご参照ください。

はい

HighlightStrategy

HighlightStrategy

ハイライトモンタージュポリシー。

「パラメーターの例」をご参照ください。

いいえ

OpeningArray

List<Media>

• 固定のオープニングクリップ。プロダクションごとに 1 つのクリップがランダムに選択されます。メディアアセット ID または OSS URL のリストを入力できます。クリップの最大数は 20 です。

• 画像とビデオがサポートされています。サポートされているフォーマットの詳細については、「ビデオフォーマット」および「画像フォーマット」をご参照ください。

「パラメーターの例」をご参照ください。

いいえ

EndingArray

List<Media>

• 固定のエンディングクリップ。プロダクションごとに 1 つのクリップがランダムに選択されます。メディアアセット ID または OSS URL のリストを入力できます。クリップの最大数は 20 です。

• 画像とビデオがサポートされています。サポートされているフォーマットの詳細については、「ビデオフォーマット」および「画像フォーマット」をご参照ください。

「パラメーターの例」をご参照ください。

いいえ

TitleArray

List<String>

タイトル。最大 50 個のタイトルがサポートされています。プロダクションごとに 1 つのタイトルがランダムに選択されます。各タイトルには最大 50 文字まで含めることができます。

["Huilongguan の Hema Fresh がオープンしました","Hema Fresh がオープンしました"]

いいえ

SubHeadingArray

List<SubHeading>

小見出し。最大 5 レベルの小見出しがサポートされています。

「パラメーターの例」をご参照ください。

いいえ

StickerArray

List<Sticker>

• ステッカーの配列。プロダクションごとに 1 つのステッカーがランダムに選択されます。最大 50 個のステッカーがサポートされています。メディアアセット ID または OSS URL を指定できます。

• ランダム化ルール：10 個のステッカーを提供し、出力ビデオの数を 20 に設定したとします。まず、1 から 10 までの乱数が生成されます (例: 3)。次に、3, 4, 5, 6, 7, 8, 9, 10, 1, 2, 3, 4, 5, 6, 7... の順にステッカーが選択されます。

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

「パラメーターの例」をご参照ください。

いいえ

BackgroundMusicArray

List<String>

• バックグラウンドミュージックトラックの配列。プロダクションごとに 1 つのトラックがランダムに選択されます。最大 50 トラックがサポートされています。メディアアセット ID または OSS URL を指定できます。

• ランダム化ルール：10 個のバックグラウンドミュージックトラックを提供し、出力ビデオの数を 20 に設定したとします。まず、1 から 10 までの乱数が生成されます (例: 3)。次に、3, 4, 5, 6, 7, 8, 9, 10, 1, 2, 3, 4, 5, 6, 7... の順にトラックが選択されます。

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

「パラメーターの例」をご参照ください。

いいえ

BackgroundImageArray

List<String>

• 背景画像の配列。プロダクションごとに 1 つの画像がランダムに選択されます。最大 50 枚の画像がサポートされています。メディアアセット ID または OSS URL を指定できます。

• ランダム化ルール：10 枚の背景画像を提供し、出力ビデオの数を 20 に設定したとします。まず、1 から 10 までの乱数が生成されます (例: 3)。次に、3, 4, 5, 6, 7, 8, 9, 10, 1, 2, 3, 4, 5, 6, 7... の順に画像が選択されます。

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

「パラメーターの例」をご参照ください。

いいえ

パラメーター

タイプ

説明

例

必須

MediaConfig

JSON

入力ビデオ素材の設定。

「パラメーターの例」をご参照ください。

いいえ

TitleConfig

JSON

タイトルの設定。字幕パラメーターを設定できます。

「パラメーターの例」をご参照ください。

いいえ

SubHeadingConfig

JSON

複数レベルの小見出しの設定。字幕パラメーターを設定できます。

JSON フィールドの説明:

• key: Level

• value: バナーテキスト

「パラメーターの例」をご参照ください。

いいえ

BackgroundMusicConfig

JSON

バックグラウンドミュージックの設定。

「パラメーターの例」をご参照ください。

いいえ

BackgroundImageConfig

JSON

背景画像の設定。InputConfig で背景画像がすでに設定されている場合、このフィールドは有効になりません。

「パラメーターの例」をご参照ください。

いいえ

ProcessConfig

JSON

モンタージュ処理の設定。

「パラメーターの例」をご参照ください。

FECanvas

JSON

フロントエンドページのプレビュー用のキャンバス設定。

{"Width": 1080,"Height": 1920}

いいえ

ProduceConfig

JSON

標準的なビデオ編集とプロダクションの設定。フィールドの詳細については、「EditingProduceConfig」をご参照ください。

{"AutoRegisterInputVodMedia":true,"OutputWebmTransparentChannel":true,"CoverConfig":{"StartTime":3.3},"AudioChannelCopy":"left","PipelineId":"xxxd54a97cff4108b555b01166d4bxxx","MaxBitrate":5000,"KeepOriginMaxBitrate":false,"KeepOriginVideoMaxFps":false}

いいえ

パラメータ

タイプ

説明

例

必須

MediaURL

String

出力ビデオのアドレス。プレースホルダー {index} を含める必要があります。

ルール: http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4

例: http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4

GeneratePreviewOnly が false で、出力ビデオが OSS に配信される場合に必須です。

StorageLocation

String

VOD に出力するメディアアセットファイルのストレージアドレスを指定します。

ルール: [your-vod-bucket].oss-[your-region-id].aliyuncs.com

例: outin-****6c886b4549d481030f6e****.oss-cn-shanghai.aliyuncs.com

GeneratePreviewOnly が false で、出力ビデオが VOD に配信される場合に必須です。

FileName

String

出力ファイル名。プレースホルダー {index} を含める必要があります。

ルール: [your-file-name]__{index}.mp4

例: example_{index}.mp4

GeneratePreviewOnly が false で、出力ビデオが VOD に配信される場合に必須です。

GeneratePreviewOnly

ブール値

• GeneratePreviewOnly が true に設定されている場合、現在のタスクはプレビュー用のタイムラインのみを生成し、実際にはビデオを生成しません。出力ビデオのアドレスを指定する必要はありません。

• ワンクリックビデオプロダクションタスクが完了した後、「GetBatchMediaProducingJob」を使用してタスクの結果をクエリします。返されるサブタスクリストには、編集プロジェクト ID (projectId) が含まれます。その後、「GetEditingProject」を呼び出してプレビュータイムラインを取得できます。

false

いいえ。デフォルト値: false。

Count

Integer

• 出力ビデオの数。

• ThemeConfig.ThemeType が JumpHighlight の場合、Count は 1 のみです。

• ThemeConfig.ThemeType が SmoothHighlight の場合、生成されるビデオの数は Count 以下です。実際のビデオ数はハイライトクリップの数によって異なります。Count の値の範囲は 1 から 100 です。

1

いいえ。デフォルト値: 1。

Width

Integer

出力ビデオの幅 (px 単位)。

1080

はい

Height

Integer

出力ビデオの高さ (px 単位)。

1920

はい

Video

JSONObject

Crf や Codec などの出力ビデオストリームの設定。

{"Crf": 27}

いいえ