全部产品
Search
文档中心

ApsaraVideo VOD:Konfigurasi efek

更新时间:Jun 21, 2025

Struktur parameter Efek berbeda-beda tergantung pada jenis efek. Bagian ini menjelaskan struktur parameter Efek.

Teks spanduk

Untuk detail lebih lanjut tentang contoh timeline, lihat Tumpang tindih teks.

Parameter

Tipe

Diperlukan

Deskripsi

X

Float

Tidak

Jarak horizontal antara sudut kiri atas teks dan sudut kiri atas video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. Nilai default: 0. Koordinat diskalakan berdasarkan ukuran sumber dan video keluaran.

Y

Float

Tidak

Jarak vertikal antara sudut kiri atas teks dan sudut kiri atas video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. Nilai default: 0. Koordinat diskalakan berdasarkan ukuran sumber dan video keluaran.

TimelineIn

Float

Tidak

Waktu saat teks ditampilkan dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika parameter ini tidak ditentukan, nilai TimelineIn klip digunakan.

TimelineOut

Float

Tidak

Waktu saat teks berhenti ditampilkan dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika parameter ini tidak ditentukan, nilai TimelineOut klip digunakan.

Content

String

Ya

Isi teks spanduk.

Font

String

Tidak

Font teks spanduk. Nilai default: SimSun.

Untuk informasi lebih lanjut tentang font yang didukung, lihat Font.

FontSize

Int

Ya

Ukuran font teks spanduk. Ukuran font diskalakan berdasarkan ukuran materi dan video keluaran.

null

Anda dapat menentukan FontSize atau FixedFontSize. Jika Anda menentukan FontSize dan FixedFontSize, hanya FontSize yang berlaku.

FixedFontSize

Int

Ya

Ukuran font teks spanduk. Ukuran font tidak diskalakan berdasarkan ukuran materi dan video keluaran.

null

Anda dapat menentukan FontSize atau FixedFontSize. Jika Anda menentukan FontSize dan FixedFontSize, hanya FontSize yang berlaku.

FixedX

Float

Tidak

Jarak horizontal antara sudut kiri atas teks dan sudut kiri atas video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. Nilai default: 0. Koordinat tidak diskalakan berdasarkan ukuran materi dan video keluaran.

FixedY

Float

Tidak

Jarak horizontal antara sudut kiri atas teks dan sudut kiri atas video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. Nilai default: 0. Koordinat tidak diskalakan berdasarkan ukuran materi dan video keluaran.

FontColor

String

Tidak

