ApsaraVideo Media Processing:ワークフローのアクティビティ

アクティビティ名

トポロジーのアクティビティタイプ

説明

入力

Start

MPS キューやメッセージなどのグローバル設定、およびメディアワークフローの OSS 入力パスを設定できます。

公開

Report

公開モードを手動または自動に設定できます。

分析

Analysis

入力メディアファイルをインテリジェントに分析し、ファイルに適したプリセットテンプレートを推奨します。

トランスコード

Transcode

入力メディアファイルをさまざまな形式にトランスコードします。これにより、ファイルをさまざまなプラットフォームで再生できるようになります。

スナップショット

Screenshot

動画の特定時点のスナップショットをキャプチャします。スナップショットを動画のサムネイルとして使用したり、複数のスナップショットを使用してスプライトを生成したりできます。

パッケージング設定

PackageConfig

複数の解像度、音声トラック、字幕を持つ動画ファイルをパッケージングして、M3U8 ファイルを生成します。

動画グループ

VideoGroup

オーディオグループ

AudioGroup

字幕グループ

SubtitleGroup

動画の抽出

オーディオの抽出

字幕の抽出

Transcode

マスタープレイリストの生成

GenerateMasterPlayList

コンテンツモデレーション

Censor

動画の音声、テキスト、シーンに含まれるポルノコンテンツ、テロ関連コンテンツ、不適切なコンテンツを検出します。これにより、手動レビューのコストを削減し、コンプライアンスに違反するコンテンツがもたらすリスクを低減します。

動画 DNA

FpShot

動画を一意に識別します。これにより、動画内の画像や音声のフィンガープリントを抽出・比較できます。この方法により、重複動画の検出、動画クリップのソース追跡、盗作の特定が可能です。

インテリジェントサムネイル

Cover

動画コンテンツ、画像の美しさ、大量のユーザー行動データへの深い理解に基づくアルゴリズムにより、動画から最適なキーフレームやクリップをサムネイルとして選択することで、動画のクリックコンバージョン率とユーザーエクスペリエンスを向上させます。

名前

タイプ

必須

説明

InputFile

String

はい

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

• ワークフローのトリガールールについては、「ファイルのワークフロー トリガールール」をご参照ください。

• ファイルは OSS にのみ保存できます。InputFile パラメーターの詳細については、「パラメーター詳細」をご参照ください。

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

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

PipelineId

String

はい

グローバル設定のパイプライン ID。

• この MPS キュー ID は、分析、トランスコード、スナップショット、およびパッケージングアクティビティにのみ使用されます。AI ジョブの場合は、アクティビティごとに MPS キュー ID を個別に設定する必要があります。

• メディアワークフローでは、特定の MPS キューのメッセージ設定は無効になります。代わりに、メディアワークフローの QueueName または TopicName パラメーターの設定を使用します。

MessageType

String

いいえ

グローバル設定：メッセージカテゴリ

• Queue：Simple Message Queue (旧称：MNS) キュー。このパラメーターを Queue に設定した場合は、QueueName パラメーターを指定する必要があります。

• Topic：MNS トピック。このパラメーターを Topic に設定した場合は、TopicName パラメーターを指定する必要があります。

• デフォルト値：Queue

QueueName

String

いいえ

グローバル設定では、ApsaraVideo Media Processing パイプラインに関連付ける MNS キューを指定します。関連付けると、パイプラインから完了したジョブの結果がこのキューに送信されます。メッセージの詳細については、「メッセージ通知の受信」をご参照ください。

• 有効な値：作成済みの MNS キュー。利用可能な キュー がない場合は、Simple Message Queue (旧称：MNS) コンソールに移動して作成します。

TopicName

String

いいえ

MPS キューに関連付ける MNS トピック。これはグローバル設定です。MPS キューでジョブが完了すると、ジョブの結果が MNS トピックにプッシュされます。関連付けられた MNS トピックは、結果に関するメッセージを、このトピックをサブスクライブしている URL にプッシュします。詳細については、「通知の受信」をご参照ください。

• 有効な値：作成済みの MNS トピック。利用可能な トピック がない場合は、Simple Message Queue (旧称：MNS) コンソールに移動して作成します。

RoleName

String

いいえ

Resource Access Management (RAM) ロールの名前。これはグローバル設定です。

• デフォルト値：AliyunMTSDefaultRole

名前

タイプ

必須

説明

PublishType

String

いいえ

メディア公開タイプのグローバル設定。

• Manual：手動でメディアファイルを公開します。ワークフローの実行後、メディアファイルは非公開状態になります。メディアファイルは手動で公開できます。詳細については、「メディアファイルの管理」をご参照ください。

• Auto：すべてのアクティビティが完了した後、メディアファイルを自動的に公開します。ワークフローの実行後、メディアファイルは自動的に公開されます。

• TranscodeCompletedAuto：Transcode アクティビティが完了した後、メディアファイルを自動的に公開します。入力アクティビティのメッセージ設定は、トランスコードが完了したことを通知するために使用されます。Transcode アクティビティがスキップされた場合、メッセージは送信されません。

• デフォルト値：Manual

  説明

  • ApsaraVideo Media Processing がワークフローを実行してファイルを処理する際、Security Token Service (STS) の一時ユーザーを使用して、公開タイプに応じて出力ファイルを変更します。

  • 公開状態は出力ファイルのアクセス権限に影響します。

    • 非公開：動画、音声、スクリーンショットファイルのアクセス権限はプライベートになります。

    • 公開済み：動画、音声、スクリーンショットファイルは、格納先のバケットからアクセス権限を継承します。

