Struktur suatu efek bergantung pada jenisnya. Topik ini menjelaskan struktur berbagai jenis efek.
Jenis Efek: Teks (teks banner)
Contoh lini masa: Takarir dan templat takarir
Nama | Tipe | Diperlukan | Deskripsi |
X | Float | Tidak | Jarak horizontal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. Koordinat ini diskalakan berdasarkan dimensi materi dan video keluaran. |
Y | Float | Tidak | Jarak vertikal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. Koordinat ini diskalakan berdasarkan dimensi materi dan video keluaran. |
TimelineIn | Float | Tidak | Waktu mulai teks banner pada timeline, dalam detik. Nilainya akurat hingga empat tempat desimal. Jika Anda tidak menentukan parameter ini, nilainya sama dengan TimelineIn klip yang sesuai. |
TimelineOut | Float | Tidak | Waktu akhir teks banner pada timeline, dalam detik. Nilainya akurat hingga empat tempat desimal. Jika Anda tidak menentukan parameter ini, nilainya sama dengan TimelineOut klip yang sesuai. |
Content | String | Ya | Isi teks banner. |
Font | String | Tidak | Font teks banner. Untuk daftar font yang didukung, lihat Daftar font. Font default adalah SimSun. |
FontSize | Int | Ya | Ukuran font teks banner. Ukuran font ini diskalakan berdasarkan dimensi materi dan video keluaran. Nilai default adalah 0. Nilai maksimum adalah 5000. Catatan:
|
SizeRequestType | String | Tidak | Metode yang digunakan untuk menghitung ukuran sebenarnya dari teks yang dirender berdasarkan ukuran font. Nilai default adalah RealDim.
|
FixedFontSize | Int | Ya | Ukuran font teks banner. Ukuran font ini tidak diskalakan berdasarkan dimensi materi dan video output. Catatan:
|
FixedX | Float | Tidak | Jarak horizontal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. Koordinat ini tidak diskalakan berdasarkan dimensi materi dan video keluaran. |
FixedY | Float | Tidak | Jarak horizontal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. Koordinat ini tidak diskalakan berdasarkan dimensi materi dan video keluaran. |
FontColor | String | Tidak | Warna teks banner. Formatnya adalah tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff. |
FontColorOpacity | String | Tidak | Opasitas teks banner. Nilainya berkisar antara 0 hingga 1. Nilai 1 berarti teks tidak transparan (opaque). Nilai 0 berarti teks sepenuhnya transparan. Nilai default adalah 1. |
FontFace | FontFace | Tidak | Gaya font teks banner. |
Spacing | Integer | Tidak | Jarak antar karakter untuk teks banner, dalam piksel. Nilai default adalah 0. |
LineSpacing | Integer | Tidak | Jarak antar baris untuk teks banner, dalam piksel. Nilai default adalah 0. |
Angle | Float | Tidak | Sudut rotasi berlawanan arah jarum jam teks banner, dalam derajat. Nilai default adalah 0. |
BorderStyle | Int | Tidak | Gaya garis tepi dan bayangan untuk teks banner. Nilai yang valid adalah 1 dan 3. 1: garis tepi dan bayangan. 3: kotak latar belakang buram. Nilai default adalah 1. |
Outline | Int | Tidak | Lebar garis tepi teks banner, dalam piksel. Nilai default adalah 0. |
OutlineColour | String | Tidak | Warna garis tepi teks banner. Formatnya adalah tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff. |
Shadow | Int | Tidak | Kedalaman bayangan yang dihasilkan oleh teks banner, dalam piksel. Nilai default adalah 0. |
BackColour | String | Tidak | Warna bayangan teks banner. Formatnya adalah tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff. |
Alignment | String | Tidak | Penyelarasan teks banner. Nilai default adalah TopLeft. Nilai yang valid:
Untuk memposisikan teks terjemahan secara akurat dengan penyelarasan berbeda, atur penyelarasan sebagai berikut:
|
AdaptMode | String | Tidak | Metode untuk menangani teks banner yang melebihi lebar video atau TextWidth yang ditentukan:
|
TextWidth | String | Tidak | Lebar kotak teks terjemahan. Parameter ini hanya berlaku ketika AdaptMode diatur. Teks akan dibungkus atau diskalakan berdasarkan lebar ini. Jika Anda tidak menentukan parameter ini, teks akan dibungkus atau diskalakan berdasarkan lebar video. Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan persentase dari lebar video keluaran. Nilai yang lebih besar dari 1 merepresentasikan nilai piksel absolut. |
FontUrl | String | Tidak | Jalur berkas font di bucket OSS yang ingin Anda gunakan untuk teks banner. Format TTF, OTF, dan WOFF didukung. Contoh: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf |
EffectColorStyle | String | Tidak | Jenis gaya teks artistik untuk teks banner. Untuk informasi selengkapnya, lihat Contoh efek teks artistik. |
SubtitleEffects | Tidak | Efek multilapis untuk teks banner. Anda dapat mengatur garis tepi multilapis, bayangan multilapis, efek buram Gaussian (hanya untuk bayangan), dan efek latar belakang teks terjemahan. Catatan:
| |
AaiMotionInEffect | String | Tidak | Jenis efek masuk untuk teks banner. Untuk informasi selengkapnya, lihat Contoh efek teks terjemahan. |
AaiMotionIn | Float | Tidak | Durasi efek masuk untuk teks banner, dalam detik. Nilainya akurat hingga empat tempat desimal. Nilai default adalah 0,5 detik. Jika durasi teks kurang dari 0,5 detik, durasi efek masuk adalah durasi total dikurangi durasi efek keluar. |
AaiMotionOutEffect | String | Tidak | Jenis efek keluar untuk teks banner. Untuk informasi selengkapnya, lihat Contoh efek teks terjemahan. |
AaiMotionOut | Float | Tidak | Durasi efek keluar untuk teks banner, dalam detik. Nilainya akurat hingga empat tempat desimal. Nilai default adalah 0,5 detik. Jika durasi teks kurang dari 0,5 detik, durasi efek keluar adalah durasi teks total. |
AaiMotionLoopEffect | String | Tidak | Jenis efek loop untuk teks banner. Efek ini tidak dapat digunakan bersamaan dengan efek masuk atau keluar. Untuk informasi selengkapnya, lihat Contoh efek teks terjemahan. |
Ratio | Float | Tidak | Kecepatan pemutaran efek loop untuk teks banner. Nilainya akurat hingga empat tempat desimal. Nilai default adalah 1. Nilai lebih besar dari 1 menunjukkan loop lebih cepat. Nilai kurang dari 1 menunjukkan loop lebih lambat. |
TextureURL | String | Tidak | Efek tekstur untuk teks terjemahan. Format PNG, JPG, JPEG, dan BMP didukung. Anda harus menggunakan berkas OSS. Contoh: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png |
BubbleStyleId | String | Tidak | Jenis gaya teks gelembung untuk teks banner. Untuk jenis dan efek gelembung, lihat Contoh teks gelembung. |
BubbleWidth | Float | Tidak | Parameter ini hanya berlaku saat Anda menggunakan teks gelembung. Parameter ini menentukan lebar latar belakang gelembung relatif terhadap video keluaran. Nilai lebih besar dari 1 merepresentasikan nilai piksel absolut. Nilai kurang dari atau sama dengan 1 merepresentasikan nilai relatif. |
BubbleHeight | Float | Tidak | Parameter ini hanya berlaku saat Anda menggunakan teks gelembung. Parameter ini menentukan tinggi latar belakang gelembung relatif terhadap video keluaran. Nilai lebih besar dari 1 merepresentasikan nilai piksel absolut. Nilai kurang dari atau sama dengan 1 merepresentasikan nilai relatif. |
Jenis Efek: DeWatermark (penyembunyian)
Nama | Tipe | Diperlukan | Deskripsi |
X | Float | Tidak | Jarak horizontal dari pojok kiri atas area penyembunyian ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. |
Y | Float | Tidak | Jarak vertikal dari pojok kiri atas area penyembunyian ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. |
Width | Float | Ya | Lebar area penyembunyian dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. |
Height | Float | Ya | Tinggi area penyembunyian dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. |
Jenis Efek: Crop
Contoh timeline: Pemotongan video
Nama | Tipe | Diperlukan | Deskripsi |
X | Float | Tidak | Jarak horizontal dari pojok kiri atas area yang dipangkas ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. |
Y | Float | Tidak | Jarak vertikal dari pojok kiri atas area yang dipangkas ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. Nilai default adalah 0. |
Width | Float | Ya | Lebar area yang dipangkas dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. |
Height | Float | Ya | Tinggi area yang dipangkas dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. |
Jenis Efek: Scale
Catatan: Jika Anda tidak menentukan efek Scale dan rasio aspek materi tidak sesuai dengan rasio aspek video keluaran, materi akan secara otomatis diskalakan agar sesuai dengan lebar atau tinggi video keluaran. Bilah hitam akan ditambahkan di atas dan bawah atau di kiri dan kanan, serta materi diposisikan di tengah.
Contoh timeline: Konfigurasi skala
Nama | Tipe | Diperlukan | Deskripsi |
Width | Float | Ya | Lebar area yang diskalakan dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut. |
Height | Float | Ya | Tinggi area yang diskalakan dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut. |
Jenis Efek: Pad (padding)
Catatan: Jika Anda tidak menentukan efek Pad dan rasio aspek materi tidak sesuai dengan rasio aspek video keluaran, materi akan secara otomatis diskalakan agar sesuai dengan lebar atau tinggi video keluaran. Bilah hitam akan ditambahkan di atas dan bawah atau di kiri dan kanan, serta materi diposisikan di tengah.
Contoh timeline: Mengonversi video lanskap menjadi video potret dan menambahkan area buram di atas dan bawah
Nama | Tipe | Diperlukan | Deskripsi |
Left | Float | Tidak | Jarak dari tepi kiri materi ke tepi kiri video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut. |
Right | Float | Tidak | Jarak dari tepi kanan materi ke tepi kanan video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut. |
Top | Float | Tidak | Jarak dari tepi atas materi ke tepi atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut. |
Bottom | Float | Tidak | Jarak dari tepi bawah materi ke tepi bawah video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 1 merepresentasikan nilai piksel absolut. |
Color | String | Tidak | Warna padding. Formatnya adalah tanda pagar (#) diikuti nilai heksadesimal. Contoh: #000000. Warna default adalah hitam. |
Jenis Efek: Background
Pengaturan latar belakang mencakup efek buram latar belakang dan warna latar belakang. Jika dimensi materi tidak sesuai dengan dimensi video keluaran, Anda dapat menggunakan efek ini untuk mengonfigurasi area kosong.
Efek latar belakang dapat digunakan bersama efek lain seperti Crop, Scale, VFX, dan Transition.
Contoh timeline: Mengonversi video lanskap menjadi video potret dan mengatur warna latar belakang
Nama | Tipe | Diperlukan | Deskripsi |
SubType | String | Ya | Subtipe. Nilai yang valid: Blur: efek buram latar belakang Color: warna latar belakang |
Radius | Float | Tidak | Radius efek buram. Parameter ini hanya berlaku ketika SubType diatur ke Blur. Nilainya berkisar antara 0,01 hingga 1. |
Color | String | Tidak | Nilai warna. Parameter ini hanya berlaku ketika SubType diatur ke Color. Tentukan warna dalam format heksadesimal RGB. Contoh: #FFFFFF |
Jenis Efek: Transition
Transisi ini dibuat dengan menumpangkan lapisan dua materi berurutan, yang memperpendek durasi video akhir. Untuk menghindarinya, gunakan efek transisi pengunci durasi (DLTransition), yang dijelaskan di bagian selanjutnya dalam topik ini.
Efek transisi terjadi di antara dua materi. Anda hanya perlu mengatur durasi transisi pada materi pertama. Efek ini diterapkan pada akhir materi pertama dan awal materi kedua. Selama transisi, frame video tumpang tindih, yang mengurangi durasi total sebesar durasi transisi.
Sebagai contoh, jika track video berisi dua klip, Clip1 (10 detik) dan Clip2 (8 detik), dan Anda menambahkan transisi 4 detik di antara keduanya, durasi total track video berkurang dari 18 detik menjadi 14 detik.
Tabel berikut menjelaskan properti transisi. Untuk informasi lebih lanjut mengenai efek transisi, lihat Contoh efek transisi.
Contoh timeline: Contoh konfigurasi timeline transisi
Nama | Tipe | Diperlukan | Deskripsi |
SubType | String | Ya | Subtipe transisi. Anda dapat menentukan beberapa subtipe yang dipisahkan koma, dari mana satu dipilih secara acak. Anda juga dapat menentukan `random` untuk memilih secara acak dari semua subtipe yang tersedia. Contoh: directional. Untuk daftar lengkap nilai dan efeknya, lihat Contoh efek transisi. |
Duration | Float | Tidak | Durasi efek transisi, dalam detik. Nilainya akurat hingga empat tempat desimal. Nilai default adalah 1 detik. |
Jenis Efek: DLTransition (transisi pengunci durasi)
Berbeda dengan efek Transition standar, efek transisi pengunci durasi (DLTransition) tidak memperpendek durasi video akhir karena mengisi periode transisi dengan frame diam.
Parameter untuk efek ini sama dengan parameter untuk efek Transition.
Nama | Tipe | Diperlukan | Deskripsi |
SubType | String | Ya | Subtipe transisi. Anda dapat menentukan beberapa subtipe yang dipisahkan koma, dari mana satu dipilih secara acak. Anda juga dapat menentukan `random` untuk memilih secara acak dari semua subtipe yang tersedia. Contoh: directional. Untuk daftar lengkap nilai dan efeknya, lihat Contoh efek transisi. |
Duration | Float | Tidak | Durasi efek transisi, dalam detik. Nilainya akurat hingga empat tempat desimal. Nilai default adalah 1 detik. |
Jenis Efek: VFX
Contoh timeline: Efek VFX
Nama | Tipe | Diperlukan | Deskripsi |
SubType | String | Ya | Subtipe VFX. Anda dapat menentukan beberapa subtipe yang dipisahkan koma, dari mana satu dipilih secara acak. Anda juga dapat menentukan `random` untuk memilih secara acak dari semua subtipe yang tersedia. Contoh: colorfulradial. Untuk daftar lengkap nilai dan efeknya, lihat Contoh efek VFX. |
X | Float | Tidak | Bidang ini hanya didukung ketika SubType diatur ke mosaic_rect atau blur. Jarak horizontal dari pojok kiri atas area efek ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. |
Y | Float | Tidak | Bidang ini hanya didukung ketika SubType diatur ke mosaic_rect atau blur. Jarak vertikal dari area efek ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. |
Width | Float | Tidak | Bidang ini hanya didukung ketika SubType diatur ke mosaic_rect atau blur. Lebar area efek dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. |
Height | Float | Tidak | Bidang ini hanya didukung ketika SubType diatur ke mosaic_rect atau blur. Tinggi area efek dalam video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. |
ExtParams | String | Tidak | Parameter tambahan untuk efek. Bidang ini hanya berlaku untuk skenario penyembunyian, di mana SubType diatur ke mask_circle, mask_rec, mask_linear, atau mask_minor. Untuk informasi tentang konfigurasi ExtParams untuk penyembunyian, lihat bagian berikut. |
Untuk contoh penyembunyian dan efek yang dihasilkannya, lihat Efek penyembunyian.
Untuk parameter penyembunyian berikut, jika suatu parameter berupa bilangan titik mengambang, Anda harus menentukannya dalam format titik mengambang, seperti 0,5 atau 2,0.
Parameter efek penyembunyian lingkaran
SubType=mask_circle
Parameter ExtParams
Parameter | Tipe | Rentang nilai | Nilai default | Deskripsi |
x | float | [0,0, lebar material] | 0,5 | Koordinat x pusat penyembunyian relatif terhadap pojok kiri atas materi. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
y | float | [0,0, tinggi materi] | 0,5 | Koordinat y pusat penyembunyian relatif terhadap pojok kiri atas materi. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
width | float | [0,0, lebar material] | 0,8 | Lebar penyembunyian elips relatif terhadap lebar materi. Nilai dari 0,0 hingga 1,0 merepresentasikan lebar relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
height | float | [0,0, tinggi materi] | 0,8 | Tinggi penyembunyian elips relatif terhadap lebar materi. Nilai dari 0,0 hingga 1,0 merepresentasikan tinggi relatif berdasarkan tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
antialias | float | [0.0, 1.0] | 0,1 | Parameter anti-aliasing untuk penyembunyian elips. Nilai yang lebih besar menunjukkan tingkat feathering tepi yang lebih tinggi. |
angle | float | [-9999,0, 9999,0] | 0,0 | Sudut rotasi. |
Parameter efek penyembunyian persegi panjang
SubType=mask_rec
Parameter ExtParams
Parameter | Tipe | Rentang nilai | Nilai default | Deskripsi |
x | float | [0,0, lebar material] | 0,5 | Koordinat x pusat penyembunyian persegi panjang relatif terhadap pojok kiri atas materi video. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
y | float | [0,0; tinggi bahan] | 0,5 | Koordinat y pusat penyembunyian persegi panjang relatif terhadap pojok kiri atas materi video. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
width | float | [0,0; lebar bahan] | 0,8 | Lebar penyembunyian persegi panjang. Nilai dari 0,0 hingga 1,0 merepresentasikan lebar relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
height | float | [0,0; tinggi material] | 0,8 | Tinggi penyembunyian persegi panjang. Nilai dari 0,0 hingga 1,0 merepresentasikan tinggi relatif berdasarkan tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
antialias | float | [0,0, 1,0] | 0,1 | Parameter anti-aliasing untuk penyembunyian persegi panjang. Nilai yang lebih besar menunjukkan tingkat feathering tepi yang lebih tinggi. |
radius | float | [0,0; nilai yang lebih besar antara lebar dan tinggi material] | 0,1 | Jari-jari sudut penyembunyian persegi panjang. Nilai dari 0,0 hingga 1,0 merepresentasikan jari-jari relatif terhadap nilai yang lebih besar antara lebar atau tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
angle | float | [-9999,0, 9999,0] | 0,0 | Sudut rotasi. |
Parameter efek penyembunyian linear
SubType=mask_linear
Parameter ExtParams
Parameter | Tipe | Rentang nilai | Nilai default | Deskripsi |
x | float | [0,0; lebar material] | 0,5 | Koordinat x titik referensi pusat penyembunyian linear relatif terhadap pojok kiri atas materi. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
y | float | [0,0; tinggi bahan] | 0,5 | Koordinat y titik referensi pusat penyembunyian linear relatif terhadap pojok kiri atas video. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
antialias | float | [0.0, 1.0] | 0,1 | Parameter anti-aliasing untuk penyembunyian linear. Nilai yang lebih besar menunjukkan tingkat feathering tepi yang lebih tinggi. |
angle | float | [-9999,0, 9999,0] | 0,0 | Sudut rotasi. |
Parameter efek penyembunyian cermin
SubType=mask_minor
Parameter ExtParams
Parameter | Tipe | Rentang nilai | Nilai default | Deskripsi |
x | float | [0,0, lebar material] | 0,5 | Koordinat x titik referensi pusat penyembunyian cermin relatif terhadap pojok kiri atas materi. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan lebar materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
y | float | [0,0, tinggi material] | 0,5 | Koordinat y titik referensi pusat penyembunyian cermin relatif terhadap pojok kiri atas materi. Nilai dari 0,0 hingga 1,0 merepresentasikan koordinat relatif berdasarkan tinggi materi. Nilai lebih besar dari 1,0 merepresentasikan nilai piksel absolut. |
antialias | float | [0.0, 1.0] | 0,1 | Parameter anti-aliasing untuk penyembunyian cermin. Nilai yang lebih besar menunjukkan tingkat feathering tepi yang lebih tinggi. |
angle | float | [-9999,0, 9999,0] | 0,0 | Sudut rotasi. |
Jenis Efek: Filter
Contoh timeline: Efek filter
Nama | Tipe | Diperlukan | Deskripsi |
SubType | String | Ya | Subtipe filter. Anda dapat menentukan beberapa subtipe yang dipisahkan koma, dari mana satu dipilih secara acak. Anda juga dapat menentukan `random` untuk memilih secara acak dari semua subtipe yang tersedia. Contoh: M1. Untuk daftar lengkap nilai dan efeknya, lihat Contoh efek filter. |
TimelineIn | Float | Tidak | Waktu mulai filter pada timeline, dalam detik. Nilainya akurat hingga empat tempat desimal. Jika Anda tidak menentukan parameter ini, nilainya sama dengan TimelineIn klip yang sesuai. |
TimelineOut | Float | Tidak | Waktu akhir filter pada timeline, dalam detik. Nilainya akurat hingga empat tempat desimal. Jika Anda tidak menentukan parameter ini, nilainya sama dengan TimelineOut klip yang sesuai. |
ExtParams | String | Tidak | Parameter tambahan untuk filter. Bidang ini hanya berlaku ketika SubType diatur ke color (filter warna). Untuk informasi tentang konfigurasi ExtParams untuk filter warna, lihat bagian berikut. |
ExtParams untuk filter warna
Contoh timeline: Menggunakan filter warna
Parameter ExtParams
Parameter | Tipe | Rentang nilai | 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. Parameter ini digunakan bersama Parameter temperature_ratio berlaku. | 6000 |
temperature_ratio | int | [0,100] | Rasio suhu | 0 |
tint | int | [-100,100] | Rona | 0 |
dark_corner_ratio | int | [0,100] | Rasio sudut gelap | 0 |
Jenis Efek: Volume
Contoh timeline: Membisukan seluruh video, Menyesuaikan volume video dan audio
Nama | Tipe | Diperlukan | Deskripsi |
Gain | Float | Ya | Penguatan volume. Nilainya berkisar antara 0 hingga 10. Nilai yang lebih kecil menunjukkan volume lebih rendah. Nilai 0 membisukan audio. Nilai 1 mempertahankan volume asli. Nilai kurang dari 1 menurunkan volume. Nilai lebih dari 1 meningkatkan volume. Jangan mengatur gain terlalu tinggi untuk menghindari distorsi audio. |
Jenis Efek: AFade (fade-in/fade-out audio)
Contoh timeline: Mengonfigurasi fade-in/fade-out untuk klip hanya audio dan audio dalam klip video
Nama | Tipe | Diperlukan | Deskripsi |
SubType | String | Ya | Subtipe fade-in/fade-out audio. Nilai yang valid:
|
Duration | Float | Tidak | Durasi efek fade-in atau fade-out. Efek fade-in diterapkan pada awal segmen materi. Efek fade-out diterapkan pada akhir segmen materi. Nilai default adalah 0, yang berarti efek dinonaktifkan. |
Curve | String | Tidak | Kurva volume untuk efek fade-in/fade-out. Nilai default adalah exp. Nilai valid:
|
Jenis Efek: AI_ASR (speech-to-text)
Efek ini menghasilkan teks terjemahan dari audio. Anda dapat menambahkan efek ini ke objek Effects pada track video atau audio. Parameternya sama dengan Jenis Efek: Teks (teks banner). Secara default, teks terjemahan diposisikan di tengah bawah video. Fitur ini hanya tersedia di wilayah Tiongkok (Beijing), Tiongkok (Shanghai), dan Tiongkok (Hangzhou).
Nama | Tipe | Diperlukan | Deskripsi |
X | Float | Tidak | Jarak horizontal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari lebar video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. |
Y | Float | Tidak | Jarak vertikal dari pojok kiri atas teks banner ke pojok kiri atas video keluaran. Catatan: Nilai persentase dan piksel didukung. Nilai dari 0 hingga 0,9999 merepresentasikan persentase dari tinggi video keluaran. Bilangan bulat yang lebih besar atau sama dengan 2 merepresentasikan nilai piksel absolut. |
Font | String | Tidak | Font teks banner. Untuk daftar font yang didukung, lihat Daftar font. Font default adalah SimSun. |
FontSize | Int | Ya | Ukuran font teks banner. |
FontColor | String | Tidak | Warna teks banner. Formatnya adalah tanda pagar (#) diikuti nilai heksadesimal. Contoh: #ffffff. |
FontColorOpacity | String | Tidak | Opasitas teks banner. Nilainya berkisar dari 0 hingga 1. Nilai 1 berarti teks tidak transparan. Nilai 0 berarti teks sepenuhnya transparan. Nilai default adalah 1. |
FontFace | FontFace | Tidak | Gaya font teks banner. |
NeedHighlighting | Boolean | Tidak | Menentukan apakah akan mengaktifkan penyorotan otomatis untuk teks terjemahan ASR. |
HighlightingStyle | Tidak | Gaya teks terjemahan yang disorot. |
Jenis Efek: Rotate (rotasi materi)
Efek ini memutar materi dengan sudut tertentu. Hanya rotasi 90°, 180°, dan 270° yang didukung. Anda dapat menambahkan efek ini ke objek Effects pada materi video atau citra di track video.
Contoh timeline: Rotasi materi
Nama | Tipe | Diperlukan | Deskripsi |
Derajat | Bilangan Bulat | Ya | Sudut rotasi searah jarum jam materi. Hanya 90, 180, dan 270 yang didukung. |
Jenis Efek: AI_Matting (matting citra)
Efek ini mengekstraksi objek dari latar belakang layar hijau atau biru dan menumpangkannya ke video atau citra latar belakang lain. Fitur ini hanya tersedia di wilayah Tiongkok (Beijing), Tiongkok (Shanghai), dan Tiongkok (Hangzhou).
Nama | Tipe | Diperlukan | Deskripsi |
Warna | String | Ya | Warna latar belakang. Hanya hijau (keying layar hijau) dan biru (keying layar biru) yang didukung. |
Otomatis | Integer | Ya | Menentukan apakah akan mendeteksi warna latar belakang secara otomatis. Nilai yang valid:
|
Ambang | Float | Tidak | Ambang batas untuk deteksi warna latar belakang. Nilai yang lebih besar menunjukkan deteksi yang lebih longgar. Nilainya berkisar antara 0 hingga 10. |
Jenis Efek: AI_RealMatting (matting adegan nyata)
Efek ini mengekstraksi sosok manusia dari adegan dunia nyata dalam video dan menumpangkannya ke video atau citra latar belakang lain. Fitur ini hanya tersedia di wilayah Tiongkok (Beijing), Tiongkok (Shanghai), dan Tiongkok (Hangzhou).
Nama | Tipe | Diperlukan | Deskripsi |
Thres | Float | Tidak | Ambang batas untuk deteksi warna latar belakang. Nilai yang lebih besar menunjukkan deteksi yang lebih longgar. Nilainya berkisar antara 0 hingga 10. Nilai default adalah 2. |
Jenis Efek: AI_Delogo (penghapusan logo cerdas)
Efek ini secara cerdas mengenali dan menghapus logo stasiun dari video. Fitur ini hanya tersedia di wilayah Tiongkok (Beijing) dan Tiongkok (Shanghai).
Jenis Efek: Clip (pemangkasan acak)
Efek ini menyediakan fitur pemangkasan. Saat ini, hanya pemangkasan acak yang didukung. Segmen dengan durasi acak dipangkas dari materi asli dan ditambahkan ke timeline.
Nama | Tipe | Wajib | Deskripsi |
SubType | String | Ya | Jenis pemangkasan. Saat ini, hanya pemangkasan acak yang didukung: RandomClip. |
ClipDuration | Float | Ya | Durasi segmen yang dipotong. |
Jenis Efek: Flip
Efek ini membalik frame video atau citra pada track video secara horizontal atau vertikal.
Contoh timeline: Pembalikan horizontal dan vertikal
Nama | Tipe | Diperlukan | Deskripsi |
Arah | String | Ya |
|
Jenis Efek: KenBurns (pan dan zoom)
Efek ini menerapkan efek pan dan zoom pada video atau citra di track video.
Batasan:
Efek ini berlaku untuk citra dan video. Dapat digunakan bersama efek VFX, filter, dan transisi.
Efek ini memungkinkan Anda mengatur lebar dan tinggi frame keluaran (lihat parameter WindowW/WindowH di bawah). Oleh karena itu, tidak dapat digunakan bersama efek Crop, Scale, Pad, atau Background.
Nama | Tipe | Diperlukan | Deskripsi | Contoh | |
Durasi | Float | Tidak | Durasi efek, dalam detik (s). Nilai default adalah durasi klip. Nilai maksimum adalah 10. | 5 | |
WindowW | Float | Tidak | Lebar segmen keluaran akhir, dalam piksel (px). Nilai default adalah lebar video keluaran. Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif. Nilai lebih besar dari 1 merepresentasikan nilai absolut. | 1 | |
WindowH | Float | Tidak | Tinggi segmen keluaran akhir, dalam piksel (px). Nilai default adalah tinggi video keluaran. Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif. > 1 merepresentasikan nilai absolut. | 1 | |
Mulai | String | Tidak | Posisi (koordinat x, koordinat y, lebar, dan tinggi) pojok kiri atas frame dalam materi asli pada awal efek. Nilainya dipisahkan koma. Semua nilai bersifat opsional. "StartX,StartY,StartW,StartH" Batas: 0 < StartX + StartW <=1 0 < StartY + StartH <=1 | "0,0,0.9,0.9" | |
StartX | Float | Tidak | Koordinat x pojok kiri atas frame dalam materi asli pada awal efek, dalam piksel (px). Nilai dalam interval tertutup-terbuka [0, 1) merepresentasikan nilai relatif. Nilai lebih besar atau sama dengan 1 merepresentasikan nilai absolut. | 0 | |
StartY | Float | Tidak | Koordinat y pojok kiri atas frame dalam materi asli pada awal efek, dalam piksel (px). Nilai dalam interval tertutup-terbuka [0, 1) merepresentasikan nilai relatif. Nilai lebih besar atau sama dengan 1 merepresentasikan nilai absolut. | 0 | |
StartW | Float | Tidak | Lebar frame dalam materi asli pada awal efek, dalam piksel (px). Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif. Nilai lebih besar dari 1 merepresentasikan nilai absolut. | 0.9 | |
StartH | Float | Tidak | Tinggi frame dalam materi asli pada awal efek, dalam piksel (px). Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif. > 1 merepresentasikan nilai absolut. | 0.9 | |
Akhir | String | Tidak | Posisi (koordinat x, koordinat y, lebar, dan tinggi) pojok kiri atas frame dalam materi asli pada akhir efek. Nilainya dipisahkan koma. Semua nilai bersifat opsional. "EndX,EndY,EndW,EndH" Batas: 0 < EndX + EndW <=1 0 < EndY + EndH <=1 | "0,0,1,1" | |
EndX | Float | Tidak | Koordinat x pojok kiri atas frame dalam materi asli pada akhir efek, dalam piksel (px). Nilai dalam interval tertutup-terbuka [0, 1) merepresentasikan nilai relatif. Nilai lebih besar atau sama dengan 1 merepresentasikan nilai absolut. | 0 | |
EndY | Float | Tidak | Koordinat y pojok kiri atas frame dalam materi asli pada akhir efek, dalam piksel (px). Nilai dalam interval tertutup-terbuka [0, 1) merepresentasikan nilai relatif. Nilai lebih besar atau sama dengan 1 merepresentasikan nilai absolut. | 0 | |
EndW | Float | Tidak | Lebar frame dalam materi asli pada akhir efek, dalam piksel (px). Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif. > 1 merepresentasikan nilai absolut. | 1 | |
EndH | Float | Tidak | Tinggi frame dalam materi asli pada akhir efek, dalam piksel (px). Nilai dalam interval terbuka-tutup (0, 1] merepresentasikan nilai relatif. > Nilai 1 merepresentasikan nilai absolut. | 1 | |
Jenis Efek: ADenoise (penghilangan derau audio)
Efek ini melakukan penghilangan derau pada audio dalam video di track video atau pada klip audio di track audio.
Nama | Tipe | Diperlukan | Deskripsi |
Mode | Integer | Tidak |
|
Jenis Efek: Zoom
Efek ini menambahkan efek zoom pada klip yang sesuai.
Efek ini hanya dapat digunakan untuk klip pada VideoTrack.
Nama | Tipe | Diperlukan | Deskripsi |
StartRate | Float | Tidak |
|
EndRate | Float | Tidak |
|
Duration | Float | Tidak |
|
Jenis Efek: Harmonization (penggabungan latar belakang)
Efek ini menambahkan efek penggabungan latar belakang pada klip yang sesuai. Efek ini terutama digunakan untuk klip video manusia digital. Ketika Anda menambahkan efek ini ke klip video manusia digital, efek ini menyesuaikan pencahayaan, kecerahan, dan suhu warna latar belakang citra untuk menciptakan penggabungan yang lebih mulus antara klip video manusia digital dan citra latar belakang.
Efek ini hanya dapat digunakan untuk klip pada VideoTrack.
Anda hanya dapat menambahkan satu efek Harmonization dalam satu permintaan pengeditan video.
Efek ini tidak memiliki parameter input lainnya.
Jenis Efek: ALoudNorm (normalisasi kenyaringan)
ALoudNorm hanya berlaku untuk satu materi audio atau video. Jika Anda memiliki beberapa materi audio atau video dan ingin semuanya memiliki kenyaringan yang sama, Anda harus mengonfigurasi ALoudNorm untuk setiap materi secara terpisah.
Efek ini hanya berlaku untuk klip audio dan video. Jika ALoudNorm digunakan bersama ADenoise atau Volume, urutan penerapannya adalah: ADenoise > Volume > ALoudNorm.
Contoh timeline: Normalisasi kenyaringan
Nama | Tipe | Diperlukan | Deskripsi |
Loudness | Float | Tidak | Kenyaringan target, yang menentukan tingkat volume dan mematuhi standar EBU R 128. Nilainya berkisar antara -70,0 hingga -5,0. Nilai default adalah -24,0. |
TruePeak | Float | Tidak | Tingkat true peak, yang membatasi tingkat puncak tertinggi sinyal audio. Nilainya berkisar antara -9,0 hingga +0,0. Nilai default adalah -2,0. |
Jenis Efek: AEqualize (equalisasi audio)
Efek ini berlaku untuk track efek sebagai efek global. Efek ini melakukan equalisasi audio seragam pada seluruh audio proyek.
Efek ini hanya berlaku secara global dan tidak didukung untuk klip individual.
Contoh timeline: Equalisasi audio
Nama | Tipe | Diperlukan | Deskripsi |
Peak | Float | Tidak | Tingkat puncak target audio. Nilai default adalah 0,95. Kami menyarankan agar Anda tidak melebihi nilai ini. Nilai harus dalam interval terbuka (0, 1). |
Gain | Float | Tidak | Koefisien gain maksimum. Nilainya berkisar antara 1,0 hingga 100,0. Nilai default adalah 10,0. Normalizer audio dinamis menentukan faktor gain (lokal) maksimum yang mungkin untuk setiap frame input yang tidak menyebabkan clipping atau distorsi. |
Jenis Efek: FreezeFrame (freeze frame)
Efek ini berlaku untuk materi video pada track video. Efek ini membekukan frame terakhir video.
Efek ini hanya berlaku untuk materi video pada track video. Efek ini tidak berlaku untuk materi citra pada track video atau materi pada track audio.
Efek ini tidak dapat digunakan bersama efek Jenis Efek: Transition.
Contoh timeline: Freeze frame video
Nama | Tipe | Wajib | Deskripsi |
Duration | Float | Tidak | Durasi freeze frame, dalam detik (s). Nilai default adalah 0. |