Definisi struktur data dan parameter API - ApsaraVideo VOD

Topik ini menjelaskan tipe data dasar API ApsaraVideo VOD.

Informasi Dasar Aset Media

Video: informasi audio dan video

Name	Type	Description
VideoId	String	ID audio atau video.
Title	String	Judul audio atau video.
Description	String	Deskripsi audio atau video.
Duration	Float	Durasi audio atau video. Satuan: detik.
CoverURL	String	URL thumbnail audio atau video.
Status	String	Status audio atau video. Untuk informasi selengkapnya, lihat Status: status file audio atau video.
CreationTime	String	Waktu pembuatan audio atau video. Waktu harus dalam UTC.
Size	Long	Ukuran file sumber. Satuan: byte.
Snapshots	String[]	URL tangkapan video.
CateId	Long	ID kategori audio atau video.
CateName	String	Nama kategori audio atau video.
Tags	String	Tag audio atau video. Pisahkan beberapa tag dengan koma (,).
TemplateGroupId	String	ID kelompok template transkoding yang digunakan untuk mentranskode file audio atau video.
StorageLocation	String	Alamat penyimpanan file audio atau video.
AppId	String	ID aplikasi.

Status: Status audio dan video

Value	Description	Remarks
Uploading	Mengunggah	Ini adalah status awal file audio atau video. Ini menunjukkan bahwa file audio atau video sedang diunggah. Jika file audio atau video Anda berada dalam status ini untuk waktu yang lama, lihat kemungkinan penyebab dan solusi yang dijelaskan dalam FAQ tentang unggah aset media. Hanya operasi penghapusan yang diizinkan untuk file audio atau video dalam status ini. Anda tidak dapat melakukan operasi lain, seperti transkoding, klip video, atau tinjauan aset media, pada file audio atau video yang sedang diunggah.
UploadFail	Unggah gagal	Pengunggahan dapat gagal karena masalah jaringan atau kerusakan file sumber. Coba unggah ulang atau gunakan file sumber yang berbeda. Saat menggunakan unggah yang dapat dilanjutkan, status ini tidak muncul karena tidak mungkin menentukan apakah pengunggahan gagal. Hanya operasi penghapusan yang diizinkan untuk file audio atau video dalam status ini. Anda tidak dapat melakukan operasi lain, seperti transkoding, klip video, atau tinjauan aset media, pada file audio atau video yang gagal diunggah.
UploadSucc	Unggah selesai	Jika proses transkoding default dilewati selama pengunggahan karena desain bisnis atau alasan lain, sehingga mencegah pembuatan aliran pemutaran yang valid, atau jika kelompok template non-transkoding digunakan dan file sumber tidak dalam format MP4, FLV, M3U8, MP3, atau WEBM, video ditandai sebagai Unggah selesai. Setelah transkoding berikutnya menghasilkan aliran pemutaran yang valid, video berubah menjadi status Normal. Anda dapat melakukan operasi seperti transkoding, klip video, dan tinjauan aset media pada file audio atau video dalam status ini.
Transcoding	Transkoding	File media dalam status ini sedang ditranskode. Jika video sedang menjalani transkoding awal, tidak ada aliran pemutaran yang valid tersedia, dan Anda tidak dapat memanggil operasi API untuk mendapatkan URL pemutaran. Anda dapat menentukan status transkoding menggunakan notifikasi event Transkoding Definisi Tunggal Selesai atau Transkoding selesai.
TranscodeFail	Transkoding gagal	Kegagalan transkoding biasanya disebabkan oleh kesalahan pada file sumber. Anda dapat memperoleh pesan kesalahan dari notifikasi event Transkoding Definisi Tunggal Selesai atau Transkoding selesai. Untuk informasi selengkapnya tentang cara memecahkan masalah kegagalan transkoding, lihat FAQ tentang transkoding.
Checking	Meninjau	Jika Anda mengaktifkan Review Before Publish di Konsol ApsaraVideo VOD > Review Management > Review Settings, file audio atau video akan secara otomatis memasuki alur tinjauan setelah transkoding berhasil. Status file tersebut kemudian ditandai sebagai Reviewing. Anda harus melakukan tinjauan manual; jika tidak, file audio atau video akan tetap berada dalam status Reviewing. Anda hanya dapat memutar file audio dan video dalam status ini menggunakan Konsol ApsaraVideo VOD atau alamat IP keamanan tinjauan. Anda tidak dapat memanggil operasi API atau menggunakan SDK untuk mendapatkan URL pemutaran file audio atau video dalam status ini untuk diputar. Namun, Anda masih dapat memutar file-file ini menggunakan URL pemutaran yang valid dan telah diakses publik. Anda dapat melakukan operasi seperti transkoding dan klip video pada file audio atau video dalam status ini. Catatan Perhatikan bahwa status Meninjau di sini menggambarkan status file audio atau video (terlihat di kolom Status di bawah Konsol ApsaraVideo VOD > Aset Media > Audio/Video). Ini berbeda dari status Meninjau untuk moderasi berbantuan mesin (terlihat di Konsol ApsaraVideo VOD > Manajemen Tinjauan > Tinjauan Video). Status Meninjau moderasi berbantuan mesin hanya menggambarkan status pekerjaan tinjauan mesin, sedangkan status Meninjau file audio atau video menggambarkan status pekerjaan tinjauan berbantuan mesin dan manual.
Blocked	Diblokir	Audio atau video dalam status ini hanya dapat diputar di Konsol ApsaraVideo VOD atau dari alamat IP daftar putih untuk tinjauan. Anda tidak dapat menggunakan API atau SDK untuk mendapatkan URL pemutaran audio atau video tersebut. Namun, URL pemutaran yang valid dan telah diekspos sebelumnya masih dapat diputar secara normal. Hanya operasi penghapusan yang diizinkan untuk file audio atau video dalam status ini. Anda tidak dapat melakukan operasi lain, seperti transkoding, klip video, atau tinjauan aset media, pada file audio atau video yang diblokir.
Normal	Normal	Jika setidaknya satu aliran pemutaran yang valid tersedia untuk file audio atau video, statusnya adalah Normal. Anda dapat melakukan semua operasi, seperti transkoding, klip video, tinjauan aset media, dan pemutaran, pada file audio atau video dalam status ini.
ProduceFail	Sintesis gagal	Ini menunjukkan bahwa produksi klip video gagal. Saat menggunakan pengeditan daring ApsaraVideo VOD untuk produksi klip video, pastikan semua aset media yang digunakan berada dalam status Normal. Jika tidak, produksi video dapat gagal.

ImageInfo: Informasi gambar

Name	Type	Description
ImageId	String	ID gambar.
URL	String	URL gambar. Jika nama domain yang dipercepat dikonfigurasi, URL CDN dikembalikan. Jika tidak, URL Object Storage Service (OSS) dikembalikan.
Title	String	Judul gambar.
Tags	String	Tag gambar.
ImageType	String	Jenis gambar.
CateId	Long	ID kategori.
CateName	String	Nama kategori.
Description	String	Deskripsi.
StorageLocation	String	Alamat penyimpanan.
Mezzanine	Mezzanine	Informasi sumber gambar.
CreationTime	String	Waktu pembuatan gambar. Waktu dalam UTC.
Status	String	Status gambar. Untuk informasi selengkapnya, lihat Status: status gambar.
AppId	String	ID aplikasi.

Status: status gambar

Value	Description	Remarks
Uploading	Mengunggah	Ini adalah status awal gambar, menunjukkan sedang diunggah. Jika gambar Anda tetap dalam status ini untuk waktu yang lama, lihat Mengapa File yang Diunggah Saya Selalu dalam Status Mengunggah?.
UploadFail	Gambar gagal diunggah.	Pengunggahan dapat gagal karena masalah jaringan atau kerusakan file sumber. Coba ulang atau unggah file sumber yang berbeda.
Normal	Normal	Pengunggahan gambar berhasil.

AttachedMediaInfo: informasi tentang aset media pendukung

Name	Type	Description
MediaId	String	ID aset media pendukung.
URL	String	URL aset media pendukung. Jika nama domain untuk CDN ditentukan, URL CDN dikembalikan. Jika tidak, URL OSS dikembalikan.
Title	String	Judul.
Tags	String	Tag.
Type	String	Jenis aset media pendukung.
Categories	Category[]	Kategori.
Description	String	Deskripsi
StorageLocation	String	Alamat penyimpanan.
CreationTime	String	Waktu pembuatan aset media pendukung. Waktu harus dalam UTC.
ModificationTime	String	Waktu terakhir aset media pendukung dimodifikasi. Waktu harus dalam UTC.
Status	String	Status aset media pendukung. Untuk informasi selengkapnya, lihat Status: Status Aset Media Pendukung.
AppId	String	ID aplikasi.

Status: status aset media pendukung

Value	Description	Explanation
Uploading	Mengunggah	Status awal. Aset media pendukung sedang diunggah.
Normal	Normal	Aset media pendukung berhasil diunggah.
UploadFail	Gagal	Aset media pendukung gagal diunggah.

Informasi Berkas Sumber Daya Media

Mezzanine: Informasi berkas sumber audio dan video

Name	Type	Description
VideoId	String	ID video.
FileName	String	Nama file.
Duration	String	Durasi file dalam detik.
Status	String	Status file sumber. Untuk informasi selengkapnya, lihat Status: Status file sumber audio atau video.
CreationTime	String	Waktu pembuatan file. Waktu dalam UTC.
Height	Long	Tinggi file dalam piksel (px).
Width	Long	Lebar file dalam piksel (px).
Fps	String	Laju frame file dalam frame per detik (fps).
FileURL	String	URL file.
Bitrate	String	Bitrate file dalam Kbps.
Size	Long	Ukuran file dalam byte.
OutputType	String	Jenis file output. Nilai yang valid: oss: URL server asal. cdn: URL yang dipercepat.
VideoStreamList	VideoStream[]	Daftar informasi aliran video.
AudioStreamList	AudioStream[]	Daftar informasi aliran audio.

VideoStream: Informasi aliran video

Name	Type	Description
Index	String	Nomor urut aliran video. Ini mengidentifikasi posisi aliran video dalam aliran media.
CodecName	String	Nama singkat format encoding.
CodecLongName	String	Nama panjang format encoding.
Profile	String	Profil codec.
CodecTimeBase	String	Basis waktu codec.
CodecTagString	String	Teks tag format encoding.
CodecTag	String	Tag format encoding.
Width	Long	Lebar resolusi video.
Height	Long	Resolusi video tinggi.
HasBFrames	String	Menunjukkan apakah aliran memiliki B-frame.
Sar	String	Rasio resolusi sinyal terkode.
Dar	String	Rasio aspek tampilan (DAR).
PixFmt	String	Format piksel.
Level	String	Tingkat encoding.
Fps	String	Laju frame target.
AvgFPS	String	Laju frame rata-rata.
Timebase	String	Basis waktu.
StartTime	String	Waktu mulai.
Duration	String	Durasi.
NumFrames	String	Jumlah total frame.
Lang	String	Bahasa.
Rotate	String	Sudut rotasi video. Nilai harus dalam rentang [0, 360).

