Ringkasan Callback Event SnapshotComplete - ApsaraVideo VOD - Alibaba Cloud - ApsaraVideo VOD

Event SnapshotComplete memberi tahu Anda ketika tangkapan video telah selesai. Topik ini mencakup konten notifikasi dan contoh callback.

Jenis event

SnapshotComplete

Deskripsi event

ApsaraVideo VOD menghasilkan event SnapshotComplete setelah tangkapan diambil untuk sebuah video.

Pengambilan snapshot dan transkoding dilakukan secara bersamaan.
Jika tangkapan tersebut merupakan tangkapan gambar mini dan parameter CoverUrl tidak ditentukan, salah satu tangkapan gambar mini akan digunakan sebagai gambar mini video. Untuk informasi selengkapnya tentang tangkapan gambar mini, lihat Video snapshots.
Panggil operasi GetVideoInfo untuk mendapatkan URL gambar mini video dan snapshot CoverSnapshot.
Panggil operasi ListSnapshots untuk mendapatkan URL snapshot terbaru untuk video tertentu.

Catatan

Jika Penandatanganan URL diaktifkan, Anda harus membuat auth_key sendiri untuk mengakses URL snapshot. Jika tidak, error HTTP 403 akan dikembalikan. Untuk informasi selengkapnya tentang Penandatanganan URL, lihat URL signing.

Konten notifikasi event

Nama parameter	Tipe	Wajib	Deskripsi
EventTime	String	Ya	Waktu saat event dihasilkan, dalam format yyyy-MM-ddTHH:mm:ssZ (UTC).
EventType	String	Ya	Jenis event. Nilainya adalah SnapshotComplete.
VideoId	String	Ya	ID video.
Status	String	Ya	Status tangkapan video. success: Tangkapan berhasil diambil. fail: Tangkapan gagal.
SubType	String	Tidak	Subtipe snapshot. Nilainya adalah SpecifiedTime. Catatan Nilai SpecifiedTime menunjukkan bahwa tangkapan diambil dengan memanggil operasi SubmitSnapshotJob.
ErrorCode	String	Tidak	Kode kesalahan. Hanya dikembalikan jika pekerjaan snapshot gagal.
ErrorMessage	String	Tidak	Pesan kesalahan. Hanya dikembalikan jika pekerjaan snapshot gagal.
CoverUrl	String	Tidak	URL gambar mini. Tidak dikembalikan jika pekerjaan snapshot gagal.
SnapshotInfos	SnapshotInfo[]	Tidak	Detail snapshot. Tidak dikembalikan jika pekerjaan snapshot gagal. Untuk informasi selengkapnya, lihat Data SnapshotInfos di bawah.
Extend	String	Tidak	Parameter pass-through yang ditentukan pengguna dan dikembalikan dalam callback. Untuk informasi selengkapnya, lihat bagian "UserData" dalam Request parameters.

Data snapshot

Nama parameter	Tipe	Wajib	Deskripsi
Status	String	Ya	Status pekerjaan tangkapan video. success: Tangkapan berhasil diambil. gagal: Snapshot gagal.
SnapshotType	String	Ya	Jenis snapshot. CoverSnapshot: tangkapan gambar mini NormalSnapshot: tangkapan normal SpriteSnapshot: tangkapan sprite Untuk informasi selengkapnya, lihat Video snapshots.
SnapshotCount	Long	Ya	Jumlah total snapshot.
SnapshotFormat	String	Ya	Format penamaan snapshot. Gunakan nilai ini bersama URL penyimpanan OSS atau nama domain CDN untuk menyusun URL snapshot. Catatan Jika nama domain Anda sering berubah, gunakan parameter ini untuk menghasilkan URL snapshot secara dinamis.
SnapshotRegular	String	Ya	Aturan untuk menghasilkan URL snapshot. Kami menyarankan agar Anda menggunakan nilai SnapshotRegular untuk menghasilkan URL snapshot. Untuk detailnya, lihat bagian berikut. Catatan Jika nama domain tersedia, aturan untuk URL CDN akan dikembalikan. Jika tidak, aturan untuk URL OSS yang dikembalikan. Aturan untuk URL HTTPS tidak didukung.
JobId	String	Ya	ID pekerjaan snapshot.

Catatan

Untuk video yang baru diunggah, snapshot disimpan di alamat penyimpanan OSS yang sama dengan video sumber. Untuk informasi selengkapnya, lihat Manage storage buckets.

Pembuatan URL snapshot

Anda dapat menghasilkan URL snapshot dengan dua cara:

Buat URL snapshot berdasarkan nilai SnapshotFormat
- Aturan: http(s)://{nama domain CDN atau URL penyimpanan OSS}/SnapshotFormat.
- {SnapshotCount} adalah nomor seri setiap snapshot, diisi dengan nol di depan hingga lima digit.
- Contoh:
  - Jika nomor seri snapshot pertama adalah 00001, URL snapshot-nya adalah:
    
    http://example.com/2327a6ec24b44844b3a5e2c1b691****/covers/990f3820db2948b5b4a13d65d9a4****-00001.jpg.
  - Jika nomor seri snapshot kedua adalah 00002, URL snapshot-nya adalah:
    
    http://example.com/2327a6ec24b44844b3a5e2c1b691****/covers/990f3820db2948b5b4a13d65d9a4****-00002.jpg.
    
    Dan seterusnya.
Buat URL snapshot berdasarkan nilai SnapshotRegular
- SnapshotRegular adalah aturan URL lengkap.
- Ganti {SnapshotCount} dengan nomor seri snapshot, sama seperti pada SnapshotFormat.

Contoh callback

Deskripsi:

Untuk callback HTTP, contoh ini menunjukkan badan permintaan HTTP POST.
Untuk callback MNS, contoh ini menunjukkan badan pesan.

{
  "EventType": "SnapshotComplete",
  "EventTime": "2018-07-31T10:07:31Z",
  "CoverUrl": "http://sample/covers/990f3820db2948b5b4a13d65d9a4****-00002.jpg",
  "Extend":"test data",
  "SnapshotInfos": [
    {
      "Status": "success",
      "SnapshotType": "CoverSnapshot",
      "SnapshotCount": 2,
      "SnapshotFormat": "2327a6ec24b44844b3a5e2c1b691****/covers/990f3820db2948b5b4a13d65d9a4****-{SnapshotCount}.jpg",
      "SnapshotRegular": "http://sample/covers/990f3820db2948b5b4a13d65d9a4****-{SnapshotCount}.jpg",
      "JobId": "ee16d4bbf3f7*****e094bcb8cf8ddde"
    },
    {
      "Status": "success",
      "SnapshotType": "SpriteSnapshot",
      "SnapshotCount": 1,
      "SnapshotFormat": "2327a6ec24b44844b3a5e2c1b691****/covers/sprite/990f3820db2948b5b4a13d65d9a4****-{SnapshotCount}.jpg",
      "SnapshotRegular": "http://sample/covers/sprite/990f3820db2948b5b4a13d65d9a4****-{SnapshotCount}.jpg",
      "JobId": "b3187205eed*****b72adf4eb3840713"
    }
  ]
}