全部产品
Search
文档中心

ApsaraVideo VOD:Pengeditan data daring - editor lama

更新时间:Jun 21, 2025

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

VideoTrack[]

Jejak video.

VideoTrack: informasi tentang jejak video

Parameter

Tipe

Deskripsi

Count

Int

Total jumlah klip video.

Duration

String

Total durasi jejak video.

VideoTrackClips

VideoTrackClip[]

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:

  • Video

  • Gambar

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:

  • Text: Menambahkan teks spanduk ke klip video.

  • DeWatermark: Menutupi bagian tertentu dari klip video.

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.

  • Jika nilainya adalah bilangan bulat, rentang nilainya adalah 8 hingga 4096. Unit: piksel.

  • Jika nilainya adalah bilangan desimal, rentang nilainya adalah antara 0 dan 1 dan menunjukkan rasio lebar area efek terhadap lebar video keluaran. Bilangan desimal dapat akurat hingga 4 tempat desimal, seperti 0.9999. Digit berlebih akan otomatis dihapus.

Y

String

Koordinat Y efek. Sudut kiri atas gambar video digunakan sebagai titik asal koordinat. Nilainya bisa berupa bilangan bulat atau desimal.

  • Jika nilainya adalah bilangan bulat, rentang nilainya adalah 8 hingga 4096. Unit: piksel.

  • Jika nilainya adalah bilangan desimal, rentang nilainya adalah antara 0 dan 1 dan menunjukkan rasio tinggi area efek terhadap tinggi video keluaran. Bilangan desimal dapat akurat hingga 4 tempat desimal, seperti 0.9999. Digit berlebih akan otomatis dihapus.

Width

Int

Lebar area tempat efek ditambahkan. Nilainya bisa berupa bilangan bulat atau desimal.

  • Jika nilainya adalah bilangan bulat, rentang nilainya adalah 8 hingga 4096. Unit: piksel.

  • Jika nilainya adalah bilangan desimal, rentang nilainya adalah antara 0 dan 1 dan menunjukkan rasio lebar area efek terhadap lebar video keluaran. Bilangan desimal dapat akurat hingga 4 tempat desimal, seperti 0.9999. Digit berlebih akan otomatis dihapus.

Height

Int

Tinggi area tempat efek ditambahkan. Nilainya bisa berupa bilangan bulat atau desimal.

  • Jika nilainya adalah bilangan bulat, rentang nilainya adalah 8 hingga 4096. Unit: piksel.

  • Jika nilainya adalah bilangan desimal, rentang nilainya adalah antara 0 dan 1 dan menunjukkan rasio tinggi area efek terhadap tinggi video keluaran. Bilangan desimal dapat akurat hingga 4 tempat desimal, seperti 0.9999. Digit berlebih akan otomatis dihapus.

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

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

null

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.