Warna teks dalam format heksadesimal. Nilai dimulai dengan tanda pagar (#).

Contoh: #ffffff.

FontColorOpacity

String

Tidak

Transparansi teks spanduk. Nilai valid: 0 hingga 1. 1 menunjukkan bahwa teks tidak transparan dan 0 menunjukkan bahwa teks sepenuhnya transparan. Nilai default: 1.

FontFace

FontFace

Tidak

Penampilan teks spanduk.

Spacing

Integer

Tidak

Jarak kata teks spanduk. Satuan: piksel. Nilai default: 0.

Angle

Float

Tidak

Sudut rotasi teks spanduk dalam arah berlawanan jarum jam. Satuan: derajat. Nilai default: 0.

BorderStyle

Int

Tidak

Gaya batas teks spanduk. Nilai valid: 1 dan 3. 1 menunjukkan bahwa teks memiliki batas dan bayangan dan 3 menunjukkan bahwa teks memiliki latar belakang. Nilai default: 1.

Outline

Int

Tidak

Lebar stroke teks spanduk. Satuan: piksel. Nilai default: 0.

OutlineColour

String

Tidak

Warna stroke teks spanduk dalam format heksadesimal. Nilai dimulai dengan tanda pagar (#). Contoh: #ffffff.

Shadow

Int

Tidak

Ukuran bayangan teks spanduk. Satuan: piksel. Nilai default: 0.

BackColour

String

Tidak

Warna bayangan teks spanduk dalam format heksadesimal. Nilai dimulai dengan tanda pagar (#). Contoh: #ffffff.

Alignment

String

Tidak

Lokasi teks spanduk. Nilai default: TopLeft. Nilai valid:

  • TopLeft

  • TopCenter

  • TopRight

  • CenterLeft

  • CenterCenter

  • CenterRight

  • BottomLeft

  • BottomCenter

  • BottomRight

AdaptMode

String

Tidak

Menunjukkan apakah akan mengaktifkan pemutusan baris otomatis atau penskalaan otomatis ketika lebar teks spanduk melebihi lebar video atau TextWidth yang ditentukan. Nilai valid:

  • AutoWrap: mengaktifkan pemutusan baris otomatis

  • AutoScale: mengaktifkan penskalaan otomatis

  • AutoWrapAtSpaces: secara otomatis membungkus teks menggunakan spasi putih hanya ketika teks ditampilkan dalam bahasa Inggris.

TextWidth

String

Tidak

Lebar kotak teks. Parameter ini berlaku ketika AdaptMode ditentukan. Parameter ini digunakan ketika Anda mengaktifkan pemutusan baris otomatis atau penskalaan otomatis. Jika parameter ini tidak ditentukan, pemutusan baris otomatis atau penskalaan otomatis dilakukan berdasarkan lebar video. Satuan: piksel.

FontUrl

String

Tidak

URL file font di Object Storage Service (OSS). Format file font berikut didukung: ttf, otf, dan woff.

Contoh: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf.

EffectColorStyle

String

Tidak

Efek seni kata teks spanduk.

Untuk informasi lebih lanjut tentang efek seni kata, lihat Contoh efek seni kata.

AaiMotionInEffect

String

Tidak

Efek masuk teks spanduk.

Untuk informasi lebih lanjut tentang efek masuk, lihat Efek masuk.

AaiMotionIn

Float

Tidak

Durasi efek masuk. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika AaiMotionIn tidak ditentukan, nilai default parameter ini adalah 0,5 detik. Jika teks spanduk ditampilkan kurang dari 0,5 detik, durasi efek masuk adalah durasi total teks spanduk dikurangi durasi efek keluar.

AaiMotionOutEffect

String

Tidak

Efek keluar teks spanduk.

Untuk informasi lebih lanjut tentang efek keluar, lihat Efek keluar.

AaiMotionOut

Float

Tidak

Durasi efek keluar. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika AaiMotionOut tidak ditentukan, nilai default parameter ini adalah 0,5 detik. Jika teks spanduk ditampilkan kurang dari 0,5 detik, durasi efek keluar adalah durasi total teks spanduk.

AaiMotionLoopEffect

String

Tidak

Efek loop teks spanduk. Efek loop tidak dapat berlaku bersamaan dengan efek masuk atau efek keluar.

Untuk informasi lebih lanjut tentang efek loop, lihat Efek loop.

Ratio

Float

Tidak

Kecepatan efek loop. Nilai akurat hingga empat tempat desimal. Jika parameter ini tidak ditentukan, nilai defaultnya adalah 1. Nilai lebih besar dari 1 menunjukkan kecepatan loop lebih tinggi dan nilai kurang dari 1 menunjukkan kecepatan loop lebih lambat.

Masking

Parameter

Tipe

Diperlukan

Deskripsi

X

Float

Tidak

Jarak horizontal antara sudut kiri atas area buram dan sudut kiri atas video keluaran. Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. Nilai default: 0.

Y

Float

Tidak

Jarak vertikal antara sudut kiri atas area buram dan sudut kiri atas video keluaran. Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. Nilai default: 0.

Width

Float

Ya

Lebar area buram dalam video keluaran. Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

Height

Float

Ya

Tinggi area buram dalam video keluaran. Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

TimelineIn

Float

Tidak

Waktu saat area diburamkan dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika parameter ini tidak ditentukan, nilai TimelineIn klip digunakan.

TimelineOut

Float

Tidak

Waktu saat area berhenti diburamkan dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika parameter ini tidak ditentukan, nilai TimelineOut klip digunakan.

Pemotongan

Untuk informasi lebih lanjut mengenai contoh timeline, lihat Hapus batang hitam.

Parameter

Tipe

Diperlukan

Deskripsi

X

Float

Tidak

Jarak horizontal antara sudut kiri atas gambar video setelah dipotong dan sudut kiri atas video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. Nilai default: 0.

Y

Float

Tidak

Jarak vertikal antara sudut kiri atas gambar video setelah dipotong dan sudut kiri atas video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. Nilai default: 0.

Lebar

Float

Ya

Lebar gambar video dalam video keluaran setelah pemotongan.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

Tinggi

Float

Ya

Tinggi gambar video dalam video keluaran setelah pemotongan.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

Penskalaan

Untuk detail lebih lanjut tentang contoh timeline, lihat Konfigurasi picture-in-picture.

null

Jika lebar atau tinggi materi berbeda dari lebar atau tinggi video keluaran dan penskalaan tidak dikonfigurasi, sistem secara otomatis akan menyesuaikan lebar atau tinggi materi ke dimensi video, memusatkan materi, serta menambahkan batang hitam untuk mengisi tampilan.

Parameter

Tipe

Diperlukan

Deskripsi

Width

Float

Ya

Lebar gambar video dalam video keluaran setelah penskalaan.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 1, nilai tersebut menunjukkan jumlah piksel.

Height

Float

Ya

Tinggi gambar video dalam video keluaran setelah penskalaan.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 1, nilai tersebut menunjukkan jumlah piksel.

Pengisian

null

Jika rasio aspek materi berbeda dari rasio aspek video keluaran dan pengisian tidak dikonfigurasi, sistem secara otomatis akan menyesuaikan lebar atau tinggi materi ke dimensi video, memusatkan materi, serta menambahkan pengisian untuk mengisi tampilan.

Parameter

Tipe

Diperlukan

Deskripsi

Left

Float

Tidak

Jarak antara sisi kiri materi dan sisi kiri video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 1, nilai tersebut menunjukkan jumlah piksel.

Right

Float

Tidak

Jarak antara sisi kanan materi dan sisi kanan video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 1, nilai tersebut menunjukkan jumlah piksel.

Top

Float

Tidak

Jarak antara bagian atas materi dan bagian atas video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 1, nilai tersebut menunjukkan jumlah piksel.

Bottom

Float

Tidak

Jarak antara bagian bawah materi dan bagian bawah video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 1, nilai tersebut menunjukkan jumlah piksel.

Color

String

Tidak

Warna pengisian dalam format heksadesimal. Nilai harus dimulai dengan tanda pagar (#). Contoh: #000000. Warna default adalah hitam.

Pengaturan latar belakang

Jika ukuran materi tidak sesuai dengan ukuran video keluaran, Anda dapat memilih untuk memburamkan area kosong atau mengisi area kosong dengan warna tertentu.

Pengaturan latar belakang dapat digunakan bersama dengan efek seperti pemotongan, penskalaan, dan transisi.

Parameter

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

Tipe pengaturan latar belakang. Nilai valid:

Blur

Color

Radius

Float

Tidak

Radius buram. Parameter ini berlaku hanya ketika SubType diatur ke Blur. Nilai valid: [0,01,1].

Color

String

Tidak

Nilai warna RGB dalam format heksadesimal. Parameter ini berlaku hanya ketika SubType diatur ke Color.

Contoh: #FFFFFF.

Transisi

Efek transisi menghubungkan dua materi. Anda hanya perlu menentukan durasi transisi untuk materi sebelumnya. Efek transisi kemudian menghubungkan akhir materi sebelumnya dan awal materi berikutnya dengan menumpuk gambar video. Setelah menambahkan efek transisi di antara dua materi, durasi total materi akan dipersingkat sesuai dengan durasi efek transisi.

Sebagai contoh, jika trek video memiliki dua materi—Klip 1 dengan durasi 10 detik dan Klip 2 dengan durasi 8 detik—dan Anda menambahkan efek transisi 4 detik di antara keduanya, maka durasi total trek video akan berkurang dari 18 detik menjadi 14 detik.

Parameter

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

Tipe efek transisi. Anda dapat menentukan beberapa efek transisi dan memisahkannya dengan koma (,). Kemudian sistem secara acak memilih salah satu efek transisi. Atau, Anda dapat menentukan random untuk membiarkan sistem secara acak memilih efek transisi dari semua efek transisi. Untuk informasi lebih lanjut tentang nilai valid dan efek, lihat Contoh efek transisi.

Contoh: directional.

Duration

Float

Tidak

Durasi efek transisi. Satuan: detik. Nilai akurat hingga empat tempat desimal. Nilai default: 1.

Efek visual

Parameter

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

Tipe efek visual. Anda dapat menentukan beberapa efek visual dan memisahkannya dengan koma (,). Kemudian sistem secara acak memilih salah satu efek visual. Atau, Anda dapat menentukan random untuk membiarkan sistem secara acak memilih efek visual dari semua efek visual. Untuk informasi lebih lanjut tentang nilai valid dan efek, lihat Contoh efek khusus.

Contoh: colorfulradial.

X

Float

Tidak

Parameter ini berlaku hanya ketika SubType diatur ke mosaic_rect/blur. Jarak horizontal antara sudut kiri atas area efek visual dan sudut kiri atas video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

Y

Float

Tidak

Parameter ini berlaku hanya ketika SubType diatur ke mosaic_rect/blur.

Jarak vertikal antara sudut kiri atas area efek visual dan sudut kiri atas video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

Width

Float

Tidak

Parameter ini berlaku hanya ketika SubType diatur ke mosaic_rect/blur. Lebar area efek visual dalam video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

Height

Float

Tidak

Parameter ini berlaku hanya ketika SubType diatur ke mosaic_rect/blur. Tinggi area efek visual dalam video keluaran.

Anda dapat menetapkan nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilai adalah bilangan bulat lebih besar dari atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

Filter

Parameter

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

Tipe filter. Anda dapat menentukan beberapa filter dan memisahkannya dengan koma (,). Kemudian sistem secara acak memilih salah satu filter. Atau, Anda dapat menentukan random untuk membiarkan sistem secara acak memilih filter dari semua filter. Untuk informasi lebih lanjut tentang nilai valid dan efek, lihat Contoh efek filter.

Contoh: M1.

TimelineIn

Float

Tidak

Waktu saat filter diterapkan dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika parameter ini tidak ditentukan, nilai TimelineIn klip digunakan.

TimelineOut

Float

Tidak

Waktu saat filter diangkat dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika parameter ini tidak ditentukan, nilai TimelineOut klip digunakan.

ExtParams

String

Tidak

Parameter terkait filter. Parameter ini berlaku hanya ketika SubType diatur ke color. Dalam hal ini, filter penyesuaian warna diterapkan. Untuk informasi lebih lanjut tentang konfigurasi ExtParams, lihat ExtParams.

ExtParams

Untuk informasi lebih lanjut tentang contoh timeline, lihat Gunakan filter rendering.

Parameter

Tipe

Nilai valid

Deskripsi

Nilai default

brightness

int

[-255,255]

Kecerahan

0

contrast

int

[-100,100]

Kontras

0

saturation

int

[-100,100]

Saturasi

0

kelvin_temperature

int

[1000,40000]

Suhu warna. Parameter ini berlaku ketika temperature_ratio ditentukan.

temperature_ratio

6000

temperature_ratio

int

[0,100]

Rasio suhu warna.

0

tint

int

[-100,100]

tint

0

dark_corner_ratio

int

[0,100]

Vignetting

0

Pengaturan volume

Untuk informasi lebih lanjut tentang contoh timeline, lihat Contoh membisukan seluruh video dan Contoh menyesuaikan volume video dan mendubbing video dengan sumber audio yang volumenya juga disesuaikan.

Parameter

Tipe

Diperlukan

Deskripsi

Gain

Float

Tidak

Volume. Nilai valid: 0 hingga 10. Semakin kecil nilai, semakin rendah volume. 0 menunjukkan bisu, 1 menunjukkan volume asli. Nilai default: 1.

Fade in dan fade out audio

Untuk informasi lebih lanjut tentang contoh timeline, lihat Contoh mengonfigurasi fade in dan fade out audio untuk video dan Contoh mengonfigurasi fade in dan fade out audio.

Parameter

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

Tipe fading audio. Nilai valid:

  • In

  • Out

Duration

Float

Tidak

Durasi fading audio. Fade in audio diterapkan di awal materi dan fade out audio diterapkan di akhir materi. Nilai default: 0. 0 menunjukkan bahwa tidak ada fading audio yang diterapkan.

Curve

String

Tidak

Kurva volume fading audio. Nilai default: exp.

Nilai valid:

  • exp: kurva eksponensial

  • tri: kurva linier

Rotasi

Anda dapat memutar materi sebesar 90, 180, atau 270 derajat. Sudut rotasi dapat ditentukan baik di trek video maupun trek gambar.

Untuk informasi lebih lanjut tentang contoh timeline, lihat Konfigurasi rotasi materi.

Parameter

Tipe

Diperlukan

Deskripsi

Degree

Integer

Ya

Sudut rotasi dalam arah searah jarum jam. Anda hanya dapat memutar materi sebesar 90, 180, atau 270 derajat.

Capture klip acak

Anda dapat secara acak menangkap klip dari materi asli dan menambahkannya ke timeline.

Untuk informasi lebih lanjut tentang contoh timeline, lihat Gunakan efek acak.

Parameter

Tipe

Diperlukan

Deskripsi

SubType

String

Ya

Tipe capture. Nilai valid: RandomClip.

ClipDuration

Float

Ya

Durasi klip trek video.

Pembalikan

Anda dapat membalik video atau gambar dalam trek video sepanjang sumbu x atau y.

Parameter

Tipe

Diperlukan

Deskripsi

Direction

String

Ya

  • horizontal: membalik video atau gambar sepanjang sumbu x

  • vertical: membalik video atau gambar sepanjang sumbu y

Ken Burns

Anda dapat menambahkan efek Ken Burns ke video dan gambar di trek video.

Batasan:

  • Efek ini hanya dapat diterapkan pada gambar dan video. Efek Ken Burns dapat digunakan bersama dengan efek visual, filter, dan transisi.

  • Anda dapat menentukan parameter WindowW dan WindowH untuk mengonfigurasi lebar dan tinggi video keluaran. Setelah menentukan parameter WindowW dan WindowH, Anda tidak dapat memotong, menskalakan, menambahkan padding, atau mengonfigurasi latar belakang untuk gambar video keluaran.

Parameter

Tipe

Diperlukan

Deskripsi

Contoh

Duration

Float

Tidak

Durasi efek. Nilai default: durasi klip. Satuan: detik. Nilai maksimum: 10.

5

WindowW

Float

Tidak

Lebar klip. Secara default, nilainya sama dengan lebar video keluaran. Satuan: piksel.

Jika nilai WindowW berada dalam rentang (0,1], nilai tersebut adalah nilai relatif. Jika nilai lebih besar dari 1, nilai tersebut adalah nilai absolut.

1

WindowH

Float

Tidak

Tinggi klip. Secara default, nilainya sama dengan tinggi video keluaran. Satuan: piksel.

Jika nilai WindowH berada dalam rentang (0,1], nilai tersebut adalah nilai relatif.

Jika nilai lebih besar dari 1, nilai tersebut adalah nilai absolut.

1

Start

String

Tidak

Posisi area efek sebelum efek Ken Burns diterapkan. Posisi ditentukan oleh koordinat x dan y dari sudut kiri atas serta lebar dan tinggi area efek. Parameter bersifat opsional. Nilai harus dipisahkan dengan koma (,).

"StartX,StartY,StartW,StartH"

Aturan berikut berlaku:

0 < StartX + StartW <=1

0 < StartY + StartH <=1

"0,0,0.9,0.9"

StartX

Float

Tidak

Koordinat x sudut kiri atas area efek sebelum efek Ken Burns diterapkan. Satuan: piksel.

Jika nilai StartX berada dalam rentang [0,1), nilai tersebut adalah nilai relatif.

Jika nilai lebih besar dari atau sama dengan 1, nilai tersebut adalah nilai absolut.

0

StartY

Float

Tidak

Koordinat y sudut kiri atas area efek sebelum efek Ken Burns diterapkan. Satuan: piksel.

Jika nilai StartY berada dalam rentang [0,1), nilai tersebut adalah nilai relatif.

Jika nilai lebih besar dari atau sama dengan 1, nilai tersebut adalah nilai absolut.

0

StartW

Float

Tidak

Lebar area efek sebelum efek Ken Burns diterapkan. Satuan: piksel.

Jika nilai StartW berada dalam rentang (0,1], nilai tersebut adalah nilai relatif.

Jika nilai lebih besar dari 1, nilai tersebut adalah nilai absolut.

0.9

StartH

Float

Tidak

Tinggi area efek sebelum efek Ken Burns diterapkan. Satuan: piksel.

Jika nilai StartH berada dalam rentang (0,1], nilai tersebut adalah nilai relatif.

Jika nilai lebih besar dari 1, nilai tersebut adalah nilai absolut.

0.9

End

String

Tidak

Posisi area efek setelah efek Ken Burns diterapkan. Posisi ditentukan oleh koordinat x dan y sudut kiri atas serta lebar dan tinggi area efek. Parameter bersifat opsional. Nilai harus dipisahkan dengan koma (,).

"EndX,EndY,EndW,EndH"

Aturan berikut berlaku:

0 < EndX + EndW <=1

0 < EndY + EndH <=1

"0,0,1,1"

EndX

Float

Tidak

Koordinat x sudut kiri atas area efek setelah efek Ken Burns diterapkan. Satuan: piksel.

Jika nilai StartX berada dalam rentang [0,1), nilai tersebut adalah nilai relatif.

Jika nilai lebih besar dari atau sama dengan 1, nilai tersebut adalah nilai absolut.

0

EndY

Float

Tidak

Koordinat y sudut kiri atas area efek setelah efek Ken Burns diterapkan. Satuan: piksel.

Jika nilai StartY berada dalam rentang [0,1), nilai tersebut adalah nilai relatif.

Jika nilai lebih besar dari atau sama dengan 1, nilai tersebut adalah nilai absolut.

0

EndW

Float

Tidak

Lebar area efek setelah efek Ken Burns diterapkan. Satuan: piksel.

Jika nilai StartW berada dalam rentang (0,1], nilai tersebut adalah nilai relatif.

Jika nilai lebih besar dari 1, nilai tersebut adalah nilai absolut.

1

EndH

Float

Tidak

Tinggi area efek setelah efek Ken Burns diterapkan. Satuan: piksel.

Jika nilai StartH berada dalam rentang (0,1], nilai tersebut adalah nilai relatif.

Jika nilai lebih besar dari 1, nilai tersebut adalah nilai absolut.

1

Pembesaran

Anda dapat menambahkan efek pembesaran ke klip.

null

Efek pembesaran hanya dapat ditambahkan ke klip di trek video.

Parameter

Tipe

Diperlukan

Deskripsi

StartRate

Float

Tidak

  • Nilai zoom saat ini.

  • Nilai default: 1.0

  • Nilai valid: [1.0,5.0].

EndRate

Float

Tidak

  • Nilai zoom yang diinginkan.

  • Nilai default: Nilai StartRate ditambah 0.3.

  • Nilai valid: [StartRate,5.0]

Duration

Float

Tidak

  • Durasi efek pembesaran.

  • Nilai default: durasi rendering klip.

  • Nilai valid: [0,durasi rendering klip]