Intelligent Media Services menyediakan callback event untuk unggahan aset media, pemrosesan media, dan pengeditan daring. Anda dapat mengonfigurasi event ini untuk menerima pembaruan tepat waktu mengenai progres dan status pekerjaan. Topik ini menjelaskan contoh isi pesan dan detail parameter untuk setiap jenis event.
Catatan penggunaan
Jika Anda menggunakan callback HTTP(S), isi pesan merupakan konten paket permintaan. Jika Anda menggunakan callback antrian Message Service (MNS), isi pesan merupakan konten pesan yang diterima oleh antrian.
Daftar isi
Tabel 1. Unggahan aset media
Event | Deskripsi |
Unggahan audio atau video selesai | |
Unggahan dari URL selesai | |
Unggahan citra selesai | |
Unggahan aset media tambahan selesai | |
Pendaftaran aliran media selesai | |
Unggahan aliran media selesai | |
Unggahan aliran media dari URL selesai |
Tabel 2. Manajemen aset media
Event | Deskripsi |
Tinjauan manual selesai | |
Pendaftaran aset media selesai | |
Penghapusan aset media selesai | |
Perubahan informasi dasar aset media selesai |
Detail event
FileUploadComplete: Unggahan audio atau video selesai
Contoh isi pesan:
{
"EventType": "FileUploadComplete",
"UserId": 183322097756****,
"EventTime": "2022-07-15T08:48:14Z",
"MessageBody": {
"Status": "Success",
"FileUrl": "http://outin-***.oss-cn-shanghai.aliyuncs.com/sv/93ad7c5-182010aa3dc/93ad7c5-182010a****.mp4",
"MediaId": "c321b3a0041a71eda1590674a2ce****",
"AppId": "app-1000000",
"Size": "5510872",
"MediaType": "video"
}
}Parameter isi pesan:
Parameter | Tipe | Wajib | Deskripsi | |
EventType | String | Ya | Jenis event. | |
UserId | Long | Ya | ID pengguna. | |
EventTime | String | Ya | Waktu saat event terjadi. Waktu dalam UTC dan formatnya adalah | |
MessageBody | - | Object | - | Isi pesan. |
MediaId | String | Ya | ID aset media. | |
MediaType | String | Ya | Jenis aset media. Nilai yang valid:
| |
FileUrl | String | Ya | URL berkas. | |
Size | String | Ya | Ukuran berkas. | |
AppId | String | Ya | ID aplikasi. | |
UserData | String | Tidak | Data yang ditentukan pengguna. | |
Status | String | Ya | Status. Nilai yang valid: Success, Fail. | |
UploadByURLComplete: Unggahan dari URL selesai
Contoh isi pesan:
{
"EventType": "UploadByURLComplete",
"UserId": 183322097756****,
"EventTime": "2022-07-15T08:48:14Z",
"MessageBody": {
"Status": "Success",
"SourceURL": "http://***/big_buck_bunny.mp4",
"MediaId": "c321b3a0041a71eda1590674a2ce****",
"AppId": "app-1000000",
"MediaType": "video",
"JobId": "88aabd2461ec4ad389f439f6ff92****"
}
}Parameter isi pesan:
Parameter | Tipe | Wajib | Deskripsi | |
EventType | String | Ya | Jenis event. | |
UserId | Long | Ya | ID pengguna. | |
EventTime | String | Ya | Waktu saat event terjadi. Waktu dalam UTC dan formatnya adalah | |
MessageBody | - | Object | - | Isi pesan. |
MediaId | String | Ya | ID aset media. | |
MediaType | String | Ya | Jenis aset media. Nilai yang valid:
| |
SourceURL | String | Ya | URL berkas sumber. | |
JobId | String | Ya | ID pekerjaan. | |
AppId | String | Ya | ID aplikasi. | |
UserData | String | Tidak | Data yang ditentukan pengguna. | |
Status | String | Ya | Status. Nilai yang valid: Success, Fail. | |
ImageUploadComplete: Unggahan citra selesai
Contoh isi pesan:
{
"EventType": "ImageUploadComplete",
"UserId": 183322097756****,
"EventTime": "2022-07-06T08:27:52Z",
"MessageBody": {
"Status": "Success",
"FileUrl": "https://outin-***.oss-cn-shanghai.aliyuncs.com/image/default/E81B931FA75246B3972844D35291****-6-2.jpg",
"MediaId": "7e976e80fd0571ec82115523919d****",
"AppId": "app-1000000",
"Size": "132066",
"MediaType": "image"
}
}Parameter isi pesan:
Parameter | Tipe | Wajib | Deskripsi | |
EventType | String | Ya | Jenis event. | |
UserId | Long | Ya | ID pengguna. | |
EventTime | String | Ya | Waktu saat event terjadi. Waktu dalam UTC dan formatnya adalah | |
MessageBody | - | Object | - | Isi pesan. |
MediaId | String | Ya | ID aset media. | |
MediaType | String | Ya | Jenis aset media. Nilai yang valid: image. | |
FileUrl | String | Ya | URL berkas. | |
Size | String | Ya | Ukuran berkas. | |
AppId | String | Ya | ID aplikasi. | |
UserData | String | Tidak | Data yang ditentukan pengguna. | |
Status | String | Ya | Status. Nilai yang valid: Success, Fail. | |
AttachedMediaUploadComplete: Unggahan aset media tambahan selesai
Contoh isi pesan:
{
"EventType": "AttachedMediaUploadComplete",
"UserId": 183322097756****,
"EventTime": "2022-07-15T06:38:33Z",
"MessageBody": {
"Status": "Success",
"FileUrl": "https://outin-***.oss-cn-shanghai.aliyuncs.com/subtitle/4C3C3021EC704639A9F2F55BB0C9****-3-3.ass",
"MediaId": "b3e59350040871ed9d535532918c****",
"AppId": "app-1000000",
"Size": "34758",
"MediaType": "text"
}
}Parameter isi pesan:
Parameter | Tipe | Wajib | Deskripsi | |
EventType | String | Ya | Jenis event. | |
UserId | Long | Ya | ID pengguna. | |
EventTime | String | Ya | Waktu saat event terjadi. Waktu dalam UTC dan formatnya adalah | |
MessageBody | - | Object | Ya | Isi pesan. |
MediaId | String | Ya | ID aset media. | |
MediaType | String | Ya | Jenis aset media. Nilai yang valid: text. | |
FileUrl | String | Ya | URL berkas. | |
Size | String | Ya | Ukuran berkas. | |
AppId | String | Ya | ID aplikasi. | |
UserData | String | Tidak | Data yang ditentukan pengguna. | |
Status | String | Ya | Status. Nilai yang valid: Success, Fail. | |
RegisterStreamComplete: Pendaftaran aliran media selesai
Contoh isi pesan:
{
"EventType": "RegisterStreamComplete",
"UserId": 127753575120****,
"EventTime": "2022-07-13T09:34:39Z",
"MessageBody": {
"Status": "Success",
"FileUrl": "https://***.oss-cn-shenzhen.aliyuncs.com/API-Test/900d1-b****.aac",
"MediaId": "fa04bee0028e71edb10f81848c01****",
"UserData": "{\"MessageCallback\":{\"CallbackURL\":\"***\",\"CallbackType\":\"http\"}}"
}
}Parameter isi pesan:
Parameter | Tipe | Wajib | Deskripsi | |
EventType | String | Ya | Jenis event. | |
UserId | Long | Ya | ID pengguna. | |
EventTime | String | Ya | Waktu saat event terjadi. Waktu dalam UTC dan formatnya adalah | |
MessageBody | - | Object | Ya | Isi pesan. |
MediaId | String | Ya | ID aset media. | |
FileUrl | String | Ya | URL berkas. | |
UserData | String | Tidak | Data yang ditentukan pengguna. | |
Status | String | Ya | Status. Nilai yang valid: Success, Fail. | |
StreamUploadComplete: Unggahan aliran media selesai
Contoh isi pesan:
{
"EventType": "StreamUploadComplete",
"UserId": 174809843091****,
"EventTime": "2022-07-05T12:53:30Z",
"MessageBody": {
"Status": "Success",
"FileUrl": "http://***.aliyuncs.com/vod-f1e0dd/stream/b37ff450fc6071ec9c5e472190a9****/a0c69a523724cc432c897dcaa6f3****-fd.mp4",
"MediaId": "b37ff450fc6071ec9c5e472190a9****",
"UserData": "{\"MessageCallback\":\"{\\\"CallbackURL\\\":\\\"***\\\",\\\"CallbackType\\\":\\\"http\\\"}\"}"
}
}Parameter isi pesan:
Parameter | Tipe | Wajib | Deskripsi | |
EventType | String | Ya | Jenis event. | |
UserId | Long | Ya | ID pengguna. | |
EventTime | String | Ya | Waktu saat event terjadi. Waktu dalam UTC dan formatnya adalah | |
MessageBody | - | Object | Ya | Isi pesan. |
MediaId | String | Ya | ID aset media. | |
FileUrl | String | Ya | URL berkas. | |
UserData | String | Tidak | Data yang ditentukan pengguna. | |
Status | String | Ya | Status. Nilai yang valid: Success, Fail. | |
UploadStreamByURLComplete: Unggahan aliran media dari URL selesai
Contoh isi pesan:
{
"EventType": "UploadStreamByURLComplete",
"UserId": 174809843091****,
"EventTime": "2022-07-07T08:09:14Z",
"MessageBody": {
"Status": "Success",
"SourceURL": "http://***/example/html5/mov_bbb.mp4",
"MediaId": "0f65faa0fdcc71ecbfcd472190a9****",
"UserData": "{\"MessageCallback\":\"{\\\"CallbackURL\\\":\\\"***\\\",\\\"CallbackType\\\":\\\"http\\\"}\"}",
"JobId": "7f0d49297cb0fa50ab7341fd60f4****"
}
}Parameter isi pesan:
Parameter | Tipe | Wajib | Deskripsi | |
EventType | String | Ya | Jenis event. | |
UserId | Long | Ya | ID pengguna. | |
EventTime | String | Ya | Waktu saat event terjadi. Waktu dalam UTC dan formatnya adalah | |
MessageBody | - | Object | Ya | Isi pesan. |
MediaId | String | Ya | ID aset media. | |
SourceURL | String | Ya | URL berkas sumber. | |
JobId | String | Ya | ID pekerjaan. | |
UserData | String | Tidak | Data yang ditentukan pengguna. | |
Status | String | Ya | Status. Nilai yang valid: Success, Fail. | |
CreateAuditComplete: Tinjauan manual selesai
Contoh isi pesan:
{
"EventType": "CreateAuditComplete",
"UserId": 183320223010****,
"EventTime": "2022-06-23T13:11:33Z",
"MessageBody": {
"Status": "Success",
"Auditor": "auditor",
"Comment": "test",
"AuditStatus": "Normal",
"MediaId": "71151b80f2d471ecb21b472190a9****",
"CreationTime": "2022-06-23T13:11:33Z",
"Reason": "test"
}
}Parameter isi pesan:
Parameter | Tipe | Wajib | Deskripsi | |
EventType | String | Ya | Jenis event. | |
UserId | Long | Ya | ID pengguna. | |
EventTime | String | Ya | Waktu saat event terjadi. Waktu dalam UTC dan formatnya adalah | |
MessageBody | - | Object | Ya | Isi pesan. |
MediaId | String | Ya | ID aset media. | |
AuditStatus | String | Ya | Status tinjauan. Nilai yang valid:
| |
Auditor | String | Ya | Peninjau. | |
Reason | String | Ya | Alasan. | |
Comment | String | Ya | Komentar. | |
CreationTime | String | Ya | Waktu pembuatan. | |
Status | String | Ya | Status pekerjaan tinjauan manual. Nilai yang valid:
| |
RegisterMediaComplete: Pendaftaran aset media selesai
Deskripsi:
Callback ini dipicu setelah analisis aset media selesai, yaitu ketika Anda memanggil operasi RegisterMediaInfo untuk mendaftarkan sumber daya di pustaka konten.
Contoh isi pesan:
{
"EventType": "RegisterMediaComplete",
"UserId": 183320223010****,
"EventTime": "2022-06-23T13:11:33Z",
"MessageBody": {
"Status": "Success",
"MediaId": "71151b80f2d471ecb21b472190a9****"
}
}Parameter isi pesan:
Parameter | Tipe | Wajib | Deskripsi | |
EventType | String | Ya | Jenis event. | |
UserId | Long | Ya | ID pengguna. | |
EventTime | String | Ya | Waktu saat event terjadi. Waktu dalam UTC dan formatnya adalah | |
MessageBody | - | Object | Ya | Isi pesan. |
MediaId | String | Ya | ID aset media. | |
Status | String | Ya | Status pekerjaan pendaftaran aset media. Nilai yang valid:
| |
UserData | String | Tidak | Data yang ditentukan pengguna. | |
ErrorCode | String | Tidak | Kode kesalahan. | |
ErrorMessage | String | Tidak | Pesan kesalahan. | |
DeleteMediaComplete: Penghapusan aset media selesai
Deskripsi:
Callback ini dipicu saat Anda memanggil salah satu operasi berikut:
Contoh isi pesan:
{
"EventType": "DeleteMediaComplete",
"UserId": 183320223010****,
"EventTime": "2022-06-23T13:11:33Z",
"MessageBody": {
"Status": "Success",
"MediaId": "71151b80f2d471ecb21b472190a9****",
"DeleteType": "all"
}
}Parameter isi pesan:
Parameter | Tipe | Wajib | Deskripsi | |
EventType | String | Ya | Jenis event. | |
UserId | Long | Ya | ID pengguna. | |
EventTime | String | Ya | Waktu saat event terjadi. Waktu dalam UTC dan formatnya adalah | |
MessageBody | - | Object | Ya | Isi pesan. |
MediaId | String | Ya | ID aset media. | |
Status | String | Ya | Status pekerjaan penghapusan aset media. Nilai yang valid:
| |
DeleteType | String | Ya | Jenis sumber daya yang dihapus. Nilai yang valid:
| |
FileURLs | String | Tidak | Parameter ini dikembalikan hanya ketika DeleteType diatur ke stream. | |
ErrorCode | String | Tidak | Kode kesalahan. | |
ErrorMessage | String | Tidak | Pesan kesalahan. | |
MediaBaseChangeComplete: Perubahan informasi dasar aset media selesai
Deskripsi:
Callback ini dipicu saat Anda memanggil salah satu operasi berikut:
Contoh isi pesan:
{
"EventType": "MediaBaseChangeComplete",
"UserId": 183320223010****,
"EventTime": "2022-06-23T13:11:33Z",
"MessageBody": {
"Status":"Success",
"MediaId":"3b46b391419aj294m83b459f7435****",
"MediaType":"video",
"OperateMode":"update",
"MediaContent":"{\"CoverURL\":\"{\\\"OldValue\\\":\\\"https://outin-8e7b1c7d2a3811eb83da00163e00****.oss-cn-shanghai.aliyuncs.com/0202342e8ae944d09695fd7dbc6d69dc/snapshots/4a6c26eb46a841a3b60c1d56acce****-00005.jpg\\\",\\\"NewValue\\\":\\\"http://cdn.com/ee.png\\\"}\"}"
}
}Parameter isi pesan:
Parameter | Tipe | Wajib | Deskripsi | ||
EventType | String | Ya | Jenis event. | ||
UserId | Long | Ya | ID pengguna. | ||
EventTime | String | Ya | Waktu saat event terjadi. Waktu dalam UTC dan formatnya adalah | ||
MessageBody | - | Object | Ya | Isi pesan. | |
Status | String | Ya | Status pekerjaan untuk mengubah informasi dasar aset media. Nilai yang valid:
| ||
MediaType | String | Ya | Jenis media. Nilai yang valid:
| ||
MediaId | String | Ya | ID media. | ||
OperateMode | String | Ya | Mode operasi. Nilai yang valid:
| ||
MediaContent | - | Object | Ya | Konten yang dimodifikasi dari aset media. Ini adalah string JSON yang mendukung informasi dasar audio dan video. | |
Title | String | Tidak | Judul. Ini adalah string JSON. Contoh: | ||
Description | String | Tidak | Deskripsi. Ini adalah string JSON. Contoh: | ||
CoverURL | String | Tidak | Citra gambar mini. Ini adalah string JSON. Contoh: | ||
CateId | String | Tidak | ID kategori. Ini adalah string JSON. Contoh: | ||
Tags | String | Tidak | Tag. Ini adalah string JSON. Contoh: | ||