すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Media Processing:通知の受信

    ドキュメントセンター

    ApsaraVideo Media Processing:通知の受信

    最終更新日:Aug 25, 2026

    通知が送信されると、指定された Simple Message Queue (SMQ) のキューまたはトピックで通知を受信できます。本トピックでは、通知を受信する方法について説明します。

    事前準備

    通知機能が有効化されていること。詳細については、「通知の設定」をご参照ください。

    MNSキューでの通知の受信

    • MNS SDK for Java を使用して通知を受信します。詳細については、「キューの管理」をご参照ください。

      説明

      この例では MNS SDK for Java を使用しています。他の言語の MNS SDK を使用して通知を受信する方法については、「SDKのダウンロードと使用」をご参照ください。

    • MNS コンソールを使用して通知を受信します。詳細については、「キューベースのメッセージングの開始」をご参照ください。

    MNSトピックでの通知の受信

    ジョブのメッセージフォーマット

    パラメーター

    説明

    jobId (JobId)

    ジョブ ID。

    requestId (RequestId)

    リクエスト ID。

    type (Type)

    ジョブのタイプ。有効な値：

    • Transcode：トランスコードジョブ

    • Analysis：インテリジェントテンプレート分析ジョブ

    • Snapshot：スナップショットジョブ

    • MediaInfo：メディア情報分析ジョブ

    state (State)

    ジョブのステータス。有効な値：

    • Success：ジョブは成功しました。

    • Fail：ジョブは失敗しました。

    code

    ジョブが失敗した場合に返されるエラーコード。

    msg

    ジョブが失敗した場合に返されるエラーメッセージ。

    UrlPattern

    プレースホルダーを含むスナップショット URL。このパラメーターの値は URL テンプレートとして使用されます。

    説明

    このパラメーターは、type (Type) パラメーターが Snapshot に設定され、特定の時点でスナップショットが取得される場合に返されます。

    LastUrl

    最後のスナップショットの URL。

    説明

    このパラメーターは、type (Type) パラメーターが Snapshot に設定され、特定の時点でスナップショットが取得される場合に返されます。

    Count

    スナップショットの総数。

    説明

    このパラメーターは、type (Type) パラメーターが Snapshot に設定され、特定の時点でスナップショットが取得される場合に返されます。

    TimeArray

    スナップショットが取得される時点の配列。

    説明

    このパラメーターは、type (Type) パラメーターが Snapshot に設定され、特定の時点でスナップショットが取得される場合に返されます。

    成功コールバックのサンプル

    {
  "jobId": "8f91f1b630f3469eb5ecf445028f****",
  "JobId": "8f91f1b630f3469eb5ecf445028f****",
  "Type": "Snapshot",
  "userData": "{}",
  "UserData": "{}",
  "State": "Success",
  "state": "Success",
  "type": "Snapshot",

  "LastUrl": "http://example.oss-cn-shanghai.aliyuncs.com/example_output/2021-11-14/V4/Async-V2-00005.jpg",
  "TimeArray": [10050, 50000, 110000, 1000500, 1100500],
  "UrlPattern": "http://eaxmple.oss-cn-shanghai.aliyuncs.com/example_output/2021-11-14/V4/Async-V2-{Count}.jpg",
  "Count": 5
}

    失敗コールバックのサンプル

    {
  "msg": "TimeArray greater than video duration.",
  "code": "InvalidParameter.TimeArray",
  "userData": "{}",
  "UserData": "{}",
  "type": "Snapshot",
  "jobId": "f8abc5d9dee0425fa26bb9946df1****",
  "Type": "Snapshot",
  "State": "Fail",
  "UrlPattern": "http://example.oss-cn-shanghai.aliyuncs.com/example_output/2023-11-15/regression_test/TimePoint/V1/Async-V1-{Count}.jpg",
  "TimeArray": [10050, 50000, 110000, 1000500, 1100500, 1800000],
  "state": "Fail",
  "JobId": "f8abc5d9dee0425fa26bb9946df1****"
}

    ワークフローのメッセージフォーマット

    メディアワークフローの通知として送信されるメッセージは JSON フォーマットです。メッセージ内のパラメーターの詳細については、「メディアファイルの追加」トピックにある、メディアワークフローメッセージの説明をご参照ください。

    メッセージ構造：

    • Start

      アクティビティの基本属性のアクティビティタイプは Start です。

    • 構造

      以下のコードは構造を示しています。

    • レポート

      アクティビティの基本属性におけるアクティビティタイプはレポートです。

    • サンプルコード

      { 
      // トップレベルのパラメーター (JSON フォーマット)。アクティビティの基本属性とワークフローに関する情報を定義します。
      // アクティビティの基本属性は独立したオブジェクトではなく、トップレベルに直接属するキーと値のペアです。基本属性には、ワークフローインスタンスの ID、アクティビティ名、アクティビティタイプ、アクティビティステータス、ワークフローが失敗した場合のエラーメッセージが含まれます。
      "RunId": "8f8aba5a62ab4127ae2add18da20****",
      "Name": "Act-4",
      "Type": "Report",
      "State": "Success",
      // ワークフローに関する情報 (JSON フォーマット)。ワークフローインスタンスの ID、メディアワークフローの ID、メディアワークフローの名前、メディア ID、入力ファイル、ワークフローインスタンスのタイプ、アクティビティオブジェクトの配列、ワークフローインスタンスが作成された時刻が含まれます。
      "MediaWorkflowExecution": {
        "Name": "ConcurrentSuccess",
        "RunId": "8f8aba5a62ab4127ae2add18da20****",
        "Input": {
            "InputFile": {
                "Bucket": "exampleBucket****",
                "Location": "oss-test",
               "Object": "mediaWorkflow/ConcurrentSuccess/01.wmv"
           }
        },
        "State": "Success",
        "MediaId": "2be491ab4cb6499cd0befe5fcf0c****",
        // アクティビティオブジェクトの配列 (JSON フォーマット)。現在のワークフロー実行ステータスに関連するすべてのアクティビティオブジェクトが含まれます。
        // たとえば、ワークフローの実行開始を通知するメッセージには Start アクティビティオブジェクトのみが含まれ、ワークフローの実行終了を通知するメッセージにはすべてのアクティビティオブジェクトが含まれます。
        // 例: アクティビティオブジェクト 1、アクティビティオブジェクト 2、...
        "ActivityList": 
[
            // アクティビティオブジェクトに関する情報 (JSON フォーマット)。アクティビティ名、アクティビティタイプ、ジョブ ID、アクティビティステータス、開始時刻、終了時刻、アクティビティ失敗時のエラーメッセージが含まれます。    
            {
                "RunId": "8f8aba5a62ab4127ae2add18da20****",
                "Name": "Act-1",
                "Type": "Start",
                "State": "Success",
                "StartTime": "2016-03-15T02:53:41Z",
                "EndTime": "2016-03-15T02:53:41Z"
            },
            {                
                "RunId": "8f8aba5a62ab4127ae2add18da20****",
                "Name": "Act-2",
                "Type": "Transcode",
                "JobId": "f34b6d1429dd491faa7a6c1c8f90****",
                "State": "Success",
                "StartTime": "2016-03-15T02:53:43Z",
                "EndTime": "2016-03-15T02:53:47Z"
            },
            {                
                "RunId": "8f8aba5a62ab4127ae2add18da20****",
                "Name": "Act-3",
                "Type": "Snapshot",
                "JobId": "c14150be33304825a5d67cd5364c****",
                "State": "Success",
                "StartTime": "2016-03-15T02:53:44Z",                
                "EndTime": "2016-03-15T02:53:45Z"
            },
            {                
                "RunId": "8f8aba5a62ab4127ae2add18da20****",
                "Name": "Act-4",
                "Type": "Report",
                "State": "Success",
                "StartTime": "2016-03-15T02:53:49Z",
                "EndTime": "2016-03-15T02:53:49Z"
           }
        ],
        "CreationTime": "2016-03-15T02:53:39Z"
      }
  }