AudioStream: Informasi aliran audio

Name	Type	Description
Index	String	Nomor urut aliran audio. Ini mengidentifikasi posisi aliran audio dalam aliran media.
CodecName	String	Nama singkat format encoding.
CodecLongName	String	Nama panjang format encoding.
CodecTimeBase	String	Basis waktu codec.
CodecTagString	String	Teks tag format encoding.
CodecTag	String	Tag format encoding.
SampleFmt	String	Format pengambilan sampel.
SampleRate	String	Laju sampel.
Channels	String	Jumlah saluran suara.
ChannelLayout	String	Tata letak saluran suara.
Timebase	String	Basis waktu.
StartTime	String	Waktu mulai.
Duration	String	Durasi.
Bitrate	String	Bitrate.
NumFrames	String	Jumlah total frame.
Lang	String	Bahasa.

Status: Status file sumber audio atau video

Value	Description	Remarks
Uploading	Mengunggah	Status awal file. Ini menunjukkan bahwa file sedang diunggah.
Normal	Normal	File berhasil diunggah.
UploadFail	Gagal	File gagal diunggah.
Deleted	Dihapus	File dihapus.

Mezzanine: Informasi berkas sumber gambar

Name	Type	Description
FileURL	String	URL OSS gambar.
OriginalFileName	String	Nama file yang diunggah.
FileSize	Long	Ukuran file dalam byte.
Width	Integer	Lebar gambar dalam piksel (px).
Height	Integer	Tinggi gambar dalam piksel (px).

Unggah beberapa berkas media dalam batch berdasarkan URL

URLUploadInfo: informasi tentang pekerjaan unggah berbasis URL

Name	Type	Description
JobId	String	ID pekerjaan unggah.
UploadURL	String	URL file yang akan diunggah.
MediaId	String	ID file yang akan diunggah.
FileSize	String	Ukuran file yang akan diunggah. Satuan: byte.
Status	String	Status pekerjaan unggah berbasis URL. Untuk informasi selengkapnya tentang parameter ini, lihat Status: status pekerjaan unggah berbasis URL.
CreationTime	String	Waktu pembuatan pekerjaan.
CompleteTime	Long	Waktu penyelesaian pekerjaan.
UserData	String	Bidang yang ditentukan pengguna.
ErrorCode	String	Kode kesalahan
ErrorMessage	String	Pesan kesalahan.

Status: status pekerjaan unggah berbasis URL

Value	Description
PENDING	Pekerjaan unggah dikirimkan dan sedang menunggu untuk diproses.
PROCESSING	Anda dapat mulai memproses tugas.
DOWNLOADING	File sedang diunduh.
DOWNLOAD_SUCCESS	File diunduh.
DOWNLOAD_FAIL	File gagal diunduh.
UPLOADING	File sedang diunggah.
UPLOAD_SUCCESS	File diunggah.
UPLOAD_FAIL	File gagal diunggah.
SUCCESS	Pekerjaan unggah berhasil, dan callback selesai.

Pemutaran video dan audio

VideoBase: Informasi video dasar

Name	Type	Description
VideoId	String	ID Video
Title	String	Judul video
Duration	String	Durasi video dalam detik.
CoverURL	String	Gambar mini video.
Status	String	Status file video atau audio.
CreationTime	String	Waktu pembuatan file video atau audio. Waktu dalam UTC.
MediaType	MediaType	Jenis berkas media. Nilai yang valid: Video. audio: file hanya audio.

Catatan

Secara default, operasi API pemutaran mengembalikan URL yang dipercepat CDN. Jika nama domain belum dikonfigurasi, operasi API mengembalikan URL asal OSS. Dalam kasus ini, hanya URL file MP4 yang dapat digunakan untuk pemutaran.

PlayInfo: Informasi pemutaran untuk aliran media

Name	Type	Description
Bitrate	String	Bitrate aliran media, dalam Kbps.
Definition	String	Definisi aliran media. Nilai yang valid: FD: definisi rendah LD: definisi standar SD: definisi tinggi High Definition (HD). OD: kualitas asli 2K: 2K 4K: 4K
Specification	String	Spesifikasi output untuk transkoding video dan audio. Untuk informasi selengkapnya, lihat Spesifikasi output.
Duration	String	Durasi aliran media, dalam detik.
Encrypt	Long	Menunjukkan apakah aliran media dienkripsi. Nilai yang valid: 0: Tidak. 1: Ya.
EncryptType	String	Jenis enkripsi aliran media. Nilai yang valid: AliyunVoDEncryption: Enkripsi Video Alibaba Cloud (enkripsi pribadi). HLSEncryption: Enkripsi HLS.
PlayURL	String	URL pemutaran aliran media.
Format	String	Format aliran media. Jika berkas media adalah video, nilai yang valid adalah: mp4 m3u8 Jika berkas media hanya audio, nilai yang valid adalah mp3.
Fps	String	Laju frame aliran media, dalam frame per detik (fps).
Size	Long	Ukuran aliran media, dalam byte.
Width	Long	Lebar aliran media, dalam piksel (px).
Height	Long	Tinggi aliran media, dalam piksel (px).
StreamType	String	Jenis aliran media. Jika aliran media adalah video, nilainya adalah video. Jika aliran media hanya audio, nilainya adalah audio.
JobId	String	ID pekerjaan transkoding untuk aliran media. ID ini adalah pengenal unik aliran media.
WatermarkId	String	ID watermark yang terkait dengan aliran media.
Status	String	Status aliran media. Nilai yang valid: Normal: Status aliran transkoding terbaru yang selesai untuk setiap definisi dan format. Invisible: Status untuk aliran redundan. Ketika beberapa aliran ditranskode untuk definisi dan format yang sama, aliran terbaru ditandai sebagai Normal, dan yang lainnya ditandai sebagai Invisible.
NarrowBandType	String	Jenis Narrowband HD. Nilai yang valid: 0: reguler 1.0: Narrowband HD 1.0 2.0: Narrowband HD 2.0 Parameter ini hanya berlaku ketika definisi dari template transkoding Narrowband HD 1.0 bawaan dikonfigurasi. Untuk informasi selengkapnya, lihat TranscodeTemplate: Konfigurasi template transkoding.
CreationTime	String	Waktu pembuatan aliran. Waktu dalam UTC.
ModificationTime	String	Waktu terakhir aliran diperbarui. Waktu dalam UTC.

VideoMeta: Metadata video

Name	Type	Description
VideoId	String	ID video.
Title	String	Judul video.
Duration	Float	Durasi video, dalam detik.
CoverURL	String	Gambar mini video.
Status	String	Status video.

Kueri aset media

Media: informasi tentang aset media

Name	Type	Description
MediaId	String	ID aset media.
CreationTime	String	Waktu pembuatan aset media. Waktu harus dalam UTC.
MediaType	String	Jenis aset media. Nilai yang valid: video: video audio: audio Image: Gambar. attached: aset media pendukung
Video	Video	Informasi tentang video.
Audio	Audio	Informasi tentang audio.
Image	Image	Informasi tentang gambar.
AttachedMedia	AttachedMedia	Informasi tentang aset media pendukung.

Kategori aset media

Category: klasifikasi aset media

Name	Type	Description
CateId	Long	ID kategori.
CateName	String	Nama kategori. Nilai dapat mencapai panjang 64 byte dan harus dikodekan dalam format UTF-8.
ParentId	Long	ID kategori induk. ID kategori induk untuk kategori tingkat 1 adalah -1.
Level	Long	Tingkat kategori. Nilai 0 menunjukkan kategori tingkat 1.

Live to VOD

LiveRecordVideo: Informasi rekaman live-to-VOD

Name	Type	Description
StreamName	String	Nama aliran live.
DomainName	String	Nama domain.
AppName	String	Nama aplikasi.
PlaylistId	String	ID playlist.
RecordStartTime	String	Waktu mulai perekaman.
RecordEndTime	String	Waktu akhir perekaman.
Video	Video	Informasi video.

Pengeditan daring

EditingProject: proyek pengeditan daring

Name	Type	Description
ProjectId	String	ID proyek pengeditan daring.
Title	String	Judul proyek pengeditan daring.
CreationTime	String	Waktu pembuatan proyek pengeditan daring. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC. Misalnya, nilai 2017-01-11T12:00:00Z menunjukkan pukul 20:00:00 pada 11 Januari 2017, waktu Beijing (UTC+8).
ModifiedTime	String	Waktu terakhir proyek pengeditan daring dimodifikasi. Waktu dalam UTC, menggunakan format yyyy-MM-ddTHH:mm:ssZ. Misalnya, 2017-01-11T12:00:00Z (yang merupakan pukul 20:00:00 pada 11 Januari 2017, UTC+8).
Status	String	Status proyek pengeditan daring.
Description	String	Deskripsi proyek pengeditan daring.
Timeline	String	Timeline proyek pengeditan daring. Nilainya adalah string JSON.
Duration	String	Durasi total proyek pengeditan daring. Harus sama dengan durasi total timeline.
CoverURL	String	URL thumbnail proyek pengeditan daring.

ProjectStatus: status proyek pengeditan daring

Value	Description	Remarks
Normal	Draf	Ini adalah status awal proyek pengeditan daring.
Producing	Rendering	Tidak ada.
Produced	Produksi video berhasil.	Tidak ada.
ProduceFailed	Sintesis gagal.	Tidak ada.

Material: informasi material untuk proyek pengeditan daring

Catatan

Jenis ini mencakup secara umum material, termasuk material dari modul Manajemen Material dan video dari Pustaka Media.

Name	Type	Description
MaterialId	String	ID material.
Title	String	Judul material.
Description	String	Deskripsi material.
Duration	Float	Durasi material dalam detik. Nilai akurat hingga empat tempat desimal.
CoverURL	String	URL thumbnail material.
Status	String	Status material.
CreationTime	String	Waktu pembuatan material. Waktu ditampilkan dalam UTC.
Size	Long	Ukuran file sumber dalam byte.
CateId	Long	ID kategori material.
CateName	String	Nama kategori material.
Tags	String	Tag untuk material. Pisahkan beberapa tag dengan koma (,).
Snapshots	String[]	Array berisi URL Snapshot materi.
Sprites	String[]	Array URL sprite material.

