ワークフローアクティビティの種類 - ApsaraVideo Media Processing

このトピックでは、メディアワークフローのトポロジにおけるアクティビティとサポートされているパラメーターについて説明します。 AddMediaWorkflowまたはUpdateMediaWorkflow操作を呼び出してメディアワークフローのトポロジを設定する場合、このトピックを参照できます。

アクティビティ

アクティビティ名	トポロジ内のアクティビティタイプ	説明
入力	開始	必須。オブジェクトストレージサービス（OSS）入力パスと、ApsaraVideo Media Processing（MPS）キューとメッセージ通知を含むグローバル設定を構成します。
公開	レポート	必須。公開モードを設定します。自動と手動の 2 つの公開モードがサポートされています。
分析	分析	入力メディアファイルをインテリジェントに分析し、ファイルに適切なプリセットテンプレートを推奨します。
エンコード	トランスコード	入力メディアファイルをさまざまな形式にトランスコードします。これにより、ファイルがさまざまなプラットフォームで再生できるようになります。
スナップショット	スクリーンショット	特定の時点でのビデオのスナップショットをキャプチャします。スナップショットをビデオのサムネイルとして使用したり、複数のスナップショットを使用してスプライトを生成したりできます。
パック	PackageConfig	マルチ解像度、マルチオーディオトラック、マルチ字幕ビデオファイルをパッケージ化して、M3U8ファイルを生成します。
ビデオグループ	VideoGroup
オーディオグループ	AudioGroup
字幕グループ	SubtitleGroup
ビデオの抽出オーディオの抽出字幕の抽出	トランスコード
生成	GenerateMasterPlayList
コンテンツモデレーション	検閲	ビデオの音声、テキスト、シーンにおけるポルノコンテンツ、テロリストコンテンツ、および望ましくないコンテンツを検出します。これにより、手動レビューのコストが削減され、非準拠コンテンツによってもたらされるリスクが軽減されます。
ビデオDNA	FpShot	ビデオを一意に識別します。これにより、ビデオ内の画像と音声のフィンガープリントを抽出して比較できます。この方法で、重複ビデオの検索、ビデオクリップのソースの追跡、盗作の識別を行うことができます。
インテリジェントサムネイル	カバー	ビデオの最適なキーフレームまたはクリップをビデオサムネイルとして選択し、ビデオのクリックコンバージョン率とユーザーエクスペリエンスを向上させます。これは、ビデオコンテンツ、画像の美しさ、および大量のユーザー行動データの完全な理解に基づくアルゴリズムを使用して実装されます。

入力

このアクティビティは必須です。メディアワークフローのOSS入力パスと、MPSキューとメッセージ通知を含むグローバル設定を構成できます。

このアクティビティはメディア情報を取得します。メディア情報の取得に失敗した場合、公開アクティビティが実行されるまで後続のアクティビティはスキップされます。

