すべてのプロダクト
Search

このプロダクト

    ApsaraVideo VOD:SubmitMediaRefreshComplete

    ドキュメントセンター

    ApsaraVideo VOD:SubmitMediaRefreshComplete

    最終更新日:Oct 23, 2024

    このトピックでは、SubmitMediaRefreshCompleteイベント、その通知の内容、およびサンプルのコールバックについて説明します。

    Event

    SubmitMediaRefreshComplete

    イベントの説明

    メディアリフレッシュまたはプリフェッチタスクが送信された後、各再生URLのリフレッシュまたはプリフェッチ要求が送信されます。 これにより、複数のタスクIDが生成されます。 すべての再生URLに対するリフレッシュまたはプリフェッチ要求が送信されると、SubmitMediaRefreshCompleteイベントがトリガーされます。 詳細については、「RefreshMediaPlayUrls」をご参照ください。

    説明

    ApsaraVideo VODコンソールでこのコールバックイベントを設定することはできません。 このコールバックイベントを設定するには、SetMessageCallback操作を呼び出す必要があります。

    イベント通知コンテンツ

    パラメーター

    タイプ

    必須

    説明

    EventTime

    文字列

    はい

    イベントが生成された時刻。 時刻はyyyy-MM-ddTHH:mm:ssZ形式で、UTCで表示されます。

    EventType

    String

    必須

    イベントタイプ。 パラメーターの値はSubmitMediaRefreshCompleteに固定されています。

    Status

    String

    必須

    更新またはプリフェッチ要求の送信ステータス。 有効な値：

    • 成功

    • 失敗

    MediaRefreshJobId

    String

    必須

    更新タスクのID。

    MediaId

    String

    必須

    メディアファイルのID。 オーディオIDまたはビデオIDにすることができます。

    TaskType

    String

    必須

    タスクの ID を設定します。 有効な値：

    • 更新

    • プリロード

    SuccessPlayUrls

    String

    必須

    更新またはプリフェッチのために送信された再生URL。 複数のURLはコンマ (,) で区切ります。

    タスクID

    String

    必須

    メディアファイルの再生URLの更新またはプリフェッチタスクのID。 タスクで更新またはプリフェッチできるURLは1つだけです。 このタスクIDは、DescribeVodRefreshTasks操作で使用して、各再生URLの更新またはプリフェッチのステータスを照会します。

    FilterPolicy

    String

    必須

    ストリームのフィルタリング条件。 JSON形式で表示されるフィルタリング条件。 これらは、RefreshMediaPlayUrls操作のリクエストパラメータです。

    拡張

    String

    任意

    カスタムパラメーター。

    ErrorCode

    String

    任意

    エラーコードを示します。 このパラメーターは、更新またはプリフェッチタスクが失敗した場合に返されます。

    エラーメッセージ

    String

    任意

    エラーメッセージを示します。 このパラメーターは、更新またはプリフェッチタスクが失敗した場合に返されます。

    サンプルコールバック

    説明：

    • HTTPコールバックの場合、次の例はHTTP POSTリクエストのボディです。

    • MNSコールバックの場合、次の例はメッセージ本文です。

    • 成功例 

      {
"SuccessPlayUrls":"https://shenzhen.****.aliyuncdn.com/2defb8b2cb85b87206646055c95****/62948766/sv/4841bb0f-1810a5fc460/4841bb0f-1810a5****.mp4",
"Status":"success",
"MediaId":"affab1a4c6ed4408aead501f32b5****",
"FilterPolicy":"{\"SliceFlag\":false,\"ResultType\":\"Single\"}",
"TaskIds":"1460435****",
"EventType":"SubmitMediaRefreshComplete",
"EventTime":"2022-05-30T08:59:21Z",
"MediaRefreshJobId":"c5ae61bf9af1****",
"TaskType":"refresh"
}

    • 失敗の例 

      {
"Status":"fail",
"MediaId":"e8a73a514fb74fd79ff77c26dbfb****",
"FilterPolicy":"{\"SliceFlag\":false,\"ResultType\":\"Single\"}",
"EventType":"SubmitMediaRefreshComplete",
"EventTime":"2022-05-30T08:56:14Z",
"MediaRefreshJobId":"aa23298375bd****",
"TaskType":"refresh",
"ErrorCode":"InvalidDomain.NotFound",
"ErrorMessage":"Can't find domain."
}