Configure callback settings for completed editing jobs - Intelligent Media Services

Intelligent Media Services ( IMS ) のオンライン編集機能を使用する場合、コールバックイベントを設定して、ジョブの進捗状況とステータスをできるだけ早く取得できます。このようにして、イベントに基づいて他のビジネス操作を実行できます。このトピックでは、完了した編集ジョブのコールバック設定を構成する方法について説明します。

コールバック方法

HTTPリクエストとSMQキューを使用して、イベント通知を受信できます。詳細については、「コールバック方法」をご参照ください。

実装

個々のジョブに対してカスタムコールバック URL を設定するか、グローバルコールバック URL を設定できます。

単一ジョブのカスタムコールバック URL : 編集および制作ジョブを送信するときに指定されるコールバック URL です。SubmitMediaProducingJob オペレーションを呼び出して、HTTPまたは HTTPS コールバック URL 、または Simple Message Queue ( SMQ ) コールバック URL を指定する必要があります。
- HTTPまたは HTTPS コールバックを使用する場合は、コールバックメッセージを受信する HTTP サービスをデプロイし、編集および制作ジョブを送信するときにコールバック URL を設定する必要があります。ジョブが完了すると、IMS サーバーは URL に HTTP POST リクエストを送信します。ジョブの進捗状況は、HTTPリクエストボディを介してユーザーに送信されます。
- MNS コールバックを選択した場合は、ジョブが完了したリージョンで ice-callback で始まるメッセージキューを設定する必要があります。 IMS サーバーは、メッセージキューにメッセージを送信します。
グローバルコールバック URL : すべてのメディア処理ジョブのコールバック通知に適用されます。 IMS のグローバル設定で、メッセージキューエンドポイントをグローバルコールバック URL として指定できます。ジョブが完了すると、IMS は設定されたグローバルコールバック URL に通知を送信します。
説明
SMQ のメッセージキューのみがサポートされています。

メッセージ構造

編集および制作ジョブが完了したときのメッセージ構造の詳細については、「イベントリスト」をご参照ください。

前提条件

SMQ キューメソッドが使用されている場合、IMS は SMQ にアクセスする権限があります。詳細については、「SMQ をアクティブ化し、RAM ユーザーに SMQ へのアクセスを承認する」をご参照ください。

単一ジョブのカスタムコールバック URL を設定する

ジョブが完了したときに通知を受信するように、単一ジョブのカスタムコールバック URL を設定できます。SubmitMediaProducingJob オペレーションを呼び出してジョブを送信するときに、UserData パラメーターで HTTP、HTTPS、または SMQ コールバック URL を指定できます。サンプルコード：

HTTPまたは HTTPS コールバック URL
```
{"NotifyAddress":"http(s)://**.**.***"}
```
SMQ コールバック URL ( ice-callback で始まるメッセージキューのエンドポイントである必要があります )
```
{"NotifyAddress":"ice-callback-****"}
```

グローバルコールバック URL を設定する

SMQ コンソールでメッセージキューを作成します。メッセージキューは ice-callback で始まる必要があります。詳細については、「キューベースのメッセージングを開始する」をご参照ください。
SetEventCallback オペレーションを呼び出してイベントコールバックを設定し、手順 1 で作成したメッセージキューの名前を CallbackQueueName パラメーターに指定します。

手順 1 のメッセージキューをリッスンし、メッセージを処理します。次のサンプルコードは例を示しています。

説明

次のサンプルコードで紹介されているサーバー SDK のバージョン番号は参考用です。最新バージョンの入手方法の詳細については、サーバー SDK を参照してください。

<dependencies>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.9</version>
</dependency>
<dependency>
    <groupId>com.aliyun.mns</groupId>
    <artifactId>aliyun-sdk-mns</artifactId>
    <version>1.1.9</version>
</dependency>
</dependencies>

// SMQ 設定を ~/.aliyun-mns.properties ファイルから読み取ります。
// mns.accesskeyid、mns.accesskeysecret、mns.queue.endpoint
// AccessKey ペアが属する RAM ユーザーには、SMQ に対する完全な読み取りおよび書き込み権限があります。


// メッセージ受信コードのデモ
// ProduceMediaComplete タイプのメッセージのみを処理します。
// メッセージの正常な消費を忘れないでください。