ProduceConfig: konfigurasi produksi video

Name	Type	Description
TemplateGroupId	String	ID kelompok template transkoding yang digunakan untuk mentranskode file video yang dihasilkan. Video yang dihasilkan berfungsi sebagai file sumber untuk transkoding. Proses ini mirip dengan transkoding yang berjalan setelah unggahan file selesai. Bidang ini opsional. Jika kosong, kelompok template default dari pengaturan transkoding digunakan. Jika ditentukan, kelompok template yang diberikan digunakan. Untuk melihat ID kelompok template, buka Pengaturan Transkoding di konsol ApsaraVideo VOD.
TemplateId	String	ID template komposisi yang digunakan untuk komposisi video guna menghasilkan file sumber untuk sumber daya media. Bidang ini opsional. Jika nilainya kosong, template pengeditan daring bawaan digunakan untuk komposisi. Jika target komposisi adalah file video, format encoding template bawaan adalah H.264, dan format kontainer adalah MP4. Jika Anda memiliki persyaratan lain untuk menentukan parameter komposisi (seperti komposisi gambar animasi, subtitel cerdas, pengeditan cepat M3U8, atau dukungan parameter komposisi kustom), kirim tiket untuk mengajukan.
Width	Integer	Lebar video output, dalam piksel. Parameter ini opsional. Secara default, resolusi video output diatur menggunakan lebar maksimum dan tinggi maksimum dari semua file sumber dalam timeline. Misalnya, jika timeline berisi tiga file sumber dengan resolusi 1280 × 720 piksel, 1920 × 1080 piksel, dan 720 × 1280 piksel, resolusi video output adalah 1920 × 1280 piksel.
Height	Integer	Tinggi video output dalam piksel. Parameter ini opsional. Secara default, resolusi output diatur menggunakan lebar maksimum dan tinggi maksimum dari semua file sumber dalam timeline. Misalnya, jika timeline menggunakan tiga file sumber dengan resolusi 1280×720, 1920×1080, dan 720×1280, resolusi video output adalah 1920×1280.
Bitrate	Integer	Bitrate video yang dihasilkan. Satuan: Kbit/s. Parameter ini opsional. Nilai default adalah bitrate maksimum dari file sumber yang Anda tentukan di Timeline. Misalnya, Anda menentukan tiga material untuk Timeline dan bitrate file sumbernya adalah 400, 600, dan 800 Kbit/s. Dalam hal ini, bitrate default video yang dihasilkan adalah 800 Kbit/s.
StorageLocation	String	Alamat penyimpanan file. Parameter ini wajib untuk wilayah selain China (Shanghai).

MediaMetadata: metadata video yang dihasilkan

Name	Type	Description
Title	String	Judul video yang dihasilkan. Nilai dapat mencapai panjang 128 byte dan harus dikodekan dalam UTF-8.
Description	String	Deskripsi video yang dihasilkan. Nilai dapat mencapai panjang 1.024 byte dan harus dikodekan dalam UTF-8.
CoverURL	String	URL thumbnail kustom untuk video yang dihasilkan.
CateId	String	ID kategori video yang dihasilkan. Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Manajemen Konfigurasi > Manajemen Media > Kategori.
Tags	String	Tag video yang dihasilkan. Setiap nama tag dapat mencapai panjang 32 byte. Anda dapat menentukan maksimal 16 tag. Pisahkan beberapa tag dengan koma (,). String harus dikodekan dalam format UTF-8.

Pengeditan daring - Timeline (untuk editor baru)

Catatan

Kemampuan pengeditan daring bervariasi berdasarkan wilayah. Sebelum menggunakan fitur ini, pastikan wilayah layanan Anda mendukungnya. Untuk informasi selengkapnya, lihat Wilayah layanan. Untuk deskripsi parameter terkait tipe data pengeditan daring di editor lama, lihat Tipe data pengeditan daring (untuk editor lama).

Timeline: informasi timeline

Timeline merupakan hasil pengaturan aset media dan penerapan efek berdasarkan visi kreatif Anda untuk video. Timeline terutama terdiri dari tiga jenis objek: track, aset media, dan efek.

Name	Type	Required	Description
VideoTracks	VideoTrack[]	Tidak. Jika VideoTracks kosong, AudioTracks tidak boleh kosong.	Daftar track video. Urutan penumpukan beberapa track mengikuti urutan elemen array. Misalnya, layer elemen array pertama muncul di bagian bawah, layer elemen kedua muncul di atasnya, dan seterusnya.
AudioTracks	AudioTrack[]	Tidak. Jika AudioTracks kosong, VideoTracks tidak boleh kosong.	Daftar track audio.
SubtitleTracks	SubtitleTrack[]	Tidak	Daftar track subtitle.
EffectTracks	EffectTrack[]	Tidak	Daftar track efek.

VideoTrack: informasi track video

VideoTrack mengatur aset media berbasis gambar, termasuk material video dan gambar.

Name	Type	Required	Description
Type	String	Tidak	Default ke track video standar. Ketika Type=Effect, track saat ini berfungsi sebagai track efek. Dalam hal ini, VideoTrackClips dapat berisi EffectTrackItem.
MainTrack	Boolean	Tidak	Menentukan apakah track saat ini adalah track utama. Default adalah False.
VideoTrackClips	VideoTrackClip[]	Ya	Daftar klip media track video.

AudioTrack: informasi track audio

AudioTrack mengatur aset media berbasis audio, termasuk file hanya audio dan video yang memiliki aliran audio.

Name	Type	Required	Description
MainTrack	Boolean	Tidak	Menentukan apakah track saat ini adalah track utama. Default adalah False.
AudioTrackClips	AudioTrackClip[]	Ya	Daftar klip media track audio.

SubtitleTrack: informasi track subtitle

SubtitleTrack mengatur subtitle, termasuk teks banner dan file subtitle eksternal.

Name	Type	Required	Description
SubtitleTrackClips	SubtitleTrackClip[]	Ya	Daftar klip media track subtitle.

EffectTrack: informasi track efek

EffectTrack menambahkan efek global ke seluruh video serta mendukung filter dan VFX.

Name	Type	Required	Description
EffectTrackItems	EffectTrackItem[]	Ya	Daftar item track efek.

VideoTrackClip: informasi media track video

VideoTrackClip mencakup aset media video dan gambar.

In, Out, TimelineIn, dan TimelineOut menandai titik awal dan akhir klip sumber serta penempatannya di timeline. Misalnya, untuk menempatkan segmen video dari detik ke-5 hingga ke-10 pada posisi detik ke-15 hingga ke-20 di timeline, atur In=5, Out=10, TimelineIn=15, dan TimelineOut=20.

Name	Type	Required	Description
MediaId	String	Tidak	ID Media klip track video. Dalam beberapa konteks, ini juga disebut VideoId (untuk video/audio) atau ImageId (untuk gambar).
Type	String	Tidak	Jenis klip media. Default adalah Video. Nilai yang valid: Video Image GlobalImage (gambar global; durasi default mengikuti durasi track video terpanjang.) Contoh: Gunakan GlobalImage di track video
X	Float	Tidak	Jarak horizontal dari pojok kiri atas gambar atau video ke pojok kiri atas video output. Mendukung nilai persentase atau piksel. Nilai antara [0–0,9999] merepresentasikan persentase dari lebar video output. Bilangan bulat ≥2 merepresentasikan piksel absolut.
Y	Float	Tidak	Jarak vertikal dari pojok kiri atas gambar atau video ke pojok kiri atas video output. Mendukung nilai persentase atau piksel. Nilai antara [0–0,9999] merepresentasikan persentase dari tinggi video output. Bilangan bulat ≥2 merepresentasikan piksel absolut.
Width	Float	Tidak	Lebar gambar dalam video output. Mendukung nilai persentase atau piksel. Nilai antara [0–0,9999] merepresentasikan persentase dari lebar video output. Bilangan bulat ≥2 merepresentasikan piksel absolut.
Height	Float	Tidak	Tinggi gambar dalam video output. Mendukung nilai persentase atau piksel. Nilai antara [0–0,9999] merepresentasikan persentase dari tinggi video output. Bilangan bulat ≥2 merepresentasikan piksel absolut.
AdaptMode	String	Tidak	Mode penskalaan video. Default adalah Fill. Mode ini hanya berlaku ketika Width dan Height keduanya diatur untuk track video. Dalam hal ini, Width dan Height menentukan dimensi area target, dan video diskalakan secara adaptif di dalam area tersebut. Contain: Menskalakan konten agar sesuai dengan area target sambil mempertahankan rasio aspeknya. Cover: Mengisi seluruh area target sambil mempertahankan rasio aspek. Konten mungkin dipotong jika rasio aspek tidak cocok. Fill: Meregangkan konten agar tepat mengisi area target. Rasio aspek tidak dipertahankan.
In	Float	Tidak	Waktu mulai klip relatif terhadap media sumber. Hanya berlaku untuk sumber audio/video. Satuan: detik, akurat hingga empat tempat desimal. Default ke 0 jika tidak ditentukan.
Out	Float	Tidak	Waktu akhir klip relatif terhadap media sumber. Hanya berlaku untuk sumber audio/video. Satuan: detik, akurat hingga empat tempat desimal. Default ke durasi sumber penuh jika tidak ditentukan.
MaxOut	Float	Tidak	Waktu akhir maksimum klip relatif terhadap media sumber. Jika diatur, titik Out aktual menjadi lebih kecil antara durasi sumber atau MaxOut. Hanya berlaku untuk sumber audio/video. Satuan: detik, akurat hingga empat tempat desimal. Jika Out ditentukan, MaxOut diabaikan. Contoh: Atur MaxOut di track video
Duration	Float	Tidak	Durasi klip. Biasanya digunakan untuk sumber gambar. Satuan: detik, akurat hingga empat tempat desimal.
DyncFrames	Int	Tidak	Laju frame untuk gambar animasi. Hanya berlaku ketika sumbernya adalah gambar animasi. Contoh: Gunakan stiker GIF
TimelineIn	Float	Tidak	Waktu mulai klip di timeline. Satuan: detik, akurat hingga empat tempat desimal. Jika tidak ditentukan, TimelineIn dihitung secara otomatis berdasarkan penempatan berurutan.
TimelineOut	Float	Tidak	Waktu akhir klip di timeline. Satuan: detik, akurat hingga empat tempat desimal. Jika tidak ditentukan, TimelineOut dihitung secara otomatis berdasarkan penempatan berurutan.
Speed	Float	Tidak	Kecepatan pemutaran klip video. Rentang valid: 0,1–100. Misalnya, Speed=2 memutar klip dengan kecepatan dua kali lipat, sehingga Durasi-nya di output akhir menjadi separuhnya. Contoh: Sesuaikan kecepatan audio/video
MaskVideoUrl	String	Tidak	URL video mask. Biasanya video dengan saluran alfa, digunakan untuk menambahkan efek transparansi ke video asli. Hanya mendukung URL OSS publik.
Effects	Effect[]	Tidak	Daftar efek yang diterapkan pada klip.

