全部产品
Search
文档中心

ApsaraVideo VOD:Transkoding Definisi Tunggal Selesai

更新时间:Jan 22, 2026

Tema ini menjelaskan peristiwa StreamTranscodeComplete dan menyediakan contoh callback.

Jenis Peristiwa

StreamTranscodeComplete

Deskripsi Peristiwa

Peristiwa StreamTranscodeComplete dihasilkan ketika aliran video ditranskode ke definisi dan format tertentu, seperti aliran SD dalam format MP4. Aliran video dalam resolusi tunggal dapat diputar segera setelah aliran video ditranskode dalam setidaknya satu format.

Catatan

Jika URL signing diaktifkan, Anda harus menghasilkan auth_key untuk mengakses URL pemutaran. Jika tidak, error HTTP 403 akan dikembalikan. Untuk informasi selengkapnya tentang URL signing, lihat Konfigurasikan URL signing.

Konten event

Nama Parameter

Tipe

Diperlukan

Deskripsi

EventTime

String

Ya

Waktu ketika peristiwa dihasilkan. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddThh:mm:ssZ. Waktu ditampilkan dalam UTC.

EventType

String

Ya

Jenis event. Ini adalah parameter yang diperlukan. Nilainya tetap StreamTranscodeComplete.

VideoId

String

Ya

ID video.

Status

String

Ya

Status transkoding aliran video.

  • success: Pekerjaan berhasil.

  • fail: Operasi gagal.

Bitrate

String

Tidak

Bitrate dari aliran video. Unit: Kbit/s.

Definition

String

Tidak

Kualitas dari aliran video. Nilai yang valid:

  • FD: Low definition

  • LD: Standard definition

  • HD: high definition.

  • HD: Ultra-high definition

  • OD: Original quality

  • 2K: 2K

  • 4K: 4K

  • AUTO: Adaptive bitrate stream

Durasi

Double

Tidak

Durasi dari aliran video. Unit: detik.

Encrypt

Boolean

Tidak

Menunjukkan apakah aliran video dienkripsi.

ErrorCode

String

Tidak

Kode kesalahan. Parameter ini dikembalikan jika terjadi kesalahan saat aliran video sedang ditranskode.

ErrorMessage

String

Tidak

Pesan kesalahan. Parameter ini dikembalikan jika terjadi kesalahan saat aliran video sedang ditranskode.

FileUrl

String

Tidak

URL pemutaran aliran video. URL tersebut tidak termasuk auth_key. Jika Anda telah mengaktifkan penandatanganan URL, Anda harus menghasilkan auth_key untuk memutar video berdasarkan URL.

Format

String

Tidak

Format dari aliran video.

  • mp4

  • m3u8

Fps

String

Tidak

Laju frame dari aliran video. Unit: FPS.

Height

Long

Tidak

Tinggi dari aliran video. Unit: piksel.

Size

Long

Tidak

Ukuran dari aliran video. Unit: byte.

Width

Long

Tidak

Lebar dari aliran video. Unit: piksel.

JobId

String

Tidak

ID pekerjaan transkoding.

WatermarkId

String

Tidak

ID watermark. Beberapa ID dipisahkan oleh koma (,).

IsAudio

Boolean

Ya

Menunjukkan apakah aliran tersebut adalah aliran audio.

StartTime

String

Ya

Waktu mulai tugas. Waktu ditampilkan dalam UTC.

FinishTime

String

Ya

Waktu akhir tugas. Waktu ditampilkan dalam UTC.

Extend

String

Tidak

Parameter yang ditentukan pengguna yang dikembalikan dalam mode pass-through. Untuk informasi lebih lanjut, lihat Parameter Permintaan.

Contoh Callback

Berikut ini adalah contoh callback:

  • Untuk callback HTTP, contoh berikut adalah badan pesan dari permintaan HTTP POST.

  • Untuk callback MNS, contoh berikut adalah badan pesan.

    { 
       "EventTime": "2017-03-20T07:49:17Z",
       "EventType": "StreamTranscodeComplete", 
       "VideoId": "43q9fj74hdf****", 
       "Status": "success",
       "Bitrate": "925",
       "Definition": "LD",
       "Duration": 15.0,
       "Encrypt": false,
       "FileUrl": "http://example.aliyundoc.com/DBEBDEAJS73J79BE4D****/52a53151eba5js73ke2da3b55bc5****.mp4",
       "Format": "mp4",
       "Fps": "30",
       "Height": 960,
       "Size": 1815321,
       "Width": 540,
       "JobId":"ddddddddddd",
       "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", 
       "IsAudio": false, 
       "StartTime": "2017-03-20T07:49:17Z",
       "FinishTime": "2017-03-20T09:49:17Z",
       "Extend":"test data"
    }