Topik ini menjelaskan tipe data dari operasi API yang terkait dengan pengeditan daring di ApsaraVideo VOD.
EditingProject: informasi tentang proyek pengeditan daring
Parameter | Tipe | Deskripsi |
ProjectId | String | ID proyek pengeditan daring. |
Title | String | Judul proyek pengeditan daring. |
CreationTime | String | Waktu ketika proyek pengeditan daring dibuat. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC. Sebagai contoh, nilai 2017-01-11T12:00:00Z menunjukkan pukul 20:00:00 pada tanggal 11 Januari 2017. |
ModifiedTime | String | Waktu terakhir proyek pengeditan daring dimodifikasi. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC. Sebagai contoh, nilai 2017-01-11T12:00:00Z menunjukkan pukul 20:00:00 pada tanggal 11 Januari 2017. |
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 proyek pengeditan daring. Durasi harus sama dengan durasi timeline. |
CoverURL | String | URL gambar mini proyek pengeditan daring. |
Timeline: informasi tentang timeline proyek pengeditan daring
Parameter | Tipe | Deskripsi |
Id | String | ID proyek pengeditan daring. |
Title | String | Judul proyek pengeditan daring. |
CreationTime | String | Waktu ketika timeline dibuat. |
ModifiedTime | String | Waktu terakhir timeline dimodifikasi. |
Duration | Float | Total durasi timeline. Unit: detik. Nilai akurat hingga empat tempat desimal. |
CurrentRuler | Float | Ukuran penggaris timeline. Parameter ini opsional jika timeline hanya digunakan untuk produksi video. |
CurrentPosition | Float | Posisi saat ini dari playhead untuk proyek pengeditan daring. Unit: detik. Nilai akurat hingga empat tempat desimal. Parameter ini opsional jika timeline hanya digunakan untuk produksi video. |
VideoTracks | Jejak video. |
VideoTrack: informasi tentang jejak video
Parameter | Tipe | Deskripsi |
Count | Int | Total jumlah klip video. |
Duration | String | Total durasi jejak video. |
VideoTrackClips | Klip video. |
VideoTrackClip: informasi tentang klip video
Parameter | Tipe | Deskripsi |
Id | String | ID klip video. Parameter ini opsional jika timeline hanya digunakan untuk produksi video. Jika timeline digunakan untuk mengedit data, Anda harus menetapkan parameter ini ke nilai unik dalam timeline. |
VideoId | String | ID video klip. |
Type | String | Tipe klip. Nilai valid:
Nilai default: Video. |
Title | String | Judul klip video. Judul harus sama dengan judul video. |
Index | Int | Nomor urutan klip video dalam timeline. Nomor urutan dimulai dari nol. |
CutFlag | Boolean | Menentukan apakah klip video dipotong. Nilai valid: true dan false. Parameter ini opsional jika timeline hanya digunakan untuk produksi video. |
TextFlag | Boolean | Menentukan apakah teks spanduk ditambahkan ke klip video. Nilai valid: true dan false. Parameter ini opsional jika timeline hanya digunakan untuk produksi video. |
DeWatermarkFlag | Boolean | Menentukan apakah sebagian klip video ditutupi. Nilai valid: true dan false. Parameter ini opsional jika timeline hanya digunakan untuk produksi video. |
URL | String | URL aliran yang digunakan untuk mengedit klip video. Parameter ini opsional jika timeline hanya digunakan untuk produksi video. |
CoverURL | String | URL gambar mini klip video. Secara default, URL gambar mini ini sama dengan URL gambar mini video. Parameter ini opsional jika timeline hanya digunakan untuk produksi video. |
SpriteURLs | String | URL snapshot sprite klip video. Pisahkan beberapa URL dengan koma (,). Parameter ini opsional jika timeline hanya digunakan untuk produksi video. |
Width | Int | Lebar aliran dari mana klip video diedit. Unit: piksel. Parameter ini opsional jika timeline hanya digunakan untuk produksi video tanpa efek khusus, seperti teks spanduk dan masker. |
Height | Int | Tinggi aliran dari mana klip video diedit. Unit: piksel. Parameter ini opsional jika timeline hanya digunakan untuk produksi video tanpa efek khusus, seperti teks spanduk dan masker. |
Fps | Float | Laju frame klip video. Parameter ini opsional jika timeline hanya digunakan untuk produksi video. |
Bitrate | Float | Bitrate aliran dari mana klip video diedit. Parameter ini opsional jika timeline hanya digunakan untuk produksi video. |
In | Float | Waktu mulai klip video dalam video. Unit: detik. Nilai akurat hingga empat tempat desimal. |
Out | Float | Waktu berakhir klip video dalam video. Unit: detik. Nilai akurat hingga empat tempat desimal. |
Duration | Float | Durasi klip video. Unit: detik. Nilai akurat hingga empat tempat desimal. |
VirginDuration | Float | Total durasi video tempat klip video tersebut milik. Unit: detik. Nilai akurat hingga empat tempat desimal. Parameter ini opsional jika timeline hanya digunakan untuk produksi video. |
TimelineIn | Float | Waktu mulai klip video dalam timeline. Unit: detik. Nilai akurat hingga empat tempat desimal. |
TimelineOut | Float | Waktu berakhir klip video dalam timeline. Unit: detik. Nilai akurat hingga empat tempat desimal. |
Effects | Effect[] | Efek yang ditambahkan ke klip video. |
Effect: informasi tentang efek
Parameter | Tipe | Deskripsi |
Type | String | Tipe efek. Nilai valid:
|
Name | String | Nama efek. |
SubType | String | Subtipe efek. Jika parameter Type disetel ke DeWatermark, parameter ini disetel ke Delogo_Blur. |
In | Float | Waktu mulai efek yang ditambahkan ke klip video. Unit: detik. Nilai akurat hingga empat tempat desimal. |
Out | Float | Waktu berakhir efek yang ditambahkan ke klip video. Unit: detik. Nilai akurat hingga empat tempat desimal. |
TimelineIn | Float | Waktu mulai efek dalam timeline. Unit: detik. Nilai akurat hingga empat tempat desimal. |
TimelineOut | Float | Waktu berakhir efek dalam timeline. Unit: detik. Nilai akurat hingga empat tempat desimal. |
X | String | Koordinat X efek. Sudut kiri atas gambar video digunakan sebagai titik asal koordinat. Nilainya bisa berupa bilangan bulat atau desimal.
|
Y | String | Koordinat Y efek. Sudut kiri atas gambar video digunakan sebagai titik asal koordinat. Nilainya bisa berupa bilangan bulat atau desimal.
|
Width | Int | Lebar area tempat efek ditambahkan. Nilainya bisa berupa bilangan bulat atau desimal.
|
Height | Int | Tinggi area tempat efek ditambahkan. Nilainya bisa berupa bilangan bulat atau desimal.
|
FEWidth | Float | Lebar tampilan gambar video selama pengeditan. Unit: piksel. |
FEHeight | Float | Tinggi tampilan gambar video selama pengeditan. Unit: piksel. |
Font | String | Jenis font. Atur nilainya menjadi SimSun. |
FontFace | Penampilan font. | |
FontColor | String | Warna font. Nilainya harus dimulai dengan tanda pagar (#) dalam format heksadesimal. Contoh: #ffffff. |
FontSize | Int | Ukuran font. |
FontColorOpacity | Float | Transparansi font. Nilai valid: 0 hingga 1. 1 menunjukkan bahwa font tidak transparan dan 0 menunjukkan bahwa font sepenuhnya transparan. |
Content | String | Isi teks spanduk. |
FontFace: gaya font
Parameter | Tipe | Deskripsi |
Bold | Boolean | Menunjukkan apakah font tebal. |
Italic | Boolean | Menunjukkan apakah font miring. |
Underline | Boolean | Menunjukkan apakah font bergaris bawah. |
MediaMetadata: metadata sumber daya media
Parameter | Tipe | Deskripsi |
Title | String | Judul video yang diproduksi. Panjang nilai bisa mencapai 128 byte dan harus dikodekan dalam UTF-8. |
Description | String | Deskripsi video yang diproduksi. Panjang nilai bisa mencapai 1.024 byte dan harus dikodekan dalam UTF-8. |
CoverURL | String | URL thumbnail kustom untuk video yang diproduksi. |
CateId | String | ID kategori video yang diproduksi. Lakukan operasi berikut untuk memodifikasi atau melihat ID kategori: Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Configuration Management > Media Management > Categories. |
Tags | String | Tag video yang diproduksi. Setiap nama tag bisa memiliki panjang hingga 32 byte. Anda dapat menentukan maksimum 16 tag. Pisahkan beberapa tag dengan koma (,). String harus dikodekan dalam format UTF-8. |
ProduceConfig: konfigurasi produksi video
Parameter | Tipe | Deskripsi |
TemplateGroupId | String | ID kelompok template transkoding yang digunakan untuk mentranskode video yang diproduksi. File video yang diproduksi digunakan sebagai file sumber untuk transkoding. Proses transkoding serupa dengan proses yang dilakukan setelah file diunggah. Parameter ini opsional. Jika Anda mengosongkan parameter ini, kelompok template default digunakan untuk transkoding. Jika Anda menentukan parameter ini, kelompok template yang ditentukan digunakan untuk transkoding. Untuk melihat ID kelompok template, buka halaman Kelompok Template Transkoding di konsol ApsaraVideo VOD. |
TemplateId | String | ID template yang digunakan untuk produksi video. File media yang diproduksi digunakan sebagai file sumber dari sumber daya media. Parameter ini opsional. Jika Anda mengosongkan parameter ini, ApsaraVideo VOD menggunakan template pengeditan daring bawaan untuk produksi video. Jika file video diproduksi, format encoding template bawaan adalah H.264, dan format kontainer adalah MP4. Jika Anda ingin membuat parameter khusus untuk produksi video, ajukan permintaan di Yida. Sebagai contoh, jika Anda ingin memproduksi stiker animasi, secara cerdas memproduksi subtitle, mengedit video berdasarkan daftar putar M3U8, atau menggunakan parameter produksi kustom, ajukan permintaan di Yida untuk mendapatkan template tertentu. |
Width | Integer | Lebar video yang diproduksi. Unit: piksel. Parameter ini opsional. Lebar default adalah lebar maksimum file sumber klip video yang digunakan dalam timeline. Sebagai contoh, tiga klip video digunakan dalam timeline. Resolusi file sumber mereka adalah 1280 × 720 piksel, 1920 × 1080 piksel, dan 720 × 1280 piksel. Dalam kasus ini, resolusi keluaran video yang diproduksi adalah 1920 × 1280 piksel. |
Height | Integer | Tinggi video yang diproduksi. Unit: piksel. Parameter ini opsional. Lebar default adalah lebar maksimum file sumber klip video yang digunakan dalam timeline. Sebagai contoh, tiga klip video digunakan dalam timeline. Resolusi file sumber mereka adalah 1280 × 720 piksel, 1920 × 1080 piksel, dan 720 × 1280 piksel. Dalam kasus ini, resolusi keluaran video yang diproduksi adalah 1920 × 1280 piksel. |
StorageLocation | String | Lokasi penyimpanan file yang diproduksi. Parameter ini diperlukan jika file yang diproduksi disimpan di wilayah selain Tiongkok (Shanghai). |
Material: informasi tentang materi untuk proyek pengeditan daring
Materi untuk proyek pengeditan daring dapat berupa materi dari aset media atau video di perpustakaan media.
Parameter | Tipe | Deskripsi |
MaterialId | String | ID materi. |
Title | String | Judul materi. |
Description | String | Deskripsi materi. |
Duration | Float | Durasi materi. Unit: detik. Nilai akurat hingga empat tempat desimal. |
CoverURL | String | URL gambar mini materi. |
Status | String | Status materi. |
CreationTime | String | Waktu ketika materi dibuat. Waktu ditampilkan dalam UTC. |
Size | Long | Ukuran file sumber. Unit: byte. |
CateId | Long | ID kategori materi. |
CateName | String | Nama kategori materi. |
Tags | String | Tag materi. Beberapa tag dipisahkan dengan koma (,). |
Snapshots | String[] | URL snapshot materi. Nilainya adalah array. |
Sprites | String[] | URL snapshot sprite materi. Nilainya adalah array. |
ProjectStatus: status proyek pengeditan daring
Nilai Valid | Deskripsi | Keterangan |
Normal | Proyek pengeditan daring dalam status draf. | Ini adalah status awal proyek pengeditan daring. |
Producing | Produksi video sedang dilakukan. | Tidak ada. |
Produced | Produksi video berhasil. | Tidak ada. |
ProduceFaile | Video gagal diproduksi. | Tidak ada. |