AudioTrackClip: informasi media track audio

AudioTrackClip mencakup file hanya audio dan video yang berisi aliran audio.

In, Out, TimelineIn, dan TimelineOut menandai titik awal dan akhir klip sumber serta penempatannya pada garis waktu. Sebagai contoh, untuk menempatkan segmen detik ke-5 hingga ke-10 dari sebuah video pada posisi detik ke-15 hingga ke-20 di garis waktu, Anda dapat mengatur In=5, Out=10, TimelineIn=15, dan TimelineOut=20.

Name	Type	Required	Description
MediaId	String	Tidak	ID Media klip track audio.
In	Float	Tidak	Waktu mulai klip relatif terhadap media sumber. Satuan: detik, akurat hingga empat tempat desimal. Default ke 0 jika tidak ditentukan.
Out	Float	Tidak	Waktu akhir klip relatif terhadap media sumber. Satuan: detik, akurat hingga empat tempat desimal. Default ke durasi sumber penuh jika tidak ditentukan.
TimelineIn	Float	Tidak	Waktu mulai klip di timeline. Satuan: detik, akurat hingga empat tempat desimal. Jika tidak ditentukan, TimelineIn dihitung secara otomatis berdasarkan penempatan berurutan.
TimelineOut	Float	Tidak	Waktu akhir klip di timeline. Satuan: detik, akurat hingga empat tempat desimal. Jika tidak ditentukan, TimelineOut dihitung secara otomatis berdasarkan penempatan berurutan.
Speed	Float	Tidak	Kecepatan pemutaran klip audio. Rentang valid: 0,1–100. Misalnya, Speed=2 memutar klip dengan kecepatan dua kali lipat, sehingga Durasi-nya di output akhir menjadi separuhnya. Contoh: Sesuaikan kecepatan audio/video
Effects	Effect[]	Tidak	Daftar efek yang diterapkan pada klip.
LoopMode	Boolean	Tidak	Perilaku putar ulang berulang untuk klip di timeline. True mengaktifkan putar ulang berulang. False (default) menonaktifkan putar ulang berulang. Contoh: Putar ulang audio berulang

SubtitleTrackClip: informasi media track subtitle

SubtitleTrackClip mencakup aset media subtitle.

