Timeline mengatur material pada track dengan efek yang diterapkan untuk menghasilkan video. Untuk informasi lebih lanjut tentang contoh timeline, lihat Use Cases.
Parameter | Type | Required | Description |
VideoTracks | No (Jika tidak ada video track, audio track wajib disediakan.) | Video track. Video track ditumpuk berdasarkan urutan elemen array MediaId. Misalnya, track yang sesuai dengan elemen pertama array MediaId ditempatkan di bawah track yang sesuai dengan elemen kedua array MediaId. | |
AudioTracks | No (Jika tidak ada audio track, video track wajib disediakan.) | Audio track. | |
ImageTracks (Kemampuan image track telah digabungkan ke dalam kemampuan video track dan tidak lagi dikembangkan atau dipelihara.) | No (Jika image track tersedia, video track wajib disediakan.) | Image track. Catatan: 1. Image track harus ditempatkan di atas video track. Jika gambar perlu digabungkan dengan video sebagai material dalam skenario produksi gambar dan video, gunakan video track. 2. Image track ditumpuk berdasarkan urutan elemen array MediaId. Misalnya, track yang sesuai dengan elemen pertama array MediaId ditempatkan di bawah track yang sesuai dengan elemen kedua array MediaId. | |
SubtitleTracks | No | Subtitle track. | |
EffectTracks | No | Efek tersebut dilacak. |
VideoTrack
Mengatur material video dan gambar.
Parameter | Type | Required | Description |
Type | String | No | Jenis video track. Secara default, video track biasa digunakan. Jika Anda mengatur Type ke Effect, video track dapat digunakan untuk efek. Dalam hal ini, Anda dapat menentukan objek EffectTrackItem dalam VideoTrackClips. |
MainTrack | Boolean | No | Menentukan apakah video track saat ini merupakan main track. Nilai default: False. Untuk informasi lebih lanjut, lihat Set a main track. |
TrackShortenMode | String | No | Jika durasi video track saat ini lebih panjang daripada durasi main track, durasi track saat ini akan dipersingkat secara adaptif agar sejajar dengan durasi main track. Parameter ini menentukan mode pemendekan track. Nilai yang valid:
|
TrackExpandMode | String | No | Jika durasi video track saat ini lebih pendek daripada durasi main track, durasi track saat ini akan diperpanjang secara adaptif agar sejajar dengan durasi main track. Parameter ini menentukan mode perpanjangan track. Nilai yang valid:
|
VideoTrackClips | Yes | Material dalam video track. |
AudioTrack
Mengatur material hanya-audio serta material video yang berisi aliran audio.
Parameter | Type | Required | Description |
MainTrack | Boolean | No | Menentukan apakah audio track saat ini merupakan main track. Nilai default: False. Untuk informasi lebih lanjut, lihat Set a main track. |
TrackShortenMode | String | No | Jika durasi audio track saat ini lebih panjang daripada durasi main track, durasi track saat ini akan dipersingkat secara adaptif agar sejajar dengan durasi main track. Parameter ini menentukan mode pemendekan track. Nilai yang valid:
|
TrackExpandMode | String | No | Jika durasi audio track saat ini lebih pendek daripada durasi main track, durasi track saat ini akan diperpanjang secara adaptif agar sejajar dengan durasi main track. Parameter ini menentukan mode perpanjangan track. Nilai yang valid:
|
AudioTrackClips | Yes | Material dalam audio track. |
ImageTrack
Kemampuan image track telah digabungkan ke dalam video track dan tidak lagi dikembangkan atau dipelihara.
Mengatur material gambar.
Parameter | Type | Required | Description |
ImageTrackClips (Kemampuan image track telah digabungkan ke dalam kemampuan video track dan tidak lagi dikembangkan atau dipelihara.) | Yes | Material dalam image track. |
SubtitleTrack
Mengatur subtitle, termasuk teks banner dan subtitle eksternal.
Parameter | Type | Required | Description |
SubtitleTrackClips | Yes | Material dalam subtitle track. |
EffectTrack
Menambahkan filter dan efek visual ke video.
Parameter | Type | Required | Description |
EffectTrackItems | Yes | Filter dan efek yang ditambahkan ke effect track. |
VideoTrackClip
Anda dapat menambahkan material video atau gambar ke video track.
Gunakan parameter In, Out, TimelineIn, dan TimelineOut untuk menentukan posisi pemotongan material dan penempatannya di timeline. Misalnya, jika In diatur ke 5, Out ke 10, TimelineIn ke 15, dan TimelineOut ke 20, material dari detik ke-5 hingga ke-10 dipotong dan diputar dari detik ke-15 hingga ke-20 dalam timeline.
Parameter | Type | Required | Description |
MediaId | String | No | ID aset media Intelligent Media Services (IMS) atau ApsaraVideo VOD yang sesuai dengan material dalam video track. Catatan: Anda hanya boleh menentukan salah satu dari MediaId dan MediaURL. |
MediaURL | String | No | URL Object Storage Service (OSS) material dalam video track. Format URL OSS adalah sebagai berikut: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4. Catatan:
Untuk informasi lebih lanjut, lihat Pengeditan gambar dan video. |
Type | String | No | Jenis material. Nilai default: Video. Nilai yang valid:
|
X | Float | No | Jarak horizontal antara pojok kiri atas material dan pojok kiri atas video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
Y | Float | No | Jarak vertikal antara pojok kiri atas material dan pojok kiri atas video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
Width | Float | No | Lebar material dalam video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
Height | Float | No | Tinggi material dalam video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
AdaptMode | String | No | Mode pengubahan ukuran material secara otomatis. Parameter ini hanya berlaku jika Anda menentukan lebar dan tinggi tampilan. Material diskalakan berdasarkan lebar dan tinggi tampilan. Nilai yang valid:
|
In | Float | No | Waktu mulai material dalam file sumber. File sumber harus berupa file audio atau video. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan In, nilai 0 digunakan. |
Out | Float | No | Waktu akhir material dalam file sumber. File sumber harus berupa file audio atau video. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan Out, material berakhir ketika file sumber berakhir. |
MaxOut | Float | No | Waktu akhir maksimum material. Jika Anda menentukan parameter ini, waktu akhir material adalah nilai yang lebih kecil antara durasi file sumber dan nilai MaxOut. Parameter ini hanya berlaku jika file sumber berupa file audio atau video. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda menentukan Out, MaxOut menjadi tidak berlaku. Untuk informasi lebih lanjut, lihat Trim dan gabungkan beberapa segmen video. |
Duration | Float | No | Durasi material. Umumnya, parameter ini digunakan untuk gambar. Satuan: detik. Nilai akurat hingga empat tempat desimal. |
DyncFrames | Int | No | Jumlah frame stiker animasi. Parameter ini hanya berlaku jika file sumber berupa gambar animasi. Untuk informasi lebih lanjut, lihat Tambahkan stiker GIF. |
TimelineIn | Float | No | Waktu mulai material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, material mulai diputar ketika pemutaran material sebelumnya dalam timeline berakhir. |
TimelineOut | Float | No | Waktu akhir material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, material berhenti diputar ketika pemutaran material berikutnya dalam timeline dimulai. |
Speed | Float | No | Kecepatan pemutaran material. Nilai yang valid: 0,1 hingga 100. Misalnya, jika Anda mengatur parameter ini ke 2, material diputar dengan kecepatan dua kali lipat dalam video output. Dalam hal ini, durasi material berkurang menjadi setengahnya. Untuk informasi lebih lanjut, lihat Ubah kecepatan audio dan video. |
Opacity | Float | No | Opasitas video. Nilai yang valid: 0 hingga 1. Nilai 0 menunjukkan bahwa video sepenuhnya transparan. Nilai 1 menunjukkan bahwa video sepenuhnya buram. |
MaskVideoUrl | String | No | URL file mask. Umumnya, file mask berupa video yang berisi saluran alpha. Anda dapat menggunakan saluran alpha untuk menambahkan informasi transparansi ke video asli.
|
ClipId | String | No | Nilai penyelarasan track. Jika nilai ReferenceClipId yang sama ditetapkan untuk material di track audio atau video lain, waktu mulai dan waktu akhir material di track lain dalam timeline akan diselaraskan dengan waktu mulai dan waktu akhir material saat ini. Untuk informasi selengkapnya, lihat Penyelarasan Material Secara Otomatis dan Panjang Material. |
ReferenceClipId | String | No | Nilai penyelarasan track. Jika nilai ClipId yang sama ditetapkan untuk material di track audio atau video lain, waktu mulai dan waktu akhir material saat ini dalam timeline akan diselaraskan dengan waktu mulai dan waktu akhir material di track lain. Untuk informasi lebih lanjut, lihat https://icms.alibaba-inc.com/content/ice/ims?l=1&m=65087&n=4406040. |
Effects | Effect[] | No | Efek yang digunakan pada material. |
Video manusia digital
Anda dapat mengatur Type ke AI_Avatar dalam VideoTrackClip untuk langsung menghasilkan video manusia digital yang siap diedit. Untuk informasi lebih lanjut, lihat Proses tugas timeline cerdas secara paralel.
Fitur ini hanya tersedia di wilayah China (Beijing), China (Shanghai), dan China (Hangzhou).
Parameter | Type | Required | Description | Remarks |
Type | String | Yes | Jenis material. |
|
MediaId | String | No | ID audio yang digunakan untuk rendering manusia digital. |
|
MediaURL | String | No | URL file audio yang digunakan untuk rendering manusia digital. |
|
Content | String | No | Konten teks yang digunakan untuk rendering manusia digital. |
|
AvatarId | String | No | ID gambar manusia digital. |
|
Voice | String | No | Jenis suara. |
|
CustomizedVoice | String | No | Suara manusia yang dipersonalisasi. |
|
LoopMotion | Boolean | No | Menentukan apakah frame pertama dan terakhir video sama. |
|
SpeechRate | Integer | No | Tempo bicara. |
Catatan Contoh berikut menunjukkan cara menghitung tempo bicara:
Jika kecepatan kurang dari 1x, gunakan koefisien 0,002. Jika kecepatan lebih dari 1x, gunakan koefisien 0,001. Hasil perhitungan aktual dibulatkan ke bilangan bulat terdekat. |
PitchRate | Integer | No | Intonasi. |
|
Parameter timeline lain untuk video manusia digital sama dengan parameter timeline VideoTrackClip. Untuk informasi lebih lanjut, lihat bagian VideoTrackClip topik ini.
AudioTrackClip
Material hanya-audio, material video yang berisi aliran audio, dan material audio yang dikonversi dari teks dapat ditambahkan ke audio track.
Gunakan parameter In, Out, TimelineIn, dan TimelineOut untuk menentukan posisi pemotongan material dan penempatannya di timeline. Misalnya, jika In diatur ke 5, Out ke 10, TimelineIn ke 15, dan TimelineOut ke 20, material dari detik ke-5 hingga ke-10 dipotong dan diputar dari detik ke-15 hingga ke-20 dalam timeline.
Waktu pemutaran material audio dalam satu audio track tidak boleh tumpang tindih di timeline. Jika terjadi tumpang tindih, kesalahan audio mungkin terjadi.
Material hanya-audio atau material video yang berisi aliran audio
Parameter | Type | Required | Description |
MediaId | String | No | ID aset media IMS atau ApsaraVideo VOD yang sesuai dengan material dalam audio track. Catatan: Anda hanya boleh menentukan salah satu dari MediaId dan MediaURL. |
MediaURL | String | No | URL OSS material dalam audio track. Format URL OSS adalah sebagai berikut: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4 Catatan:
Untuk informasi lebih lanjut, lihat Pengeditan gambar dan video. |
In | Float | No | Waktu mulai material dalam file sumber. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan In, nilai 0 digunakan. |
Out | Float | No | Waktu akhir material dalam file sumber. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan Out, material berakhir ketika file sumber berakhir. |
TimelineIn | Float | No | Waktu mulai material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, material mulai diputar ketika pemutaran material sebelumnya dalam timeline berakhir. |
TimelineOut | Float | No | Waktu akhir material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, material berhenti diputar ketika pemutaran material berikutnya dalam timeline dimulai. |
Speed | Float | No | Kecepatan pemutaran material. Nilai yang valid: 0,1 hingga 100. Misalnya, jika Anda mengatur parameter ini ke 2, material diputar dengan kecepatan dua kali lipat dalam audio output. Dalam hal ini, durasi material berkurang menjadi setengahnya. Untuk informasi lebih lanjut, lihat Ubah kecepatan audio dan video. |
Effects | Effect[] | No | Efek yang digunakan pada material. |
LoopMode | Boolean | No | Menentukan apakah putar ulang berulang diaktifkan untuk material dalam timeline. True: mengaktifkan putar ulang berulang. False (default): menonaktifkan putar ulang berulang. Untuk informasi lebih lanjut, lihat Konfigurasi putar ulang berulang audio. |
ClipId | String | No | Nilai penyelarasan track. Jika nilai ReferenceClipId yang sama ditetapkan untuk material di track audio atau video lain, waktu mulai dan waktu akhir material di track lain dalam timeline akan diselaraskan dengan waktu mulai dan waktu akhir material saat ini. Untuk informasi lebih lanjut, lihat Penyelarasan material dan durasi material secara otomatis. |
ReferenceClipId | String | No | Nilai penyelarasan track. Jika nilai ClipId yang sama ditetapkan untuk material di track audio atau video lain, waktu mulai dan waktu akhir material saat ini dalam timeline akan diselaraskan dengan waktu mulai dan waktu akhir material di track lain. Untuk informasi lebih lanjut, lihat Penyelarasan material dan durasi material secara otomatis. |
Material audio yang dikonversi dari teks
Untuk informasi lebih lanjut tentang contoh timeline, lihat Konversi teks menjadi audio dan tambahkan audio ke video. Fitur ini hanya tersedia di wilayah China (Beijing), China (Shanghai), dan China (Hangzhou).
Parameter | Type | Required | Description |
Type | String | Yes | Jenis material. Atur nilainya ke AI_TTS. |
Content | String | Yes | Konten teks. |
Voice | String | No | Jenis suara. Untuk informasi lebih lanjut, lihat Demo suara cerdas. |
CustomizedVoice | String | No |
|
Format | String | No | Format file. Nilai yang valid: pcm, wav, dan mp3. Nilai default: mp3.
|
SpeechRate | Int | No | Tempo bicara. Nilai yang valid: -500 hingga 500. Nilai default: 0.
Catatan Contoh berikut menunjukkan cara menghitung tempo bicara:
Jika kecepatan kurang dari 1x, gunakan koefisien 0,002. Jika kecepatan lebih dari 1x, gunakan koefisien 0,001. Hasil perhitungan aktual dibulatkan ke bilangan bulat terdekat. |
PitchRate | Int | No | Intonasi. Nilai yang valid: -500 hingga 500. Nilai default: 0. |
TimelineIn | Float | No | Waktu mulai material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, material mulai diputar ketika pemutaran material sebelumnya dalam timeline berakhir. |
TimelineOut | Float | No | Waktu akhir material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, material berhenti diputar ketika pemutaran material berikutnya dalam timeline dimulai. |
Effects | Effect[] | No | Efek yang digunakan pada material. |
ClipId | String | No | Nilai penyelarasan track. Jika nilai ReferenceClipId yang sama ditetapkan untuk material di track audio atau video lain, waktu mulai dan waktu akhir material di track lain dalam timeline akan diselaraskan dengan waktu mulai dan waktu akhir material saat ini. Untuk informasi lebih lanjut, lihat Penyelarasan material dan durasi material secara otomatis. |
ReferenceClipId | String | No | Nilai penyelarasan track. Jika nilai ClipId yang sama ditetapkan untuk material di track audio atau video lain, waktu mulai dan waktu akhir material saat ini dalam timeline akan diselaraskan dengan waktu mulai dan waktu akhir material di track lain. Untuk informasi lebih lanjut, lihat Penyelarasan material dan durasi material secara otomatis. |
ImageTrackClip
Kemampuan image track telah digabungkan ke dalam video track dan tidak lagi dikembangkan atau dipelihara.
Anda dapat menambahkan material gambar ke image track.
Parameter | Type | Required | Description |
MediaId | String | No | ID aset media IMS atau ApsaraVideo VOD yang sesuai dengan material dalam image track. Catatan: Anda hanya boleh menentukan salah satu dari MediaId dan MediaURL. |
MediaURL | String | No | URL OSS material dalam image track. Format URL OSS adalah sebagai berikut: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4. Catatan:
Untuk informasi lebih lanjut, lihat Ubah kecepatan audio dan video. |
X | Float | No | Jarak horizontal antara pojok kiri atas material dan pojok kiri atas video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
Y | Float | No | Jarak vertikal antara pojok kiri atas material dan pojok kiri atas video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
Width | Float | No | Lebar material dalam video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
Height | Float | No | Tinggi material dalam video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
TimelineIn | Float | No | Waktu mulai gambar dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, nilai 0 digunakan. |
TimelineOut | Float | No | Waktu akhir gambar dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, durasi maksimum video track digunakan. |
DyncFrames | Int | No | Jumlah frame stiker animasi. Parameter ini wajib ditentukan jika file sumber berupa gambar animasi. Untuk informasi lebih lanjut, lihat Tambahkan watermark, stiker, atau stiker GIF. |
Effects | Effect[] | No | Efek yang digunakan pada material. |
SubtitleTrackClip
Anda dapat menambahkan material subtitle ke subtitle track.
Waktu pemutaran material subtitle dalam satu subtitle track tidak boleh tumpang tindih di timeline. Jika terjadi tumpang tindih, masalah seperti kesalahan subtitle mungkin terjadi.
Parameter | Type | Required | Description |
Type | String | Yes | Jenis material subtitle. Nilai yang valid:
|
SubType | String | No | Subjenis material subtitle. Nilai yang valid:
Abaikan parameter ini jika Anda mengatur Type ke Text. |
FileURL | String | No | URL OSS file subtitle. Parameter ini wajib ditentukan jika Anda mengatur Type ke Subtitle. Format URL OSS adalah sebagai berikut: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.srt. Catatan:
Untuk informasi lebih lanjut, lihat Subtitle dan templat subtitle. |
X | Float | No | Jarak horizontal antara pojok kiri atas teks banner dan pojok kiri atas video output. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
Y | Float | No | Jarak vertikal antara pojok kiri atas teks banner dan pojok kiri atas video output. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
TimelineIn | Float | No | Waktu mulai teks banner dalam timeline. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, material mulai ditampilkan ketika tampilan material sebelumnya dalam timeline berakhir. |
TimelineOut | Float | No | Waktu akhir teks banner dalam timeline. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, material berhenti ditampilkan ketika tampilan material berikutnya dalam timeline dimulai. |
ClipId | Float | No | Parameter ini digunakan untuk menyelaraskan track. Jika ReferenceClipId material di track lain diatur ke nilai yang sama, waktu mulai dan waktu akhir material tersebut akan diselaraskan dengan klip saat ini. Jika Anda menentukan parameter ini, Anda harus menentukan TimelineIn dan TimelineOut untuk klip saat ini atau mengaktifkan durasi scrolling adaptif. |
ReferenceClipId | String | No | Parameter ini digunakan untuk menyelaraskan track. Jika ClipId material di track lain diatur ke nilai yang sama, waktu mulai dan waktu akhir klip saat ini akan diselaraskan dengan material tersebut. |
Content | String | No | Teks banner. Parameter ini wajib ditentukan jika Anda mengatur Type ke Text. |
Font | String | No | Font teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Nilai default: SimSun. Untuk informasi lebih lanjut tentang font yang didukung, lihat Daftar font. |
FontSize | Int | No | Ukuran font teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Nilai default: 0. Nilai maksimum: 5000. |
SizeRequestType | String | No | Metode perhitungan ukuran font yang dirender untuk teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Nilai default: RealDim.
|
FontColor | String | No | Warna teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Nilainya dalam format tanda pagar (#) dan nilai heksadesimal. Contoh: #ffffff. |
FontColorOpacity | Float | No | Opasitas teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Nilai yang valid: 0 hingga 1. Nilai default: 1. Nilai 1 menunjukkan bahwa teks sepenuhnya buram. Nilai 0 menunjukkan bahwa teks sepenuhnya transparan. |
FontFace | No | Tampilan teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. | |
Spacing | Int | No | Jarak spasi kata teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Satuan: piksel. Nilai default: 0. |
LineSpacing | Int | No | Jarak spasi baris teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Satuan: piksel. Nilai default: 0. |
Angle | Float | No | Sudut rotasi teks banner dalam arah berlawanan jarum jam. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Satuan: derajat. Nilai default: 0. |
BorderStyle | Int | No | Gaya border teks banner. Nilai yang valid: 1 dan 3. Nilai 1 menunjukkan bahwa teks memiliki border dan bayangan. Nilai 3 menunjukkan bahwa teks memiliki latar belakang. Nilai default: 1. |
Outline | Int | No | Lebar outline teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Satuan: piksel. Nilai default: 0. |
OutlineColour | String | No | Warna outline teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Nilainya dalam format tanda pagar (#) dan nilai heksadesimal. Contoh: #ffffff. |
Shadow | Int | No | Ukuran bayangan teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Satuan: piksel. Nilai default: 0. |
BackColour | String | No | Warna bayangan teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Nilainya dalam format tanda pagar (#) dan nilai heksadesimal. Contoh: #ffffff. |
Alignment | String | No | Mode penyelarasan teks. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Nilai default: TopLeft. Nilai yang valid:
Jika Anda ingin menentukan posisi subtitle yang akurat dalam mode penyelarasan berbeda, kami sarankan Anda mengonfigurasi penyelarasan teks sebagai berikut:
|
AdaptMode | String | No | Menentukan apakah line breaking otomatis atau scaling otomatis diaktifkan ketika teks banner melebihi lebar video atau lebar kotak teks yang ditentukan. Nilai yang valid:
|
TextWidth | Float | No | Lebar kotak teks. Parameter ini hanya berlaku jika Anda menentukan AdaptMode. Parameter ini digunakan saat Anda mengaktifkan line breaking otomatis atau scaling otomatis. Jika Anda tidak menentukan parameter ini, lebar video digunakan untuk line breaking otomatis atau scaling otomatis. Jika nilainya lebih besar dari 0 dan kurang dari atau sama dengan 1, nilai tersebut menunjukkan persentase lebar kotak teks terhadap lebar video output. Jika nilainya lebih besar dari 1, nilai tersebut menunjukkan jumlah piksel. |
FontUrl | String | No | URL OSS file font. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Format file font yang didukung: TTF, OTF, dan WOFF. Contoh: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf. |
EffectColorStyle | String | No | Efek seni kata teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Untuk informasi lebih lanjut tentang efek seni kata, lihat Seni kata. |
SubtitleEffects | No | Efek multilayer teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Anda dapat mengonfigurasi outline multilayer, bayangan multilayer, efek blur Gaussian, dan efek latar belakang subtitle. Efek blur Gaussian hanya didukung jika teks subtitle diatur memiliki bayangan. Catatan:
| |
EnableLocalStyleAutoScale | Boolean | No | Saat mengonfigurasi gaya lokal subtitle, apakah ukuran font, ukuran stroke, dan ukuran bayangan gaya lokal diskalakan dengan ukuran video output dan ukuran FECanvas. Nilai default adalah False, artinya gaya lokal tidak diskalakan. |
SupportBidi | Boolean | No | Apakah rendering teks dua arah diaktifkan. Saat teks subtitle berisi teks kiri-ke-kanan (LTR, seperti bahasa Inggris, angka, huruf Latin) dan teks kanan-ke-kiri (RTL), disarankan untuk mengaktifkannya. Secara default dinonaktifkan. |
ScrollStartY | Float | No | Nilai koordinat y titik awal untuk menggulir subtitle ke atas atau ke bawah. Parameter ini hanya berlaku jika efek pengguliran subtitle dikonfigurasi. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output. |
ScrollEndY | Float | No | Nilai koordinat y titik akhir untuk menggulir subtitle ke atas atau ke bawah. Parameter ini hanya berlaku jika efek pengguliran subtitle dikonfigurasi. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output. |
ScrollSpeed | Float | No | Kecepatan pengguliran subtitle ke atas atau ke bawah. Parameter ini hanya berlaku jika efek pengguliran subtitle dikonfigurasi. Satuan: piksel per detik. |
ScrollStartShift | Float | No | Offset posisi pengguliran vertikal relatif terhadap titik awal. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output. |
ScrollEndShift | Float | No | Offset posisi pengguliran vertikal relatif terhadap titik akhir. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output. |
ScrollStartFreeze | Float | No | Durasi jeda di titik awal untuk pengguliran vertikal. Satuan: detik. |
ScrollEndFreeze | Float | No | Durasi jeda di titik akhir untuk pengguliran vertikal. Satuan: detik. |
ScrollDirection | String | No | Arah pengguliran horizontal. Nilai yang valid:
|
ScrollStartX | Float | No | Nilai koordinat x titik awal untuk pengguliran horizontal. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output. |
ScrollEndX | Float | No | Nilai koordinat x titik akhir untuk pengguliran horizontal. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output. |
ScrollLoop | Boolean | No | Menentukan apakah efek pengguliran horizontal diulang. |
AaiMotionInEffect | String | No | Efek masuk teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Untuk informasi lebih lanjut tentang efek masuk subtitle, lihat Contoh efek subtitle. |
AaiMotionIn | Float | No | Durasi efek masuk teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan AaiMotionIn, durasi default 0,5 detik digunakan. Jika teks ditampilkan kurang dari 0,5 detik, durasi efek masuk adalah total durasi teks dikurangi durasi efek keluar. |
AaiMotionOutEffect | String | No | Efek keluar teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Untuk informasi lebih lanjut tentang efek keluar subtitle, lihat Contoh efek subtitle. |
AaiMotionOut | Float | No | Durasi efek keluar teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan AaiMotionOut, durasi default 0,5 detik digunakan. Jika teks ditampilkan kurang dari 0,5 detik, durasi efek keluar adalah total durasi teks. |
AaiMotionLoopEffect | String | No | Efek loop teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Efek loop tidak dapat berlaku bersamaan dengan efek masuk atau efek keluar. Untuk informasi lebih lanjut tentang efek loop teks, lihat Contoh efek subtitle. |
Ratio | Float | No | Kecepatan efek loop teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan parameter ini, nilai 1 digunakan. Nilai lebih dari 1 menunjukkan kecepatan lebih tinggi, dan nilai kurang dari 1 menunjukkan kecepatan lebih rendah. |
TextureURL | String | No | URL tekstur teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Hanya objek OSS dalam format PNG, JPG, JPEG, atau BMP yang didukung. Contoh: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png. |
BubbleStyleId | String | No | ID efek gelembung teks banner. Parameter ini hanya berlaku jika Anda mengatur Type ke Text. Untuk informasi lebih lanjut tentang efek gelembung, lihat Contoh efek gelembung teks. |
BubbleWidth | Float | No | Lebar peta dasar gelembung relatif terhadap video output. Parameter ini hanya berlaku jika subtitle gelembung digunakan. Nilai lebih dari 1 menunjukkan jumlah piksel. Nilai kurang dari atau sama dengan 1 menunjukkan persentase. |
BubbleHeight | Float | No | Tinggi peta dasar gelembung relatif terhadap video output. Parameter ini hanya berlaku jika subtitle gelembung digunakan. Nilai lebih dari 1 menunjukkan jumlah piksel. Nilai kurang dari atau sama dengan 1 menunjukkan persentase. |
EffectTrackItem
Anda dapat menambahkan efek visual dan filter ke effect track.
Parameter | Type | Required | Description |
Type | String | Yes | Jenis efek. Nilai yang valid: VFX dan Filter. |
SubType | String | Yes | Subjenis efek. |
TimelineIn | Float | No | Waktu mulai efek dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, nilai 0 digunakan. |
TimelineOut | Float | No | Waktu akhir efek dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, efek berakhir ketika video berakhir. |
Duration | Float | No | Durasi efek dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan Duration, durasi video digunakan. Anda tidak dapat menentukan Duration dan TimelineOut secara bersamaan. |
X | Float | No | Parameter ini hanya berlaku jika Anda mengatur SubType ke mosaic_rect/blur. Jarak horizontal antara pojok kiri atas area efek dan pojok kiri atas video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
Y | Float | No | Parameter ini hanya berlaku jika Anda mengatur SubType ke mosaic_rect/blur. Jarak vertikal antara pojok kiri atas area efek dan pojok kiri atas video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
Width | Float | No | Parameter ini hanya berlaku jika Anda mengatur SubType ke mosaic_rect/blur. Lebar area efek dalam video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
Height | Float | No | Parameter ini hanya berlaku jika Anda mengatur SubType ke mosaic_rect/blur. Tinggi area efek dalam video output. Anda dapat mengatur nilai sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel. |
SubtitleEffect
Anda dapat menambahkan outline atau bayangan ke subtitle track.
Parameter | Type | Required | Description |
Type | String | Yes | Jenis efek. Nilai yang valid: Outline, Shadow, dan Box.
|
Bord | Float | No | Lebar atau tinggi outline atau bayangan. Nilai lebih dari 1 menunjukkan jumlah piksel. Nilai lebih dari 0 dan kurang dari 1 menunjukkan lebar atau tinggi relatif terhadap ukuran teks. |
XBord | Float | No | Lebar outline atau bayangan. Nilai lebih dari 1 menunjukkan jumlah piksel. Nilai lebih dari 0 dan kurang dari 1 menunjukkan lebar relatif terhadap ukuran teks. Prioritas parameter ini lebih rendah daripada Bord. |
YBord | Float | No | Tinggi outline atau bayangan. Nilai lebih dari 1 menunjukkan jumlah piksel. Nilai lebih dari 0 dan kurang dari 1 menunjukkan tinggi relatif terhadap ukuran teks. Prioritas parameter ini lebih rendah daripada Bord. |
Shift | Float | No | Offset horizontal atau vertikal outline atau bayangan. Nilai absolut lebih dari 1 menunjukkan jumlah piksel. Nilai absolut lebih dari 0 dan kurang dari 1 menunjukkan offset relatif terhadap ukuran teks. Anda dapat mengatur parameter ini ke bilangan negatif, dan bilangan negatif menunjukkan offset ke atas atau ke kiri. |
XShift | Float | No | Offset horizontal outline atau bayangan. Nilai absolut lebih dari 1 menunjukkan jumlah piksel. Nilai absolut lebih dari 0 dan kurang dari 1 menunjukkan offset horizontal relatif terhadap ukuran teks. Prioritas parameter ini lebih rendah daripada Shift. |
YShift | Float | No | Offset vertikal outline atau bayangan. Nilai absolut lebih dari 1 menunjukkan jumlah piksel. Nilai absolut lebih dari 0 dan kurang dari 1 menunjukkan offset vertikal relatif terhadap ukuran teks. Prioritas parameter ini lebih rendah daripada Shift. |
Color | String | No | Warna RGB. Nilainya dalam format tanda pagar (#) dan nilai heksadesimal. Contoh: #ffffff. |
Opacity | String | No | Opasitas subtitle. Nilai 1 menunjukkan bahwa subtitle sepenuhnya buram. Nilai 0 menunjukkan bahwa subtitle sepenuhnya transparan. |
Blur | Float | No | Jangkauan blur Gaussian dalam piksel. Parameter ini hanya berlaku jika Anda mengatur Type ke Shadow. Setelah Anda mengonfigurasi parameter ini, outline subtitle berpendar. |
Radius | Float | No | Jari-jari border latar belakang warna solid teks. Parameter ini hanya berlaku jika Anda mengatur Type ke Box. Setelah Anda mengonfigurasi parameter ini, latar belakang subtitle memiliki sudut membulat. |
ImageUrl | String | No | URL gambar latar belakang subtitle kustom. Parameter ini hanya berlaku jika Anda mengatur Type ke Box. Setelah Anda mengonfigurasi parameter ini, efek gelembung kustom dapat diimplementasikan. Anda dapat menggunakan BubbleWidth atau BubbleHeight untuk mengubah ukuran subtitle. Hanya objek OSS dalam format PNG, JPG, JPEG, atau BMP yang didukung. Contoh: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png. |
Width | Float | No | Lebar peta dasar gelembung sumber. Parameter ini wajib ditentukan jika subtitle gelembung kustom digunakan. |
Height | Float | No | Tinggi peta dasar gelembung sumber. Parameter ini wajib ditentukan jika subtitle gelembung kustom digunakan. |
TextArea | String | No | Area teks pada basemap gelembung. Parameter ini wajib ditentukan jika menggunakan subjudul gelembung kustom. Area teks terdiri dari empat bilangan titik mengambang dengan nilai antara 0 hingga 1, dipisahkan koma (,). Sebagai contoh, jika Anda menetapkan nilai 0.1,0.2,0.8,0.6, maka koordinat sudut kiri atas kotak teks relatif terhadap gelembung adalah 0,1 dan 0,2, sedangkan lebar dan tinggi kotak teks relatif terhadap gelembung masing-masing adalah 0,8 dan 0,6. |
FontFace
Tabel berikut menjelaskan parameter gaya font.
Parameter | Type | Required | Description |
Bold | Boolean | No | Menentukan apakah font dicetak tebal. |
Italic | Boolean | No | Menentukan apakah font dicetak miring. |
Underline | Boolean | No | Menentukan apakah font diberi garis bawah. |
Effect
Efek material
Konfigurasikan parameter berikut untuk mendefinisikan efek. Beberapa parameter digunakan bersama oleh beberapa jenis efek.
Untuk informasi lebih lanjut tentang parameter efek, lihat Konfigurasi efek.
Tabel berikut menjelaskan parameter umum efek.
Parameter | Type | Required | Description |
Type | String | Yes | Jenis efek. Nilai yang valid:
|
SubType | String | No | Subjenis efek.
|