パラメーター	タイプ	必須	説明
InputFile	String	はい	入力ファイル。 Bucket、Location、Objectパラメーターを使用して、ファイルの場所を指定できます。ワークフロートリガー規則の詳細については、「ファイルのワークフロートリガー規則」をご参照ください。ファイルはOSSにのみ保存できます。 InputFileパラメーターの詳細については、「パラメーターの詳細」をご参照ください。 OSSオブジェクトのパスは、MPSで使用する前にUTF-8でURLエンコードする必要があります。詳細については、「URLエンコード」をご参照ください。例: {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","ObjectPrefix":"example.mp4"}。
PipelineId	String	はい	MPSキューのID。これはグローバル設定です。このMPSキューIDは、分析、エンコード、スナップショット、およびパックアクティビティにのみ使用されます。 AIジョブの場合、アクティビティのMPSキューIDを個別に設定する必要があります。メディアワークフローでは、特定のMPSキューのメッセージ設定は無効です。代わりに、メディアワークフローのQueueNameまたはTopicNameパラメーターの設定を使用してください。
MessageType	String	いいえ	メッセージのタイプ。これはグローバル設定です。有効な値： Queue: Simple Message Queue（旧MNS）キュー。このパラメーターをQueueに設定する場合は、QueueNameパラメーターを指定する必要があります。 Topic: SMQトピック。このパラメーターをTopicに設定する場合は、TopicNameパラメーターを指定する必要があります。デフォルト値: Queue。
QueueName	String	いいえ	MPSキューに関連付けるSMQキュー。これはグローバル設定です。 MPSキューでジョブが完了すると、ジョブの結果がSMQキューにプッシュされます。メッセージ通知の詳細については、「通知の受信」をご参照ください。作成済みのSMQ キューのいずれかを指定できます。 SMQ キューがない場合は、SMQコンソールで作成します。
TopicName	String	いいえ	MPSキューに関連付けるSMQトピック。これはグローバル設定です。 MPSキューでジョブが完了すると、ジョブの結果がSMQトピックにプッシュされます。関連付けられたSMQトピックは、結果に関するメッセージをSMQトピックにサブスクライブしているURLにプッシュします。詳細については、「通知の受信」をご参照ください。作成済みのSMQ トピックのいずれかを指定できます。 SMQ トピックがない場合は、SMQコンソールで作成します。
RoleName	String	いいえ	Resource Access Management（RAM）ロールの名前。これはグローバル設定です。デフォルト値: AliyunMTSDefaultRole。

公開

このアクティビティは必須です。ワークフローの実行後にメディア公開モードを設定できます。

パラメーター

タイプ

必須

説明

PublishType

String

いいえ

メディアファイルの公開モード。これはグローバル設定です。有効な値：

Manual: メディアファイルを手動で公開します。ワークフローの実行後、メディアファイルは非公開になります。メディアファイルは手動で公開できます。詳細については、「メディアファイルの管理」をご参照ください。
Auto: すべてのアクティビティが完了した後、メディアファイルを自動的に公開します。ワークフローの実行後、メディアファイルは自動的に公開されます。
TranscodeCompletedAuto: トランスコードアクティビティの完了後にメディアファイルを自動的に公開します。入力アクティビティのメッセージ設定を使用して、トランスコードが完了したことが通知されます。トランスコードアクティビティがスキップされた場合、メッセージは送信されません。
デフォルト値: Manual。
説明
- MPSはワークフロー内のメディアファイルを処理し、Security Token Service（STS）を使用してRAMユーザーに権限を付与します。これにより、メディアファイルの公開方法を設定できます。
- 公開状態は、出力ファイルへのアクセス許可に影響します。
  - 出力ビデオ、オーディオ、およびスナップショットファイルが公開されていない場合、ファイルへのアクセス許可はプライベートです。
  - 出力ビデオ、オーディオ、およびスナップショットファイルが公開されている場合、ファイルへのアクセス許可は、ファイルが配置されているOSSバケットのアクセス許可に基づいて決定されます。

分析

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

パラメーター

タイプ

必須

説明

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）パッケージ化中は、パックアクティビティのBucketパラメーターがOutputBucketパラメーターよりも優先されます。
OutputLocation	String	いいえ	出力バケットのリージョン。 HLSおよびDASHパッケージ化中は、パックアクティビティの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操作の呼び出し時に上書きできます。例: http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/subtitles**-en.vtt.
Representation	String	いいえ	このパラメーターは、DASHパッケージ化中にビデオ、オーディオ、または字幕ストリームを抽出するために必要です。詳細については、「パラメーターの詳細」をご参照ください。例: {\"Id\":\"480p\", \"URI\":\"videoSD/xx.mpd\"}。
InputConfig	String	いいえ	字幕URL。このパラメーターは、DASHパッケージ化中に字幕ストリームを抽出するために必要です。詳細については、「パラメーターの詳細」をご参照ください。例: "{\"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"}。説明 MasterPlayListNameパラメーターの指定に使用できるプレースホルダー: {ObjectPrefix}: バケット情報を含まない元のファイルパス。 {FileName}: ファイル名拡張子を含む元のファイル名。ファイル名拡張子は、トランスコーディングテンプレートの形式によって異なります。 {ExtName}: 元のファイルのファイル名拡張子。 {RunId}: ワークフローインスタンスのID。 {MediaId}: ワークフローで処理されるメディアファイルのID。
Protocol	String	はい	パッケージ化に使用できるプロトコル。有効な値: hlsおよびdash。

ビデオグループ

パラメーター

タイプ

必須

説明

AdaptationSet

String

いいえ

ビデオグループに関する情報。このパラメーターは、DASHパッケージ化に必要です。

詳細については、「パラメーターの詳細」をご参照ください。
例: "AdaptationSet":"{\"Group\":\"VideoGroup\"}".

オーディオグループ

パラメーター

タイプ

必須

説明

GroupId

String

いいえ

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

IDの長さは最大 32 バイトです。

AdaptationSet

String

いいえ

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

詳細については、「パラメーターの詳細」をご参照ください。
例: "{\"Lang\":\"english\", \"Group\":\"AudioGroupEnglish\"}".

字幕グループ

パラメーター

タイプ

必須

説明

GroupId

String

いいえ

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

IDの長さは最大 32 バイトです。

AdaptationSet

String

いいえ

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

詳細については、「パラメーターの詳細」をご参照ください。
例: "{\"Lang\":\"english\", \"Group\":\"SubtitleENGroup\"}".

生成

パラメーター	タイプ	必須	説明
MasterPlayList	String	いいえ	マルチビットレートビデオストリーム。このパラメーターは排他的であり、HLSパッケージ化に必要です。詳細については、「パラメーターの詳細」をご参照ください。例: {"MultiBitrateVideoStreams": [{"RefActivityName": "video-1","ExtXStreamInf": {"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}}]}。