Name	Type	Required	Description
Type	String	Ya	Jenis media subtitle. Nilai yang valid: Subtitle: file subtitle eksternal Text: teks banner
SubType	String	Tidak	Subtipe media subtitle. Nilai yang valid: srt: subtitle SRT eksternal ass: subtitle ASS eksternal Abaikan bidang ini ketika Type adalah Text.
FileURL	String	Tidak	URL OSS file subtitle. Wajib ketika Type adalah Subtitle. Format: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.srt Contoh: Edit langsung menggunakan file subtitle Catatan FileURL hanya mendukung URL OSS publik. URL OSS yang dipercepat, URL CDN, dan URL HTTP lainnya tidak didukung.
X	Float	Tidak	Ketika Type adalah Text, jarak horizontal dari pojok kiri atas teks ke pojok kiri atas video output. Mendukung nilai persentase atau piksel. Nilai antara [0–0,9999] merepresentasikan persentase dari lebar video output. Bilangan bulat >=2 merepresentasikan piksel absolut.
Y	Float	Tidak	Ketika Type adalah Text, jarak vertikal dari pojok kiri atas teks ke pojok kiri atas video output. Mendukung nilai persentase atau piksel. Nilai antara [0–0,9999] merepresentasikan persentase dari tinggi video output. Bilangan bulat >=2 merepresentasikan piksel absolut.
TimelineIn	Float	Tidak	Ketika Type adalah Text, waktu mulai teks di timeline. Satuan: detik, akurat hingga empat tempat desimal. Jika tidak ditentukan, TimelineIn dihitung secara otomatis berdasarkan penempatan berurutan.
TimelineOut	Float	Tidak	Ketika Type adalah Text, waktu akhir teks di timeline. Satuan: detik, akurat hingga empat tempat desimal. Jika tidak ditentukan, TimelineOut dihitung secara otomatis berdasarkan penempatan berurutan.
Content	String	Tidak	Ketika Type adalah Text, wajib. Menentukan konten teks.
Font	String	Tidak	Ketika Type adalah Text, menentukan font. Default adalah SimSun. Untuk daftar lengkap font yang didukung, lihat Daftar font.
FontSize	Int	Tidak	Ketika jenis caption adalah teks banner, menentukan ukuran font.
FontColor	String	Tidak	Ketika Type adalah Text, menentukan warna font dalam format heksadesimal (# diikuti digit heksa). Contoh: #ffffff.
FontColorOpacity	String	Tidak	Ketika Type adalah Text, menentukan transparansi font. Rentang valid: 0–1. Default adalah 1 (buram). 0 berarti sepenuhnya transparan.
FontFace	FontFace	Tidak	Ketika Type adalah Text, menentukan gaya font.
Spacing	Int	Tidak	Ketika Type adalah Text, menentukan spasi karakter. Satuan: piksel. Default adalah 0.
Angle	Float	Tidak	Ketika Type adalah Text, menentukan sudut rotasi berlawanan arah jarum jam. Satuan: derajat. Default adalah 0.
BorderStyle	Int	Tidak	Menentukan gaya border dan bayangan untuk teks banner. Nilai yang valid: 1 atau 3. 1 = border + bayangan. 3 = kotak latar belakang buram. Default adalah 1.
Outline	Int	Tidak	Ketika Type adalah Text, menentukan lebar goresan. Satuan: piksel. Default adalah 0.
OutlineColour	String	Tidak	Ketika Type adalah Text, menentukan warna goresan dalam format heksadesimal (# diikuti digit heksa). Contoh: #ffffff.
Shadow	Int	Tidak	Ketika Type adalah Text, menentukan kedalaman bayangan. Satuan: piksel. Default adalah 0.
BackColour	String	Tidak	Ketika Type adalah Text, menentukan warna bayangan dalam format heksadesimal (# diikuti digit heksa). Contoh: #ffffff.
Alignment	String	Tidak	Ketika Type adalah Text, menentukan perataan teks. Default adalah TopLeft. Nilai yang valid: TopLeft: pojok kiri atas video TopCenter: tengah atas sepanjang sumbu vertikal TopRight: pojok kanan atas video CenterLeft: sisi kiri sumbu tengah horizontal video CenterCenter: tengah video CenterRight: tengah kanan sepanjang sumbu horizontal BottomLeft: pojok kiri bawah video BottomCenter: tengah bawah sepanjang sumbu vertikal BottomRight: pojok kanan bawah video
AdaptMode	String	Tidak	Menentukan cara teks banner beradaptasi ketika melebihi lebar video atau TextWidth yang ditentukan. Nilai yang valid: AutoWrap: membungkus baris secara otomatis AutoScale: Penskalaan Otomatis AutoWrapAtSpaces: membungkus hanya pada karakter spasi (ideal untuk subtitle bahasa Inggris saja)
TextWidth	Integer	Tidak	Lebar kotak teks subtitle. Hanya berlaku ketika AdaptMode diatur. Pembungkusan atau penskalaan baris otomatis menggunakan lebar ini. Jika tidak ditentukan, lebar video digunakan. Satuan: piksel.
FontUrl	String	Tidak	Ketika Type adalah Text, mendukung file font kustom dari bucket OSS Anda. Format yang didukung: ttf, otf, woff. Contoh: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf
EffectColorStyle	String	Tidak	Ketika Type adalah Text, menentukan gaya seni kata. Untuk gaya dan efek seni kata, lihat Contoh efek seni kata.
AaiMotionInEffect	String	Tidak	Ketika Type adalah Text, menentukan efek animasi masuk. Untuk jenis dan contoh efek masuk, lihat Efek masuk.
AaiMotionIn	Float	Tidak	Ketika Type adalah Text, menentukan durasi efek masuk. Satuan: detik, akurat hingga empat tempat desimal. Default ke 0,5 detik jika tidak ditentukan. Jika durasi teks total kurang dari 0,5 detik, durasi masuk sama dengan durasi total dikurangi durasi keluar.
AaiMotionOutEffect	String	Tidak	Ketika jenis subtitle adalah banner, menentukan efek masuk untuk teks banner. Untuk jenis dan efek caption masuk, lihat Efek masuk.
AaiMotionOut	Float	Tidak	Ketika Type adalah Text, menentukan durasi efek keluar. Satuan: detik, akurat hingga empat tempat desimal. Default ke 0,5 detik jika tidak ditentukan. Jika durasi teks total kurang dari 0,5 detik, durasi keluar sama dengan durasi teks total.
AaiMotionLoopEffect	String	Tidak	Ketika Type adalah Text, menentukan efek animasi berulang. Tidak dapat digunakan bersamaan dengan efek masuk atau keluar. Untuk jenis dan contoh efek berulang, lihat Efek berulang.
Ratio	Float	Tidak	Ketika Type adalah Text, menentukan kecepatan pemutaran efek berulang. Akurat hingga empat tempat desimal. Default ke 1 jika tidak ditentukan. Nilai lebih besar dari 1 mempercepat loop. Nilai kurang dari 1 memperlambatnya.

EffectTrackItem: informasi item track efek

EffectTrackItem mencakup efek VFX dan filter.

Name	Type	Required	Description
Type	String	Ya	Jenis item track efek. Nilai yang valid: VFX, Filter.
SubType	String	Ya	Subtipe item track efek. Untuk jenis efek yang didukung dan contohnya, lihat Contoh efek khusus dan Contoh efek filter.
TimelineIn	Float	Tidak	Waktu mulai efek di timeline. Satuan: detik, akurat hingga empat tempat desimal. Default ke 0 jika tidak ditentukan.
TimelineOut	Float	Tidak	Waktu akhir efek di timeline. Satuan: detik, akurat hingga empat tempat desimal. Default ke waktu akhir video jika tidak ditentukan.
Duration	Float	Tidak	Durasi efek di timeline. Satuan: detik, akurat hingga empat tempat desimal. Default ke durasi video jika tidak ditentukan. Catatan Hanya salah satu dari Duration atau TimelineOut yang berlaku.
X	Float	Tidak	Hanya berlaku ketika SubType adalah mosaic_rect atau blur. Jarak horizontal dari pojok kiri atas area efek ke pojok kiri atas video output. Mendukung nilai persentase atau piksel. Nilai antara [0–0,9999] merepresentasikan persentase dari lebar video output. Bilangan bulat ≥2 merepresentasikan piksel absolut.
Y	Float	Tidak	Hanya berlaku ketika SubType adalah mosaic_rect atau blur. Jarak vertikal dari pojok kiri atas area efek ke pojok kiri atas video output. Mendukung nilai persentase atau piksel. Nilai antara [0–0,9999] merepresentasikan persentase dari tinggi video output. Bilangan bulat ≥2 merepresentasikan piksel absolut.
Width	Float	Tidak	Hanya berlaku ketika SubType adalah mosaic_rect atau blur. Lebar area efek dalam video output. Mendukung nilai persentase atau piksel. Nilai antara [0–0,9999] merepresentasikan persentase dari lebar video output. Bilangan bulat ≥2 merepresentasikan piksel absolut.
Height	Float	Tidak	Hanya berlaku ketika SubType adalah mosaic_rect atau blur. Tinggi area efek dalam video output. Mendukung nilai persentase atau piksel. Nilai antara [0–0,9999] merepresentasikan persentase dari tinggi video output. Bilangan bulat ≥2 merepresentasikan piksel absolut.

FontFace: gaya font

Name	Type	Required	Description
Bold	Boolean	Tidak	Tebal.
Italic	Boolean	Tidak	Miring.
Underline	Boolean	Tidak	Garis bawah.

Effect: informasi efek

Jenis efek yang berbeda memiliki properti unik, tetapi juga berbagi atribut umum.

Untuk deskripsi detail properti Effect individual, lihat Referensi konfigurasi efek.

Properti Effect umum adalah sebagai berikut:

Name

Type

Required

Description

Type

String

Jenis efek. Nilai yang valid:

Text: teks banner untuk klip track video.
DeWatermark: penghapusan watermark untuk klip track video.
Crop: pemotongan untuk klip track video.
Scale: penskalaan untuk klip track video.
Pad: Penjepitan klip track video
Background: pengaturan latar belakang untuk klip track video.
Transition: efek transisi untuk klip track video.
VFX: efek visual untuk klip track video.
Filter: filter untuk klip track video.
Volume: penyesuaian volume untuk klip track audio.
AFade: fade-in dan fade-out audio untuk klip track audio.
Rotate: rotasi untuk klip track video.
Clip: pemotongan acak.
Flip: pembalikan.
KenBurns: efek Ken Burns (pan dan zoom).
Zoom: pembesaran.

SubType

String

Tidak

Subtipe efek.

Ketika Type adalah Transition, ini menentukan subtipe transisi. Untuk nilai yang valid, lihat Contoh efek transisi.
Ketika Type adalah VFX, ini menentukan subtipe efek visual. Untuk nilai yang valid, lihat Contoh efek khusus.
Ketika Type adalah Filter, ini menentukan subtipe filter. Untuk nilai yang valid, lihat Contoh efek filter.

Tangkapan video dan gambar dinamis

SnapshotJob: Informasi pekerjaan snapshot

Name	Type	Description
JobId	String	ID pekerjaan.

VodTemplateInfo: Informasi template snapshot

Name	Type	Description
Name	String	Nama template.
VodTemplateId	String	ID template.
TemplateType	String	Jenis template. Nilai yang valid: Snapshot: snapshot. DynamicImage: gambar dinamis.
IsDefault	String	Menunjukkan apakah ini adalah watermark default. Nilai yang valid: Default: Watermark adalah yang default. NotDefault: Watermark bukan yang default.
TemplateConfig	JSON	Konfigurasi terperinci template. Nilainya adalah string JSON. Untuk informasi selengkapnya tentang konfigurasi snapshot, lihat SnapshotTemplateConfig. Untuk konfigurasi DynamicImage, lihat DynamicImageTemplateConfig.
CreationTime	String	Waktu pembuatan template. Waktu dalam format UTC.
ModifyTime	String	Waktu terakhir template dimodifikasi. Waktu dalam format UTC.

MediaSnapshot: Data snapshot media

Name	Type	Description
JobId	String	ID pekerjaan snapshot.
CreationTime	String	Waktu pembuatan pekerjaan snapshot. Waktu dalam UTC.
Total	Long	Jumlah total snapshot.
Regular	String	Aturan untuk menghasilkan URL snapshot.
Snapshots	Snapshot[]	Data snapshot.

Snapshot: Informasi snapshot

Name	Type	Description
Index	String	Nilai indeks snapshot.
Url	String	URL snapshot.

DynamicImage: Informasi gambar dinamis

Name	Type	Description
VideoId	String	ID video.
DynamicImageId	String	ID gambar dinamis.
FileURL	String	URL file gambar dinamis.
Width	String	Lebar gambar dinamis.
Height	String	Tinggi gambar dinamis.
Duration	String	Durasi gambar dinamis.
Format	String	Format gambar dinamis. Nilai yang valid adalah `gif` atau `webp`.
FileSize	String	Ukuran file gambar dinamis.
Fps	String	Laju frame gambar dinamis.

Tanda Air

WatermarkInfo: informasi tentang watermark

Name	Type	Required	Description
CreationTime	String	Ya	Waktu penambahan watermark.
Name	String	Ya	Nama watermark.
IsDefault	String	Ya	Menunjukkan apakah watermark adalah yang default. Nilai yang valid: Default: watermark default. NotDefault: Watermark non-default.
Type	String	Ya	Jenis watermark. Nilai yang valid: Image: Gambar. Text: teks.
WatermarkId	String	Ya	ID watermark.
FileUrl	String	Tidak	URL OSS atau CDN file watermark. Parameter ini tidak berlaku untuk watermark teks.
WatermarkConfig	WatermarkConfig	Ya	Konfigurasi untuk posisi dan efek watermark teks atau gambar. Nilainya harus berupa string JSON.

Transkoding audio dan video

TranscodeJob: informasi tentang pekerjaan transkoding

Name	Type	Description
JobId	String	ID pekerjaan transkoding.

TranscodeTemplateGroup: informasi tentang kelompok template transkoding

Name	Type	Required	Description
Name	String	Ya	Nama kelompok template.
TranscodeTemplateGroupId	String	Ya	ID kelompok template transkoding.
IsDefault	String	Ya	Menunjukkan apakah ini adalah kelompok template default. Nilai yang valid: Default: kelompok template default. NotDefault: kelompok template non-default.
CreationTime	String	Ya	Waktu pembuatan kelompok template.
ModifyTime	String	Ya	Waktu terakhir kelompok template dimodifikasi.
TranscodeTemplateList	TranscodeTemplate[]	Ya	Daftar konfigurasi template transkoding.

TranscodeTemplate: konfigurasi template transkoding

Name	Type	Required	Description
Type	String	Tidak	Jenis template. Nilai yang valid: Normal: template transkoding reguler. Anda tidak dapat mengatur parameter PackageSetting untuk jenis template ini. VideoPackage: template pengemasan aliran video. Template ini pertama-tama mentranskode video, lalu membangun aliran bitrate adaptif. Anda harus mengonfigurasi parameter PackageSetting. SubtitlePackage: template pengemasan subtitle. Jenis template ini tidak melakukan transkoding. Sebaliknya, menyematkan informasi caption yang sesuai ke dalam file output bitrate adaptif. Anda harus mengonfigurasi parameter PackageSetting. Namun, jenis template ini tidak dapat berdiri sendiri dalam kelompok template. Anda harus mengonfigurasinya bersama dengan template VideoPackage, dan Anda hanya dapat mengonfigurasi satu template semacam ini dalam kelompok template. Nilai default: Normal.
Video	Video	Ya	Konfigurasi transkoding untuk aliran video. Nilainya harus berupa string JSON.
Audio	Audio	Ya	Konfigurasi transkoding untuk aliran audio. Nilainya harus berupa string JSON.
Definition	String	Ya	Definisi template transkoding reguler. Nilai yang valid: LD: definisi rendah. SD: definisi standar. HD: definisi tinggi. FHD: ultra definisi tinggi. OD: kualitas asli. Nilai ini digunakan untuk konversi format kontainer. 2K 4K SQ: kualitas suara standar. HQ: kualitas suara tinggi. Catatan Definisi ini hanya tag dalam template transkoding. Tidak merepresentasikan rentang resolusi aktual video output. Untuk informasi selengkapnya tentang pemetaan definisi template ke resolusi video output, lihat Specification. Definisi ini tidak berpengaruh pada biaya transkoding. Untuk informasi selengkapnya tentang biaya transkoding, lihat Paket transkoding ApsaraVideo VOD. Definisi template transkoding Narrowband HD 1.0. Nilai yang valid: LD-NBV1: definisi rendah. SD-NBV1: definisi standar. HD-NBV1: definisi tinggi. FHD-NBV1: ultra definisi tinggi. 2K-NBV1 4K-NBV Catatan Anda tidak dapat memodifikasi definisi template transkoding apa pun. Template transkoding Narrowband HD™ 1.0 menggunakan parameter sistem yang ditentukan seperti resolusi video, resolusi audio, dan bitrate. Anda tidak dapat memodifikasi parameter ini. Untuk informasi selengkapnya, lihat Narrowband HD™ 1.0. Anda hanya dapat membuat template transkoding Narrowband HD 1.0 untuk format output FLV, M3U8 (HLS), dan MP4.
Container	Container	Ya	Format kontainer yang digunakan untuk mengenkapsulasi aliran audio dan video. Nilainya harus berupa string JSON.
MuxConfig	MuxConfig	Tidak	Konfigurasi segmen untuk transkoding. Anda harus menentukan parameter ini jika format kontainer adalah HLS. Nilainya harus berupa string JSON.
TransConfig	TransConfig	Tidak	Konfigurasi transkoding kondisional. Gunakan parameter ini untuk menerapkan logika dasar berdasarkan bitrate dan resolusi video sumber sebelum menghasilkan video yang ditranskode. Nilainya harus berupa string JSON.
TranscodeFileRegular	String	Tidak	Jalur kustom untuk menyimpan file output. Catatan Wildcard yang didukung: {MediaId} (ID video), {JobId} (ID pekerjaan transkoding), dan {PlayDefinition} (definisi yang dikembalikan oleh operasi GetPlayInfo). Hanya angka, huruf Inggris, tanda kurung kurawal {}, garis miring (/), tanda hubung (-), dan garis bawah (_) yang diizinkan. Panjang maksimum adalah 128 karakter. Jalur harus dimulai dengan {MediaId}. Contoh konfigurasi {MediaId}/watermark-{PlayDefinition}: Selama transkoding, ApsaraVideo VOD mengganti {MediaId} dengan ID video (misalnya, 8ff5cc93f6da4079a47a77bf71d) dan {PlayDefinition} dengan definisi (misalnya, fd). Contoh output 8ff5cc93f6da4079a47a77bf71d/watermark-fd.mp4 (ApsaraVideo VOD secara otomatis menambahkan ekstensi file, seperti .mp4, .m3u8, atau .flv).
Clip	Clip	Tidak	Konfigurasi pemotongan video. Nilainya harus berupa string JSON. Misalnya, atur parameter ini untuk mengekstrak konten 5 detik dari video guna menghasilkan video baru.
Rotate	String	Tidak	Sudut rotasi video. Nilai yang valid: [0,360]. Misalnya, mengatur parameter ini ke 180 membalik gambar video secara terbalik.
EncryptSetting	EncryptSetting	Tidak	Konfigurasi enkripsi untuk transkoding.
PackageSetting	PackageSetting	Tidak	Konfigurasi pengemasan. Hanya pengemasan bitrate adaptif HLS dan pengemasan DASH yang didukung. Nilainya harus berupa string JSON.
SubtitleList	SubtitleConfig	Tidak	Konfigurasi subtitle. Nilainya harus berupa string JSON.
WatermarkIds	String[]	Tidak	ID watermark yang terkait. Anda dapat mengaitkan hingga empat ID watermark. USER_DEFAULT_WATERMARK merepresentasikan ID watermark default.
TranscodeTemplateId	String	Tidak	ID template transkoding. Anda harus menentukan parameter ini saat memodifikasi template.
TemplateName	String	Tidak	Nama template transkoding. Anda harus menentukan parameter ini saat membuat template.

Contoh parameter TranscodeTemplate

{
        "Type":"VideoPackage",
        "Video":{
                "Codec":"H.264",
                "Bitrate":"900",
                "Width":"960",
                "Remove":"false",
                "Fps":"30"
        },
        "Audio":{
                "Codec":"AAC",
                "Bitrate":"128",
                "Samplerate":"44100"
        },
        "Container":{
                "Format":"m3u8"
        },
        "MuxConfig":{
                "Segment":{
                        "Duration":"6"
                }
        },
        "EncryptSetting":{
                "EncryptType":"AliyunVoDEncryption"
        },
        "PackageSetting":{
                "PackageType":"HLSPackage"
                "PackageConfig":{
                        "BandWidth":"900000"
                }
        },
       "SubtitleUrl": "http://outin-40564284ef058b2163e1****.oss-cn-shanghai.aliyuncs.com/subtitles/c737f-14f1-4364-b107-d5f7f8ed****-cn.ass",
        "CharEncode": "UTF-8",
        "WatermarkIds":["USER_DEFAULT_WATERMARK","ddddddddd"],
        "Definition":"SD",
        "TemplateName":"test"
}

Video: konfigurasi transkoding aliran video

Catatan

Jika tidak memiliki persyaratan khusus, cukup atur Codec, Bitrate, Height, Width, dan Remove=false.
Disarankan hanya mengatur salah satu dari Width atau Height untuk video output agar rasio aspek sesuai dengan video sumber.

Name	Type	Required	Description
Codec	String	Ya	Format encoding video: H.264 atau H.265.
Remove	String	Ya	Menunjukkan apakah aliran video dihapus. Nilai yang valid: true: menghapus aliran video dari file output. false: mempertahankan aliran video dalam file output. Nilai default: false.
Bitrate	String	Tidak	Bitrate target untuk video output. Jika Anda tidak menentukan parameter ini, bitrate dihitung menggunakan parameter Crf. Satuan: Kbps. Nilai yang valid: [10,50000].
Height	String	Tidak	Tinggi video output. Nilainya harus kelipatan 2. Jika Anda tidak menentukan parameter ini, tinggi file sumber digunakan. Satuan: piksel. Nilai yang valid: [128,4096].
Width	String	Tidak	Lebar video output. Nilainya harus kelipatan 2. Jika Anda tidak menentukan parameter ini, lebar file sumber digunakan. Satuan: piksel. Nilai yang valid: [128,4096].
Fps	String	Tidak	Laju frame video output. Jika Anda tidak menentukan parameter ini, laju frame file sumber digunakan. Satuan: FPS. Nilai yang valid: (0,60].
Gop	String	Tidak	Jarak antara keyframe yang berdekatan. Satuan: frame. Nilai yang valid: [1,100000].
LongShortMode	String	Tidak	Mengaktifkan layar putar-otomatis. Lebar video output sesuai dengan sisi panjang sumber (tinggi dalam mode potret). Tinggi video output sesuai dengan sisi pendek sumber (lebar dalam mode potret). Nilai yang valid: true: Diaktifkan. false: Fitur dinonaktifkan. Nilai default: true. Fitur ini bekerja paling baik untuk video potret. Kami menyarankan mengaktifkannya.
Crf	String	Tidak	Faktor kontrol kualitas bitrate. Jika Anda menentukan parameter ini, parameter Bitrate diabaikan. Nilai yang lebih tinggi menghasilkan kualitas video lebih rendah dan ukuran file lebih kecil. Nilai yang lebih rendah menghasilkan kualitas video lebih tinggi, ukuran file lebih besar, dan waktu transkoding lebih lama. Nilai yang valid: [0,51]. Nilai default: 26. Kami tidak menyarankan mengubah nilai ini.
Profile	String	Tidak	Profil encoding. Nilai yang valid: baseline: cocok untuk perangkat seluler. main: cocok untuk perangkat definisi standar. high: cocok untuk perangkat definisi tinggi. Nilai default: high. Parameter ini hanya berlaku untuk encoding H.264. Praktik terbaik Jika Anda mendukung beberapa definisi, atur definisi terendah ke baseline untuk memastikan pemutaran pada perangkat low-end. Atur definisi lain ke main atau high.
Preset	String	Tidak	Algoritma video preset. Nilai yang valid: veryfast, fast, medium, slow, slower. Nilai default: medium. Parameter ini hanya berlaku untuk encoding H.264. Kami tidak menyarankan mengubah nilai ini.
ScanMode	String	Tidak	Mode pemindaian. Nilai yang valid: interlaced: pemindaian interlaced. progressive: pemindaian progresif.
Bufsize	String	Tidak	Ukuran buffer. Satuan: KB. Nilai yang valid: [1000,128000]. Nilai default: 6000.
Maxrate	String	Tidak	Bitrate puncak video. Satuan: Kbps. Nilai yang valid: [1000,50000].
PixFmt	String	Tidak	Format piksel video. Format standar seperti yuv420p dan yuvj420p didukung. Nilai default: yuv420p atau format piksel asli.

Contoh parameter Video

{
        "Codec":"H.264",
        "Bitrate":"128",
        "Remove":"false",
        "Width":"640",
        "Fps":"30"
}

Audio: konfigurasi transkoding aliran audio

Catatan

Jika tidak memiliki persyaratan khusus, cukup atur Codec, Bitrate, dan Remove=false.

Name	Type	Required	Description
Codec	String	Ya	Format encoding audio: AAC atau MP3.
Bitrate	String	Ya	Bitrate target untuk audio output. Satuan: Kbps. Nilai yang valid: [8,1000].
Remove	String	Ya	Menunjukkan apakah aliran audio dihapus. Nilai yang valid: true: menghapus aliran audio dari file output. false: mempertahankan aliran audio dalam file output. Nilai default: false.
Samplerate	String	Ya	Laju sampel. Satuan: Hz. Nilai yang valid: 22050, 32000, 44100, 48000, 96000. Nilai default: 44100. Jika format kontainer adalah FLV dan codec audio adalah MP3, laju sampel tidak boleh 32000, 48000, atau 96000. Jika codec audio adalah MP3, laju sampel tidak boleh 96000.
Channels	String	Tidak	Jumlah saluran audio. Nilai default: 2. Jika Codec diatur ke MP3, nilai yang valid adalah 1 atau 2. Jika Codec diatur ke AAC, nilai yang valid adalah 1, 2, 4, 5, 6, atau 8.
Profile	String	Tidak	Profil codec audio. Jika Codec diatur ke AAC, nilai yang valid termasuk aac_low, aac_he, aac_he_v2, aac_ld, dan aac_eld.
Volume	Volume	Tidak	Konfigurasi volume.

Contoh parameter Audio

{
        "Codec":"AAC",
        "Bitrate":"128",
        "Remove":"false",
        "Samplerate":"44100"
}

Container: format kontainer

Name

Type

Required

Description

Format

String

Format kontainer.

Transkoding video mendukung FLV, MP4, dan HLS (M3U8+TS).
Transkoding audio mendukung MP3 dan MP4.
Jika format kontainer adalah FLV, codec video tidak boleh diatur ke H.265.

Contoh parameter Container

{
        "Format":"mp4"
}

MuxConfig: konfigurasi segmen HLS

Catatan

Parameter ini wajib ditentukan jika format kontainer diatur ke m3u8.

Name	Type	Required	Description
Segment	Segment	Ya	Objek JSON yang berisi bidang konfigurasi segmen.

Segment: detail konfigurasi segmen

Name

Type

Required

Description

Duration

String

Durasi setiap segmen TS. Nilainya harus bilangan bulat. Nilai yang valid: [1,60]. Satuan: detik.

Contoh: {"Duration":"10"}.

Contoh parameter MuxConfig

{
        "Segment":{
                "Duration":"10"
        }
}

TransConfig: konfigurasi transkoding kondisional

Name	Type	Required	Description
TransMode	String	Tidak	Mode transkoding. Nilai yang valid: onepass: mode bitrate rata-rata (ABR). Encoding lebih cepat daripada twopass. Alibaba Cloud menggunakan onepass secara default. twopass: mode bitrate variabel (VBR). Encoder berjalan dua kali untuk mengalokasikan bitrate secara tepat, menghasilkan file lebih kecil dengan kualitas lebih tinggi. Twopass memakan waktu lebih lama daripada onepass dan tidak cocok untuk skenario sensitif latensi seperti streaming langsung atau komunikasi real-time. Jika video input sangat terkompresi, twopass dapat menyebabkan artefak blocking. CBR: mode bitrate konstan. File menggunakan bitrate yang sama sepanjang durasi. File CBR lebih besar daripada file VBR atau ABR dan tidak menawarkan peningkatan kualitas signifikan. Nilai default: onepass.
IsCheckReso	String	Tidak	Memeriksa resolusi video sumber untuk menentukan apakah akan menggunakan resolusi sumber untuk transkoding. Nilai yang valid: true: memeriksa resolusi. Jika resolusi output melebihi resolusi sumber (berdasarkan lebar atau tinggi), resolusi output diatur ke resolusi sumber. false: melewati pemeriksaan. Nilai default: false.
IsCheckResoFail	String	Tidak	Memeriksa resolusi video sumber untuk menentukan apakah transkoding gagal. Nilai yang valid: true: memeriksa resolusi. Jika resolusi output melebihi resolusi sumber (berdasarkan lebar atau tinggi), transkoding gagal. false: melewati pemeriksaan. Nilai default: false.
IsCheckVideoBitrate	String	Tidak	Memeriksa bitrate video sumber untuk menentukan apakah akan menggunakan bitrate sumber untuk transkoding. Nilai yang valid: true: memeriksa bitrate. Jika bitrate output melebihi bitrate sumber, bitrate output diatur ke bitrate sumber. false: melewati pemeriksaan. Nilai default: false.
IsCheckVideoBitrateFail	String	Tidak	Memeriksa bitrate video sumber untuk menentukan apakah transkoding gagal. Nilai yang valid: true: memeriksa bitrate. Jika bitrate output melebihi bitrate sumber, transkoding tidak dilakukan. false: melewati pemeriksaan. Nilai default: false. Nilai ini mengambil prioritas atas IsCheckVideoBitrate.
IsCheckAudioBitrate	String	Tidak	Memeriksa bitrate audio sumber untuk menentukan apakah akan menggunakan bitrate sumber untuk transkoding. Nilai yang valid: true: memeriksa bitrate. Jika bitrate output melebihi bitrate sumber, bitrate output diatur ke bitrate sumber. false: melewati pemeriksaan. Nilai default: false.
IsCheckAudioBitrateFail	String	Tidak	Memeriksa bitrate audio sumber untuk menentukan apakah transkoding gagal. Nilai yang valid: true: memeriksa bitrate. Jika bitrate output melebihi bitrate sumber, transkoding tidak dilakukan. false: melewati pemeriksaan. Nilai default: false. Nilai ini mengambil prioritas atas IsCheckAudioBitrate.

Contoh parameter TransConfig

{
        "IsCheckReso":"true",
        "IsCheckResoFail":"false",
        "IsCheckVideoBitrate":"false",
        "IsCheckVideoBitrateFail":"false",
        "IsCheckAudioBitrate":"false",
        "IsCheckAudioBitrateFail":"false"
}

Clip: konfigurasi pemotongan video

Name	Type	Required	Description
TimeSpan	TimeSpan	Ya	Konfigurasi terkait waktu untuk pemotongan video.

TimeSpan: konfigurasi pemotongan video

Name	Type	Required	Description
Seek	String	Ya	Waktu mulai klip video. Format 1: sssss[.SSS]. Nilai yang valid: [0.000,86399.999]. Contoh: 12000.55. Format 2: hh:mm:ss[.SSS]. Nilai yang valid: [00:00:00.000,23:59:59.999]. Contoh: 00:00:05.003. Kami menyarankan menggunakan Format 1.
Duration	String	Tidak	Durasi pemotongan video. Format 1: sssss[.SSS]. Nilai yang valid: [0.000,86399.999]. Contoh: 12000.55. Format 2: hh:mm:ss[.SSS]. Nilai yang valid: [00:00:00.000,23:59:59.999]. Contoh: 00:00:05.003. Kami menyarankan menggunakan Format 1. Catatan Anda harus menentukan salah satu Duration atau End. Jika Anda menentukan keduanya, End yang berlaku.
End	String	Tidak	Durasi segmen akhir yang dibuang selama pemotongan video. Format 1: sssss[.SSS]. Nilai yang valid: [0.000,86399.999]. Contoh: 12000.55. Format 2: hh:mm:ss[.SSS]. Nilai yang valid: [00:00:00.000,23:59:59.999]. Contoh: 00:00:05.003. Kami menyarankan menggunakan Format 1. Catatan Anda harus menentukan salah satu Duration atau End. Jika Anda menentukan keduanya, End yang berlaku. Durasi antara waktu mulai dan akhir tidak boleh melebihi durasi total video.

EncryptSetting: konfigurasi enkripsi transkoding

Catatan

Untuk menggunakan enkripsi standar HLS, terlebih dahulu atur parameter EncryptType dalam template transkoding ke AliyunVoDEncryption. Selanjutnya, panggil operasi Kirim pekerjaan transkoding media dan konfigurasikan parameter EncryptConfig.

Name

Type

Required

Description

EncryptType

String

Jenis enkripsi. Nilai yang valid:

AliyunVoDEncryption: enkripsi pribadi atau enkripsi standar HLS untuk video M3U8 (HLS).
AliyunVoDLicenseEncryption: enkripsi pribadi untuk video MP4.

Contoh parameter EncryptSetting

{
        "EncryptType":"AliyunVoDEncryption"
}

PackageSetting: konfigurasi pengemasan transkoding

Catatan

Aliran audio dan video yang diekstraksi tidak dapat dikemas.
Saat ini, hanya pengemasan streaming bitrate adaptif HLS yang didukung.

Name	Type	Required	Description
PackageType	String	Ya	Jenis pengemasan. Nilai yang valid: HLSPackage (pengemasan bitrate adaptif HLS).
PackageConfig	PackageConfig	Tidak	Konfigurasi pengemasan. Anda harus menentukan parameter ini untuk template VideoPackage.
SubtitleExtractConfigList	SubtitleExtractConfig[]	Tidak	Konfigurasi pengemasan subtitle. Anda harus menentukan parameter ini untuk template SubtitlePackage. Jangan tentukan untuk jenis template lain.

PackageConfig: konfigurasi pengemasan video

Catatan

Parameter ini hanya perlu diatur untuk pengemasan streaming bitrate adaptif HLS.

Name

Type

Required

Description

BandWidth

String

Bandwidth maksimum. Anda harus menentukan parameter ini untuk pengemasan HLS. Satuan: bps.

Anda hanya perlu menentukan parameter ini untuk template VideoPackage.

Contoh parameter PackageSetting

Template konfigurasi VideoPackage:
{
        "PackageType":"HLSPackage",
        "PackageConfig":{
                "BandWidth":"400000"
        }
}

SubtitleExtractConfig: konfigurasi pengemasan subtitle

Name	Type	Required	Description
SubtitleUrlList	String[]	Ya	URL file subtitle. Hanya URL OSS HTTP yang didukung. URL CDN HTTP dan URL HTTPS tidak didukung. Catatan Hanya satu URL HTTP yang didukung. File subtitle harus disimpan di bucket yang dialokasikan oleh ApsaraVideo VOD.
Language	String	Ya	Bahasa subtitle. Misalnya, en-US. Lihat RFC 5646 untuk informasi selengkapnya.
Format	String	Ya	Format file subtitle. Hanya file .vtt yang didukung. Misalnya: subtitle.vtt.
Name	String	Ya	Nama tampilan track subtitle di pemutar. Misalnya: Bahasa Tiongkok atau Bahasa Inggris.

Contoh parameter SubtitlePackage

Konfigurasi template SubtitlePackage:
 {
      "PackageType": "HLSPackage",
      "SubtitleExtractConfigList": [
        {
          "SubtitleUrlList": [
            "http://outin-40514****.oss-cn-shanghai.aliyuncs.com/subtitles/4bff3675-79a5-40fa-8c86-1f98169d****-eng.vtt"
          ],
          "Language": "en-US",
          "Format": "vtt",
          "Name": "English"
        },
        {
          "SubtitleUrlList": [
            "http://outin-40514****.oss-cn-shanghai.aliyuncs.com/subtitles/a3f50b08-11c3-4511-94cf-7fd4f7a5****-jpn.vtt"
          ],
          "Language": "ja",
          "Format": "vtt",
          "Name": "Japanese"
        },
        {
          "SubtitleUrlList": [
            "http://outin-40514****.oss-cn-shanghai.aliyuncs.com/subtitles/4dba87c2-a787-42cd-8328-2369aeb8****-cn.vtt"
          ],
          "Language": "cn",
          "Format": "vtt",
          "Name": "Chinese"
        }
      ]
    }

SubtitleConfig: konfigurasi subtitle

Name

Type

Required

Description

SubtitleUrl

String

URL OSS file subtitle. URL HTTPS dan nama domain CDN murni tidak didukung. Format subtitle yang didukung: srt dan ass.

Catatan

File subtitle dan file video sumber harus berada di wilayah yang sama (misalnya, China Timur 1) dan bucket yang sama.

CharEncode

String

Format pengkodean karakter. Nilai yang valid:

auto: deteksi otomatis.
UTF-8
GBK
BIG5

Nilai default: UTF-8.

Catatan

Untuk informasi selengkapnya tentang mengunggah file subtitle, lihat CreateUploadAttachedMedia dan Unggahan file OSS.

Contoh parameter SubtitleConfig

{
        "SubtitleUrl": "http://outin-40564284ef058b2d300163e1****.oss-cn-shanghai.aliyuncs.com/subtitles/c737f-14f1-4364-b107-d5f7f8ed****.ass",
        "CharEncode": "UTF-8"
}

Volume: konfigurasi volume

Name	Type	Required	Description
Method	String	Tidak	Metode penyesuaian volume. Nilai yang valid: auto, dynamic, linear.
IntegratedLoudnessTarget	String	Tidak	Tingkat kenyaringan target. Nilai yang valid: [-70,-5]. Wajib jika Method diatur ke dynamic. Nilai default: -6.
TruePeak	String	Tidak	Tingkat puncak maksimum. Nilai yang valid: [-9,0]. Wajib jika Method diatur ke dynamic. Nilai default: -1.
LoudnessRangeTarget	String	Tidak	Rentang kenyaringan. Nilai yang valid: [1,20]. Wajib jika Method diatur ke dynamic. Nilai default: 8.

Contoh parameter Volume

{
        "Method":"dynamic",
        "IntegratedLoudnessTarget":"-6",
        "TruePeak":"-1",
        "LoudnessRangeTarget":"8"
}

Kombinasi yang didukung format kontainer dan codec audio

Container	Audio Codecs
mp3	MP3
mp4	AAC
ogg	VORBIS, FLAC
flac	FLAC

Kombinasi yang didukung format kontainer, codec audio, dan codec video

Container	Video Codecs	Audio Codecs
flv	H.264	AAC, MP3
mp4	H.264, H.265	AAC, MP3
ts	H.264, H.265	AAC, MP3
m3u8	H.264, H.265	AAC, MP3
gif	GIF	Tidak didukung

Kombinasi yang didukung codec video dan parameter konfigurasi aliran video

Video Codecs	H.264	H.265	GIF
Profile	Didukung	×	×
Bitrate	Didukung	Didukung	×
Crf	Didukung	Didukung	×
Width	Didukung	Didukung	Didukung
Height	Didukung	Didukung	√
Fps	Didukung	Didukung	Didukung
Gop	Didukung	Didukung	×
Preset	√	×	×
ScanMode	Didukung	Didukung	Didukung
Bufsize	Didukung	Didukung	×
Maxrate	√	✓	×
PixFmt	Didukung	√	bgr8

TranscodeSummary: ringkasan transkoding

Name	Type	Description
VideoId	String	ID video.
TranscodeTemplateGroupId	String	ID kelompok template transkoding yang digunakan untuk transkoding.
TranscodeStatus	String	Status transkoding. Nilai yang valid: Processing: Sedang berlangsung. Partial: beberapa pekerjaan transkoding selesai. CompleteAllSucc: semua pekerjaan transkoding berhasil. CompleteAllFail: semua pekerjaan transkoding gagal. Jika video sumber memiliki masalah, tidak ada pekerjaan transkoding yang dimulai dan seluruh tugas gagal. CompletePartialSucc: semua pekerjaan transkoding selesai, tetapi hanya beberapa yang berhasil.
TranscodeJobInfoSummaryList	TranscodeJobInfoSummary[]	Daftar ringkasan pekerjaan transkoding.
CreationTime	String	Waktu pembuatan tugas transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
CompleteTime	String	Waktu penyelesaian tugas transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

TranscodeJobInfoSummary: ringkasan pekerjaan transkoding

Name	Type	Description
TranscodeTemplateId	String	ID template transkoding yang digunakan.
Width	String	Lebar video output. Satuan: piksel.
Height	String	Tinggi video output. Satuan: piksel.
Duration	String	Durasi video output. Satuan: detik.
Filesize	String	Ukuran file video output. Satuan: byte.
Bitrate	String	Bitrate rata-rata video output. Satuan: Kbps.
Fps	String	Laju frame video output. Satuan: frame per detik.
Format	String	Format kontainer video output.
WatermarkIdList	String[]	Daftar ID watermark yang diterapkan pada video output.
TranscodeProgress	Long	Kemajuan transkoding. Nilai yang valid: [0,100].
TranscodeJobStatus	String	Status pekerjaan transkoding. Nilai yang valid: Transcoding: pekerjaan sedang berjalan. TranscodeSuccess: pekerjaan berhasil. TranscodeFail: Transkoding gagal.
CreationTime	String	Waktu pembuatan pekerjaan transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
CompleteTime	String	Waktu penyelesaian pekerjaan transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
ErrorCode	String	Kode kesalahan yang dikembalikan jika pekerjaan transkoding gagal.
ErrorMessage	String	Pesan kesalahan yang dikembalikan jika pekerjaan transkoding gagal.

TranscodeTask: informasi tentang tugas transkoding

Name	Type	Description
TranscodeTaskId	String	ID tugas transkoding.
TranscodeTemplateGroupId	String	ID kelompok template transkoding yang digunakan untuk transkoding.
VideoId	String	ID video.
TaskStatus	String	Status tugas transkoding. Nilai yang valid: Processing: Sedang berlangsung. Partial: beberapa pekerjaan transkoding selesai. CompleteAllSucc: Semua tugas transkoding selesai berhasil. CompleteAllFail: semua pekerjaan transkoding gagal. Jika video sumber memiliki masalah, tidak ada pekerjaan transkoding yang dimulai dan seluruh tugas gagal. CompletePartialSucc: semua pekerjaan transkoding selesai, tetapi hanya beberapa yang berhasil.
CreationTime	String	Waktu pembuatan tugas transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
CompleteTime	String	Waktu penyelesaian tugas transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
Trigger	String	Jenis pemicu. Nilai yang valid: Auto: transkoding dipicu secara otomatis setelah video diunggah. Manual: transkoding dipicu dengan memanggil operasi SubmitTranscodeJobs.
TranscodeJobInfoList	TranscodeJobInfo	Informasi tentang pekerjaan transkoding.

TranscodeJobInfo: informasi tentang pekerjaan transkoding

Name	Type	Description
TranscodeTaskId	String	ID tugas transkoding.
TranscodeJobId	String	ID pekerjaan transkoding.
VideoId	String	ID video.
TranscodeProgress	Long	Kemajuan pekerjaan transkoding. Nilai yang valid: [0,100].
TranscodeJobStatus	String	Status pekerjaan transkoding. Nilai yang valid: Transcoding: pekerjaan sedang berjalan. TranscodeSuccess: pekerjaan berhasil. TranscodeFail: pekerjaan gagal.
Priority	String	Prioritas tugas transkoding.
Definition	String	Definisi. Catatan Nilai ini adalah tag definisi yang dikonfigurasi dalam template transkoding. Tidak merepresentasikan rentang resolusi aktual video output.
TranscodeTemplateId	String	ID template transkoding yang digunakan untuk transkoding.
CreationTime	String	Waktu pembuatan pekerjaan transkoding.
CompleteTime	String	Waktu penyelesaian pekerjaan transkoding.
InputFileUrl	String	URL OSS file sumber.
OutputFile	OutputFile	Informasi tentang file output.
ErrorCode	String	Kode kesalahan yang dikembalikan jika pekerjaan transkoding gagal.
ErrorMessage	String	Pesan kesalahan yang dikembalikan jika pekerjaan transkoding gagal.

OutputFile: file output setelah transkoding

Name	Type	Description
OutputFileUrl	String	URL OSS file output.
Format	String	Format kontainer file output.
Width	String	Lebar video dalam file output. Satuan: piksel.
Height	String	Tinggi video dalam file output. Satuan: piksel.
Duration	String	Durasi file output. Satuan: detik.
Bitrate	String	Bitrate rata-rata file output. Satuan: Kbps.
Fps	String	Laju frame file output. Satuan: frame per detik.
Filesize	Long	Ukuran file output. Satuan: byte.
EncryptType	String	Jenis enkripsi yang digunakan untuk file output. Nilainya adalah string JSON.
WatermarkIdList	String	Daftar ID watermark yang diterapkan pada file output.
VideoStreamList	String	Daftar aliran video. Untuk informasi selengkapnya, lihat VideoStream: informasi aliran video.
AudioStreamList	String	Daftar aliran audio. Untuk informasi selengkapnya, lihat AudioStream: informasi aliran audio.

Statistik data

TopPlayVideoStatis: Statistik pemutaran video harian teratas

Name	Type	Description
VideoId	String	ID video.
PlayDuration	String	Durasi pemutaran dalam milidetik.
Title	String	Judul video.
VV	String	Jumlah tayangan video.
UV	String	Jumlah pengguna yang memutar konten.

VideoPlayStatisDetail: Statistik pemutaran harian untuk video tertentu

Name	Type	Description
Date	String	Tanggal dalam format yyyyMMdd. Contoh: 20170120.
PlayDuration	String	Durasi pemutaran dalam milidetik.
Title	String	Judul video.
VV	String	Jumlah tayangan video.
UV	String	Jumlah pengguna pemutar.
PlayRange	String	Distribusi durasi pemutaran.

UserPlayStatisTotals: Statistik total harian pemutaran pengguna

Name	Type	Description
Date	String	Tanggal dalam format yyyyMMdd. Contoh: 20170120.
PlayDuration	String	Total durasi pemutaran dalam milidetik.
PlayRange	String	Distribusi durasi pemutaran.
VV	VV	Total jumlah tayangan video.
UV	UV	Total jumlah pengguna yang telah memutar konten.

UserPlayStatisAvgs: Rata-rata statistik pemutaran pengguna harian

Name	Type	Description
Date	String	Tanggal dalam format yyyyMMdd. Contoh: 20170120.
AvgPlayDuration	String	Rata-rata durasi pemutaran dalam milidetik.
AvgPlayCount	String	Rata-rata jumlah tayangan video.

Distribusi VV

Statistik hanya dikumpulkan untuk pemutaran yang menggunakan SDK Pemutar Video on Demand Alibaba Cloud.

Name	Type	Description
Android	String	Total jumlah tayangan video dari pemutar untuk Android.
iOS	String	Total jumlah tayangan video dari pemutar untuk iOS.
Flash	String	Total jumlah sesi pemutaran oleh pemutar Flash.
HTML5	String	Total jumlah tayangan video dari pemutar untuk HTML5.

Distribusi UV Jumlah Pemutaran

Statistik hanya dikumpulkan untuk pemutaran yang menggunakan SDK Pemutar Video on Demand Alibaba Cloud.

Name	Type	Description
Android	String	Total jumlah pengunjung unik dari pemutar untuk Android.
iOS	String	Total jumlah pengguna yang melakukan pemutaran pada pemutar iOS.
Flash	String	Total pengguna pemutaran pada Pemutar Flash
HTML5	String	Total jumlah pengguna untuk pemutaran HTML5.

Notifikasi event

MessageCallback: Konfigurasi notifikasi event

Name	Type	Description
CallbackType	String	Metode callback. Nilai yang valid: HTTP dan MNS.
CallbackURL	String	Alamat webhook untuk callback HTTP.
MnsEndpoint	String	Titik akhir publik antrian MNS untuk callback MNS.
MnsQueueName	String	Nama antrian MNS untuk callback MNS.
EventTypeList	String	Jenis event callback.
AuthSwitch	String	Saklar autentikasi untuk callback HTTP. Nilai yang valid: On: aktifkan. off: Dinonaktifkan.
AuthKey	String	Kunci autentikasi untuk callback HTTP.

Sistem multi-aplikasi

AppInfo: informasi aplikasi

Name	Type	Description
AppId	String	ID aplikasi.
AppName	String	Nama aplikasi.
Description	String	Deskripsi aplikasi.
Type	String	Jenis aplikasi. Nilai yang valid: Sistem diatur ke default. Custom: Dibuat pengguna.
Status	String	Status aplikasi. Nilai yang valid: Normal: Normal. Disable: Aplikasi dinonaktifkan.
CreationTime	String	Waktu pembuatan UTC.
ModificationTime	String	Waktu pembaruan UTC.

AppPolicy: informasi kebijakan otorisasi aplikasi

Name	Type	Description
AppId	String	ID aplikasi.
PolicyType	String	Jenis kebijakan. Nilai yang valid: System: Kebijakan sistem. Custom: Kebijakan yang ditentukan pengguna.
PolicyName	String	Nama kebijakan.
CreationTime	String	Waktu pembuatan UTC.
Description	String	Deskripsi kebijakan.