名前

タイプ

必須

説明

KeepOnlyHighestDefinition

String

いいえ

最高解像度の分析結果のみを保持するかどうかを指定します。

• True：最高解像度の出力動画のみを保持します。

• False：すべての解像度で出力動画を生成します。

• デフォルト値：False

名前

タイプ

必須

説明

Outputs

String

いいえ

トランスコードジョブの出力。

• Output オブジェクトの JSON 配列で値を指定します。最大 30 個の Output オブジェクトを指定できます。

• 各 Output オブジェクトのパラメーターの詳細については、「パラメーター詳細」をご参照ください。

• 例：[{"OutputObject":"transcode%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D","TemplateId": "S00000001-000070"}]

OutputBucket

String

いいえ

出力バケットの名前。

• HTTP Live Streaming (HLS) および Dynamic Adaptive Streaming over HTTP (DASH) のパッケージング中は、Pack アクティビティの Bucket パラメーターが OutputBucket パラメーターよりも優先されます。

OutputLocation

String

いいえ

出力リージョンを指定します。

• HLS および DASH パッケージング中は、Pack アクティビティの Location パラメーターが OutputLocation パラメーターよりも優先されます。

MultiBitrateVideoStream

String

いいえ

このパラメーターは、HLS パッケージング中にビデオストリームを抽出する場合に必要です。

• 詳細については、「パラメーター詳細」をご参照ください。

• 例：{"URI": "c/d/video1.m3u8"}

ExtXMedia

String

いいえ

このパラメーターは、HLS パッケージング中に音声または字幕ストリームを抽出する場合に必要です。

• 詳細については、「パラメーター詳細」をご参照ください。

• 例：{"Name": "english","Language": "en-US","URI":"c/d/audio-1.m3u8"}

WebVTTSubtitleURL

String

いいえ

字幕の URL。このパラメーターは、HLS パッケージング中に字幕ストリームを抽出する場合に必要です。

• Web Video Text Tracks (WebVTT) 字幕ファイルのみがサポートされています。字幕 URL は URL 標準に準拠する必要があり、AddMedia API を呼び出す際に上書きできます。

• 例：http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/subtitles****-en.vtt

Representation

String

いいえ

このパラメーターは、DASH パッケージング中にビデオ、オーディオ、または字幕ストリームを抽出する場合に必要です。

• 詳細については、「パラメーター詳細」をご参照ください。

• 例：{\"Id\":\"480p\", \"URI\":\"videoSD/xx.mpd\"}

InputConfig

String

いいえ

字幕の設定。このパラメーターは、DASH パッケージング中に字幕ストリームを抽出する場合に必要です。値は、字幕のフォーマットと場所を指定する JSON オブジェクトです。

• 詳細については、「パラメーター詳細」をご参照ください。

• 例："{\"Format\":\"vtt\",\"InputFile\":{\"URL\":\"http://example-Bucket-****.oss-cn-hangzhou.aliyuncs.com/subtitle/subtitle****-en.vtt\"}}"

名前

タイプ

必須

説明

SnapshotConfig

String

はい

スナップショット設定。

• 詳細については、「パラメーター詳細」をご参照ください。

• 例：{"OutputFile": {"Bucket": "example-001", "Location": "oss-cn-hangzhou", "Object":"snapshot%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D%2F1.jpg"},"Time": "5"}

MediaCover

String

いいえ

スナップショットをメディアサムネイルとして設定するかどうかを指定します。このパラメーターは、単一のスナップショットにのみ有効です。有効な値：

• true：設定する

• false：設定しない

• デフォルト値：false

名前

タイプ

必須

説明

Output

String

はい

出力ファイルの詳細情報。JSON 文字列です。例：{"Bucket":"output","Location":"oss-cn-hangzhou","MasterPlayListName":"a/b/c.m3u8"}

Protocol

String

はい

パッケージングに使用するプロトコル。有効な値は hls と dash です。

名前

タイプ

必須

説明

AdaptationSet

String

いいえ

動画グループに関する情報。このパラメーターは DASH パッケージングの場合に必要です。

• 詳細については、「パラメーター詳細」をご参照ください。

• 例："AdaptationSet":"{\"Group\":\"VideoGroup\"}"

名前

タイプ

必須

説明

GroupId

String

いいえ

オーディオグループの ID。このパラメーターは HLS パッケージングの場合に必要です。

• 最大長は 32 バイトです。

AdaptationSet

String

いいえ

オーディオグループに関する情報。このパラメーターは DASH パッケージングの場合に必要です。

• 詳細については、「パラメーター詳細」をご参照ください。

• 例："{\"Lang\":\"english\", \"Group\":\"AudioGroupEnglish\"}"

名前

タイプ

必須

説明

GroupId

String

いいえ

字幕グループの ID。このパラメーターは HLS パッケージングの場合に必要です。

• 最大長は 32 バイトです。

AdaptationSet

String

いいえ

字幕グループに関する情報。このパラメーターは DASH パッケージングの場合に必要です。

• 詳細については、「パラメーター詳細」をご参照ください。

• 例："{\"Lang\":\"english\", \"Group\":\"SubtitleENGroup\"}"

名前

タイプ

必須

説明

MasterPlayList

String

いいえ

• マルチビットレートのビデオストリーム。このパラメーターは、HLS パッケージングの場合に必須です。詳細については、「パラメーター詳細」をご参照ください。

• 例：{"MultiBitrateVideoStreams": [{"RefActivityName": "video-1","ExtXStreamInf": {"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}}]}