VODのビデオに対して開始されるアップロード、削除、ビデオ処理などの操作は、すべてイベントと呼ぶことができます。イベントの実行は、完了するまでに時間がかかります。VODはイベントが終了すると、直ちにAppサービスに実行結果、つまりイベント通知を送信します。
VODは、次のタイプのイベント通知をサポートします。
カテゴリー | イベント通知 |
---|---|
アップロード削除 | ビデオアップロードの完了 |
URLからのビデオプルアップロードの完了 | |
ビデオ削除の完了 | |
ビデオ処理 | タスクフロー状態の変更 |
ビデオ編集の完了 | |
ビデオ合成の完了 |
イベント通知方法には、「通常のコールバック」と「信頼できるコールバック」があります。 VODコンソール にログインしてコールバックモードを設定し、コールバックを受信するイベントを設定します。具体的な操作については、 コールバック設定 をご参照ください。
通常のコールバックは、Appサービスがイベント通知を受動的に受信するモードです。コールバックURLを設定し、通常のコールバックモードを選択すると、VODはイベントの完了後にコールバックURLへのコールバックを開始します。
VODが開始する通常のコールバックの形式はHTTPリクエストであり、リクエストボディはJSON形式です。コンテンツに EventHandle パラメータのEventContentの構造 は含まれません。
タスクステータス変更通知を例に取った場合、コールバックのEventType
パラメータはProcedureStateChanged
であり、情報はProcedureStateChangeEvent
パラメータ(ProcedureTask 構造)によって表されます。
信頼できるコールバックは、Appサービスがイベント通知をVODに対してアクティブにプルするモードです。信頼できるコールバックモードを選択した場合、VODシステムはイベント通知をキューに入れ、AppサービスはサーバーAPIを介してキュー内のイベント通知を順番に消費します。
Appサービスはプルイベント通知 APIを介してメッセージを取得した場合、イベント通知の確認 APIを呼び出して確認する必要があります。メッセージは必ず確認された上でVODのキューから削除されるので、「信頼できるコールバック」は「通常のコールバック」よりもの信頼性が高くなります。イベント通知の信頼性の高い要件では、「信頼できるコールバック」モードを使用することをお勧めします。
この記事はお役に立ちましたか?