All Products
Search

This Product

    ApsaraVideo Media Processing:Menerima notifikasi

    Document Center

    ApsaraVideo Media Processing:Menerima notifikasi

    Last Updated:Aug 25, 2026

    Setelah dikirim, notifikasi dapat diterima di antrian atau topik Simple Message Queue (SMQ) yang telah ditentukan. Topik ini menjelaskan cara menerima notifikasi tersebut.

    Persiapan

    Fitur notifikasi telah diaktifkan. Untuk informasi selengkapnya, lihat Menyiapkan notifikasi.

    Menerima notifikasi di antrian MNS

    Menerima notifikasi di topik MNS

    • Gunakan MNS SDK untuk Java guna menerima notifikasi. Untuk informasi selengkapnya, lihat Mengelola topik.

      Catatan

      Contoh ini menggunakan MNS SDK untuk Java. Untuk informasi selengkapnya mengenai penggunaan MNS SDK dalam bahasa pemrograman lain untuk menerima notifikasi, lihat Mengunduh dan menggunakan SDK.

    • Gunakan konsol MNS untuk menerima notifikasi. Untuk informasi selengkapnya, lihat Memulai pengiriman pesan berbasis topik.

    Format pesan untuk suatu Pekerjaan

    Parameter

    Deskripsi

    jobId(JobId)

    ID pekerjaan.

    requestId(RequestId)

    ID permintaan.

    type(Type)

    Jenis pekerjaan. Nilai yang valid:

    • Transcode: pekerjaan transkoding

    • Analysis: pekerjaan analisis templat cerdas

    • Snapshot: pekerjaan snapshot

    • MediaInfo: pekerjaan analisis informasi media

    state(State)

    Status pekerjaan. Nilai yang valid:

    • Success: Pekerjaan berhasil.

    • Fail: Pekerjaan gagal.

    code

    Kode kesalahan yang dikembalikan jika pekerjaan gagal.

    msg

    Pesan kesalahan yang dikembalikan jika pekerjaan gagal.

    UrlPattern

    URL snapshot, yang berisi placeholder. Nilai parameter ini digunakan sebagai templat URL.

    Catatan

    Parameter ini dikembalikan jika parameter type(Type) diatur ke Snapshot dan snapshot diambil pada titik waktu tertentu.

    LastUrl

    URL snapshot terakhir.

    Catatan

    Parameter ini dikembalikan jika parameter type(Type) diatur ke Snapshot dan snapshot diambil pada titik waktu tertentu.

    Count

    Jumlah total snapshot.

    Catatan

    Parameter ini dikembalikan jika parameter type(Type) diatur ke Snapshot dan snapshot diambil pada titik waktu tertentu.

    TimeArray

    Titik waktu saat snapshot diambil.

    Catatan

    Parameter ini dikembalikan jika parameter type(Type) diatur ke Snapshot dan snapshot diambil pada titik waktu tertentu.

    Contoh callback sukses

    {
  "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
}

    Contoh callback gagal

    {
  "msg": "TimeArray greater than video duration.",
  "Msg": "TimeArray greater than video duration.",
  "code": "InvalidParameter.TimeArray",
  "userData": "{}",
  "UserData": "{}",
  "type": "Snapshot",
  "Code": "InvalidParameter.TimeArray",
  "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****"
}

    Format pesan untuk suatu alur kerja

    Notifikasi mengenai alur kerja media dikirim dalam format JSON. Untuk informasi selengkapnya tentang parameter dalam pesan tersebut, lihat deskripsi pesan alur kerja media di topik Menambahkan file media.

    Struktur pesan:

    • Start

      activity type dalam basic attributes of the activity adalah Start.

    • Struktur

      Kode berikut menunjukkan strukturnya.

    • Report

      activity type dalam basic attributes of the activity adalah Report.

    • Kode contoh

      { 
      // Parameter pada tingkat atas, yang berformat JSON. Parameter ini mendefinisikan atribut dasar aktivitas dan informasi mengenai alur kerja.
      // Atribut dasar aktivitas bukan objek independen, melainkan pasangan kunci-nilai yang langsung termasuk dalam tingkat atas. Atribut dasar mencakup ID instans alur kerja, nama aktivitas, jenis aktivitas, status aktivitas, dan pesan kesalahan jika alur kerja gagal.
      "RunId": "8f8aba5a62ab4127ae2add18da20****",
      "Name": "Act-4",
      "Type": "Report",
      "State": "Success",
      // Informasi mengenai alur kerja, yang berformat JSON. Informasi ini mencakup ID instans alur kerja, ID alur kerja media, nama alur kerja media, ID media, file input, jenis instans alur kerja, array objek aktivitas, dan waktu pembuatan instans alur kerja.
      "MediaWorkflowExecution": {
        "Name": "ConcurrentSuccess",
        "RunId": "8f8aba5a62ab4127ae2add18da20****",
        "Input": {
            "InputFile": {
                "Bucket": "exampleBucket****",
                "Location": "oss-test", 
               "Object": "mediaWorkflow/ConcurrentSuccess/01.wmv",
           }
        },
        "State": "Success",
        "MediaId": "2be491ab4cb6499cd0befe5fcf0c****",
        // Array objek aktivitas, yang berformat JSON. Array ini mencakup semua objek aktivitas yang terkait dengan status eksekusi alur kerja saat ini.
        Misalnya, hanya objek aktivitas Start yang disertakan dalam pesan yang memberi tahu bahwa eksekusi alur kerja dimulai, sedangkan semua objek aktivitas disertakan dalam pesan yang memberi tahu bahwa eksekusi alur kerja selesai. 
        // Contoh: Objek aktivitas 1, Objek aktivitas 2,...
        "ActivityList": 
[
            // Informasi mengenai objek aktivitas, yang berformat JSON. Informasi ini mencakup nama aktivitas, jenis aktivitas, ID pekerjaan, status aktivitas, waktu mulai, waktu selesai, dan pesan kesalahan jika aktivitas gagal.    
            {
                "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",
      }
  }