全部产品
Search

搜索本产品

    ：Konfigurasi timeline

    文档中心

    ：Konfigurasi timeline

    更新时间：Nov 11, 2025

    Timeline dibuat saat Anda menambahkan material dan mengonfigurasi efek untuk membuat video. Timeline terdiri dari track, material, dan efek. Untuk informasi lebih lanjut mengenai contoh timeline, lihat Praktik terbaik.

    Nama

    Tipe

    Wajib

    Deskripsi

    VideoTracks

    VideoTrack[]

    Tidak. Track video dan audio tidak boleh kosong secara bersamaan.

    Track video. Track video ditumpuk berdasarkan urutan elemen array MediaId. Misalnya, track yang sesuai dengan elemen array MediaId pertama ditempatkan di bawah track yang sesuai dengan elemen array MediaId kedua.

    AudioTracks

    AudioTrack[]

    Tidak. Track video dan audio tidak boleh kosong secara bersamaan.

    Track audio.

    ImageTracks (Kemampuan track gambar telah digabungkan ke dalam kemampuan track video dan tidak lagi diiterasi atau dipelihara.)

    ImageTrack[]

    Tidak. Jika track gambar ada, track video wajib disediakan.

    Track gambar. Catatan:

    1) Track gambar harus ditempatkan di atas track video. Jika gambar akan digabungkan dengan video sebagai material dalam skenario produksi gambar dan video, gunakan track video.

    2) Track gambar ditumpuk berdasarkan urutan elemen array MediaId. Misalnya, track yang sesuai dengan elemen array MediaId pertama ditempatkan di bawah track yang sesuai dengan elemen array MediaId kedua.

    SubtitleTracks

    SubtitleTrack[]

    Tidak

    Track subtitle.

    EffectTracks

    EffectTrack[]

    Tidak

    Track efek.

    VideoTrack

    VideoTrack digunakan untuk mengatur material video dan gambar.

    Nama

    Tipe

    Wajib

    Deskripsi

    Type

    String

    Tidak

    Jenis track video. Secara default, digunakan track video biasa.

    Jika Anda mengatur Type ke Effect, track video dapat digunakan untuk efek. Dalam hal ini, Anda dapat menentukan objek EffectTrackItem dalam VideoTrackClips.

    MainTrack

    Boolean

    Tidak

    Menentukan apakah track video saat ini merupakan track utama. Nilai default: False. Untuk informasi lebih lanjut, lihat Menetapkan track utama.

    TrackShortenMode

    String

    Tidak

    Jika durasi track video saat ini lebih panjang daripada durasi track utama, durasi track saat ini akan dipersingkat secara adaptif agar sejajar dengan durasi track utama. Parameter ini menentukan mode pemendekan track. Nilai yang valid:

    • AutoSpeed: Video dipercepat secara otomatis.

    TrackExpandMode

    String

    Tidak

    Jika durasi track video saat ini lebih pendek daripada durasi track utama, durasi track saat ini akan diperpanjang secara adaptif agar sejajar dengan durasi track utama. Parameter ini menentukan mode perpanjangan track. Nilai yang valid:

    • AutoSpeed: Video diperlambat secara otomatis.

    VideoTrackClips

    VideoTrackClip[]

    Ya

    Klip video.

    AudioTrack

    AudioTrack digunakan untuk mengatur material hanya-audio dan material video yang mengandung audio.

    Nama

    Tipe

    Wajib

    Deskripsi

    MainTrack

    Boolean

    Tidak

    Menentukan apakah track audio saat ini merupakan track utama. Nilai default: False. Untuk informasi lebih lanjut, lihat Menetapkan track utama.

    TrackShortenMode

    String

    Tidak

    Jika durasi track audio saat ini lebih panjang daripada durasi track utama, durasi track saat ini akan dipersingkat secara adaptif agar sejajar dengan durasi track utama. Parameter ini menentukan mode pemendekan track. Nilai yang valid:

    • AutoSpeed: Audio dipercepat secara otomatis.

    TrackExpandMode

    String

    Tidak

    Jika durasi track audio saat ini lebih pendek daripada durasi track utama, durasi track saat ini akan diperpanjang secara adaptif agar sejajar dengan durasi track utama. Parameter ini menentukan mode perpanjangan track. Nilai yang valid:

    • AutoSpeed: Audio diperlambat secara otomatis.

    AudioTrackClips

    AudioTrackClip[]

    Ya

    Material dalam track audio.

    ImageTrack

    Penting

    Kemampuan track gambar telah digabungkan ke dalam kemampuan VideoTrack dan tidak lagi diiterasi atau dipelihara.

    ImageTrack digunakan untuk mengatur material gambar.

    Nama

    Tipe

    Wajib

    Deskripsi

    ImageTrackClips (Kemampuan track gambar telah digabungkan ke dalam kemampuan track video dan tidak lagi diiterasi atau dipelihara.)

    ImageTrackClip[]

    Ya

    Material dalam track gambar.

    SubtitleTrack

    SubtitleTrack digunakan untuk mengatur subtitle, termasuk teks banner dan subtitle eksternal.

    Nama

    Tipe

    Wajib

    Deskripsi

    SubtitleTrackClips

    SubtitleTrackClip[]

    Ya

    Material dalam track subtitle.

    EffectTrack

    EffectTrack digunakan untuk menambahkan efek khusus ke video. Anda dapat menambahkan filter dan efek visual ke track efek.

    Nama

    Tipe

    Wajib

    Deskripsi

    EffectTrackItems

    EffectTrackItem[]

    Ya

    Daftar klip track efek.

    VideoTrackClip

    Anda dapat menambahkan video atau gambar ke VideoTrack.

    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, maka material dari detik ke-5 hingga ke-10 dipotong dan diputar dari detik ke-15 hingga ke-20 dalam timeline.

    Nama

    Tipe

    Wajib

    Deskripsi

    MediaId

    String

    Tidak

    ID aset media IMS atau VOD yang sesuai dengan material dalam track video.

    Catatan: Anda hanya boleh menentukan salah satu dari MediaId dan MediaURL.

    MediaURL

    String

    Tidak

    URL OSS material dalam track video. Format URL OSS adalah sebagai berikut:

    https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4

    Catatan:

    • Anda hanya boleh menentukan salah satu dari MediaId dan MediaURL.

    • Anda dapat menentukan URL OSS publik atau URL publik yang dapat diakses melalui Internet untuk parameter ini.

    Type

    String

    Tidak

    Jenis material. Nilai default: Video.

    Nilai yang valid:

    • Video

    • Image

    • GlobalImage: gambar global. Durasi gambar global sama dengan durasi track video.

    X

    Float

    Tidak

    Jarak horizontal antara pojok kiri atas gambar atau video dan pojok kiri atas video output. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    Y

    Float

    Tidak

    Jarak vertikal antara pojok kiri atas gambar atau video dan pojok kiri atas video output. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    Width

    Float

    Tidak

    Lebar gambar dalam video output. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    Height

    Float

    Tidak

    Tinggi gambar dalam video output. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    AdaptMode

    String

    Tidak

    Mode penyesuaian 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:

    • Contain: mengubah ukuran material berdasarkan rasio aspek asli material.

    • Cover: mengubah ukuran material berdasarkan rasio aspek asli untuk mengisi tampilan dan memotong bagian yang melimpah. Jika rasio aspek objek tidak sesuai dengan tampilan, objek dipotong berdasarkan lebar dan tinggi tampilan.

    • Fill (default): mengubah ukuran material berdasarkan rasio aspek asli dan meregangkan material agar mengisi tampilan. Objek sepenuhnya mengisi tampilan. Jika rasio aspek objek tidak sesuai dengan tampilan, objek diregangkan berdasarkan lebar dan tinggi tampilan.

    In

    Float

    Tidak

    Waktu mulai material dalam file sumber. Parameter ini hanya berlaku jika file sumber berupa file audio atau video. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan In, nilai default 0 digunakan.

    Out

    Float

    Tidak

    Waktu akhir material dalam file sumber. Parameter ini hanya berlaku jika file sumber berupa file audio atau video. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan Out, material berakhir saat file sumber berakhir.

    MaxOut

    Float

    Tidak

    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 Mengedit gambar dan video.

    Duration

    Float

    Tidak

    Durasi material. Dalam kebanyakan kasus, parameter ini digunakan untuk gambar. Satuan: detik. Nilai akurat hingga empat tempat desimal.

    DyncFrames

    Int

    Tidak

    Jumlah frame stiker animasi. Parameter ini hanya berlaku jika file sumber berupa gambar animasi. Untuk informasi lebih lanjut, lihat Menambahkan stiker GIF.

    TimelineIn

    Float

    Tidak

    Waktu mulai material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, material ditampilkan saat tampilan material sebelumnya dalam timeline berakhir.

    TimelineOut

    Float

    Tidak

    Waktu akhir material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, tampilan material berhenti saat tampilan material berikutnya dalam timeline dimulai.

    Speed

    Float

    Tidak

    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 dari kecepatan aslinya dalam video output. Dalam hal ini, durasi material berkurang menjadi setengahnya.

    Opacity

    Float

    Tidak

    Opasitas video. Nilai yang valid: 0 hingga 1. Nilai 0 menunjukkan bahwa video sepenuhnya transparan. Nilai 1 menunjukkan bahwa video sepenuhnya buram.

    MaskVideoUrl

    String

    Tidak

    URL file masker. Dalam kebanyakan kasus, file masker adalah video yang berisi saluran alfa. Anda dapat menggunakan saluran alfa untuk menambahkan informasi transparansi ke video asli.

    • Anda dapat menentukan URL OSS publik atau URL publik yang dapat diakses melalui Internet untuk parameter ini.

    ClipId

    String

    Tidak

    Nilai penyelarasan track. Jika nilai ReferenceClipId yang sama ditetapkan untuk material di track audio atau video lainnya, waktu mulai dan waktu akhir material di track lainnya dalam timeline diselaraskan dengan waktu mulai dan waktu akhir material saat ini.

    Untuk informasi lebih lanjut, lihat Menyelaraskan material dan durasi material secara otomatis

    ReferenceClipId

    String

    Tidak

    Nilai penyelarasan track. Jika nilai ClipId yang sama ditetapkan untuk material di track audio atau video lainnya, waktu mulai dan waktu akhir material saat ini dalam timeline diselaraskan dengan waktu mulai dan waktu akhir material di track lainnya.

    Untuk informasi lebih lanjut, lihat Menyelaraskan material dan durasi material secara otomatis

    Effects

    Effect[]

    Tidak

    Efek khusus yang digunakan pada material.

    Video manusia digital

    Anda dapat mengatur Type menjadi AI_Avatar dalam VideoTrackClip untuk langsung menghasilkan video manusia digital yang siap diedit. Untuk informasi lebih lanjut, lihat Memproses tugas timeline cerdas secara paralel.

    Catatan

    Fitur ini hanya tersedia di wilayah Tiongkok (Beijing), Tiongkok (Shanghai), dan Tiongkok (Hangzhou).

    Nama

    Tipe

    Wajib

    Deskripsi

    Keterangan

    Type

    String

    Ya

    Jenis klip saat ini

    • Atur nilainya ke AI_Avatar.

    MediaId

    String

    Tidak

    ID audio yang digunakan untuk merender manusia digital.

    • Anda hanya boleh menentukan salah satu dari MediaId, MediaURL, dan Content.

    MediaURL

    String

    Tidak

    URL file audio yang digunakan untuk merender manusia digital.

    • Anda hanya boleh menentukan salah satu dari MediaId, MediaURL, dan Content.

    • Anda dapat menentukan URL OSS publik atau URL publik yang dapat diakses melalui Internet untuk parameter ini.

    Content

    String

    Tidak

    Konten teks yang digunakan untuk merender manusia digital.

    • Anda hanya boleh menentukan salah satu dari MediaId, MediaURL, dan Content.

    • Nilai parameter ini harus berisi minimal lima karakter.

    AvatarId

    String

    Tidak

    ID citra manusia digital.

    Voice

    String

    Tidak

    Jenis suara.

    • Parameter ini berlaku jika Anda menentukan Content.

    • Untuk efek suara, lihat Contoh suara cerdas.

    CustomizedVoice

    String

    Tidak

    Suara manusia personalisasi.

    • Tentukan ID suara yang dilatih menggunakan fitur kloning suara manusia. Anda dapat menggunakan suara manusia personalisasi Anda untuk menghasilkan audio.

    • Jika Anda menentukan parameter ini, Voice menjadi tidak berlaku.

    LoopMotion

    Boolean

    Tidak

    Frame pertama dan terakhir identik

    • Jika Anda mengatur parameter ini ke true, frame pertama dan terakhir video yang dihasilkan untuk manusia digital akan sama. Hal ini mencegah lompatan frame pada gerakan dan ekspresi manusia digital selama putar ulang berulang atau saat video manusia digital digabungkan.

    • Nilai yang valid: {true, false}

    • Nilai default: false

    SpeechRate

    Integer

    Tidak

    Tempo bicara.

    • Parameter ini berlaku jika Anda menentukan Content. Nilai yang valid: [-500, 500]. Nilai default: 0.

      • Nilai -500 menunjukkan bahwa tempo bicara adalah 0,5 kali tempo bicara asli. Nilai 0 menunjukkan bahwa tempo bicara asli digunakan. Nilai 500 menunjukkan bahwa tempo bicara adalah 2 kali tempo bicara asli.

    Catatan

    Metode perhitungannya adalah sebagai berikut:

    • Kecepatan 0,8×: (1 - 1/0,8) / 0,002 = -125

    • 1,2: (1-1/1,2)/0,001 = 166

    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

    Tidak

    Intonasi.

    • Parameter ini berlaku jika Anda menentukan Content.

    • Nilai yang valid: [-500, 500]

    • Nilai default: 0

    Catatan

    Parameter timeline lainnya untuk video manusia digital sama dengan parameter VideoTrackClip. Untuk informasi lebih lanjut, lihat bagian VideoTrackClip dalam topik ini.

    AudioTrackClip

    Anda dapat menambahkan material berikut ke AudioTrack: material hanya-audio, material video yang mengandung aliran audio, dan material audio yang dikonversi dari teks.

    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, maka material dari detik ke-5 hingga ke-10 dipotong dan diputar dari detik ke-15 hingga ke-20 dalam timeline.

    Catatan

    Waktu pemutaran material audio dalam satu AudioTrack tidak boleh tumpang tindih di timeline. Jika terjadi tumpang tindih, kesalahan audio mungkin terjadi.

    Material hanya-audio atau material video yang mengandung aliran audio

    Nama

    Tipe

    Wajib

    Deskripsi

    MediaId

    String

    Tidak

    ID aset media IMS atau VOD yang sesuai dengan material dalam track audio.

    Catatan: Anda hanya boleh menentukan salah satu dari MediaId dan MediaURL.

    MediaURL

    String

    Tidak

    URL OSS material dalam track audio. Format URL OSS adalah sebagai berikut:

    https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4

    Catatan:

    • Anda hanya boleh menentukan salah satu dari MediaId dan MediaURL.

    • Anda dapat menentukan URL OSS publik atau URL publik yang dapat diakses melalui Internet untuk parameter ini.

    In

    Float

    Tidak

    Waktu mulai material dalam file sumber. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan In, nilai default 0 digunakan.

    Out

    Float

    Tidak

    Waktu akhir material dalam file sumber. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan Out, material berakhir saat file sumber berakhir.

    TimelineIn

    Float

    Tidak

    Waktu mulai material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, material ditampilkan saat tampilan material sebelumnya dalam timeline berakhir.

    TimelineOut

    Float

    Tidak

    Waktu akhir material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, tampilan material berhenti saat tampilan material berikutnya dalam timeline dimulai.

    Speed

    Float

    Tidak

    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 dari kecepatan aslinya dalam audio output. Dalam hal ini, durasi material berkurang menjadi setengahnya.

    Effects

    Effect[]

    Tidak

    Efek yang digunakan pada material.

    LoopMode

    Boolean

    Tidak

    Menentukan apakah akan mengaktifkan putar ulang berulang untuk material dalam timeline. True: mengaktifkan putar ulang berulang. False (default): menonaktifkan putar ulang berulang.

    Untuk informasi lebih lanjut, lihat Mengonfigurasi putar ulang berulang audio

    ClipId

    String

    Tidak

    Parameter penyelarasan track. Jika material di track audio atau video lainnya diatur dengan ReferenceClipId yang sama, waktu mulai dan waktu akhirnya dalam timeline diselaraskan dengan klip saat ini.

    Untuk informasi lebih lanjut, lihat Menyelaraskan material dan durasi material secara otomatis.

    ReferenceClipId

    String

    Tidak

    Nilai penyelarasan track. Jika nilai ClipId yang sama ditetapkan untuk material di track audio atau video lainnya, waktu mulai dan waktu akhir material saat ini dalam timeline diselaraskan dengan waktu mulai dan waktu akhir material di track lainnya.

    Untuk informasi lebih lanjut, lihat Menyelaraskan material dan durasi material secara otomatis

    Material audio yang dikonversi dari teks

    Untuk informasi lebih lanjut mengenai contoh timeline, lihat Mengonversi teks menjadi audio dan menambahkan audio ke video. Fitur ini hanya tersedia di wilayah Tiongkok (Beijing), Tiongkok (Shanghai), dan Tiongkok (Hangzhou).

    Nama

    Tipe

    Wajib

    Deskripsi

    Type

    String

    Ya

    Atur nilainya ke AI_TTS.

    Content

    String

    Ya

    Konten teks.

    Voice

    String

    Tidak

    Contoh suara cerdas

    CustomizedVoice

    String

    Tidak

    • Suara manusia personalisasi.

    • Tentukan ID suara yang dilatih menggunakan fitur kloning suara manusia. Anda dapat menggunakan suara manusia personalisasi Anda untuk menghasilkan audio.

    • Jika Anda menentukan parameter ini, Voice menjadi tidak berlaku.

    Format

    String

    Tidak

    Format file. Nilai default: mp3.

    Nilai yang valid: PCM, WAV, dan MP3.

    SpeechRate

    Int

    Tidak

    Tempo bicara. Nilai yang valid: -500 hingga 500. Nilai default: 0.

    • Nilai -500 menunjukkan bahwa tempo bicara adalah 0,5 kali tempo bicara asli. Nilai 0 menunjukkan bahwa tempo bicara asli digunakan. Nilai 500 menunjukkan bahwa tempo bicara adalah 2 kali tempo bicara asli. Secara default, tempo bicara output model adalah 1x. Tempo bicara bervariasi berdasarkan pembicara. Dalam kebanyakan kasus, seorang pembicara mengucapkan empat karakter per detik.

    Catatan

    Metode perhitungannya adalah sebagai berikut:

    • Kecepatan 0,8× (1-1/0,8)/0,002 = -125

    • 1,2: (1-1/1,2)/0,001 = 166

    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

    Tidak

    Intonasi. Nilai yang valid: -500 hingga 500. Nilai default: 0.

    TimelineIn

    Float

    Tidak

    Waktu mulai material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, material ditampilkan saat tampilan material sebelumnya dalam timeline berakhir.

    TimelineOut

    Float

    Tidak

    Waktu akhir material dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, tampilan material berhenti saat tampilan material berikutnya dalam timeline dimulai.

    Effects

    Effect[]

    Tidak

    Efek yang digunakan pada material.

    ClipId

    String

    Tidak

    Nilai penyelarasan track. Jika nilai ReferenceClipId yang sama ditetapkan untuk material di track audio atau video lainnya, waktu mulai dan waktu akhir material di track lainnya dalam timeline diselaraskan dengan waktu mulai dan waktu akhir material saat ini.

    Untuk informasi lebih lanjut, lihat Menyelaraskan material dan durasi material secara otomatis

    ReferenceClipId

    String

    Tidak

    Nilai penyelarasan track. Jika nilai ClipId yang sama ditetapkan untuk material di track audio atau video lainnya, waktu mulai dan waktu akhir material saat ini dalam timeline diselaraskan dengan waktu mulai dan waktu akhir material di track lainnya.

    Untuk informasi lebih lanjut, lihat Menyelaraskan material dan durasi material secara otomatis

    ImageTrackClip

    Penting

    Kemampuan track gambar telah digabungkan ke dalam kemampuan VideoTrack dan tidak lagi diiterasi atau dipelihara.

    Ruang lingkup ImageTrackClip mencakup aset gambar.

    Nama

    Tipe

    Wajib

    Deskripsi

    MediaId

    String

    Tidak

    ID aset media IMS atau VOD yang sesuai dengan material dalam track gambar.

    Catatan: Anda hanya boleh menentukan salah satu dari MediaId dan MediaURL.

    MediaURL

    String

    Tidak

    URL OSS material dalam track gambar. Format URL OSS adalah sebagai berikut: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4

    Catatan:

    • Anda hanya boleh menentukan salah satu dari MediaId dan MediaURL.

    • Anda hanya dapat menentukan URL OSS publik untuk parameter ini.

    X

    Float

    Tidak

    Jarak horizontal antara pojok kiri atas gambar dan pojok kiri atas video output. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    Y

    Float

    Tidak

    Jarak vertikal antara pojok kiri atas gambar dan pojok kiri atas video output. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    Width

    Float

    Tidak

    Lebar gambar dalam video output. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    Height

    Float

    Tidak

    Tinggi gambar dalam video output. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    TimelineIn

    Float

    Tidak

    Waktu mulai gambar dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, nilai default 0 digunakan.

    TimelineOut

    Float

    Tidak

    Waktu akhir gambar dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, durasi maksimum track video digunakan.

    DyncFrames

    Int

    Tidak

    Jumlah frame stiker animasi. Parameter ini wajib jika file sumber berupa gambar animasi. Untuk informasi lebih lanjut, lihat Menambahkan stiker GIF.

    Effects

    Effect[]

    Tidak

    Efek yang digunakan pada material.

    SubtitleTrackClip

    Anda dapat menambahkan material subtitle ke SubtitleTrack.

    Catatan

    Waktu pemutaran material subtitle dalam satu SubtitleTrack tidak boleh tumpang tindih di timeline. Jika terjadi tumpang tindih, masalah seperti kesalahan subtitle mungkin terjadi.

    Nama

    Tipe

    Wajib

    Deskripsi

    Type

    String

    Ya

    Jenis material subtitle. Nilai yang valid:

    SubType

    String

    Tidak

    Subjenis material subtitle. Nilai yang valid:

    • srt: file subtitle eksternal dalam format SubRip Subtitle (SRT)

    • ass: file subtitle eksternal dalam format Advanced SubStation Alpha (ASS)

    Abaikan parameter ini jika Anda mengatur Type ke Text.

    FileURL

    String

    Tidak

    URL OSS file subtitle. Parameter ini wajib jika Anda mengatur Type ke Subtitle. Format URL OSS adalah sebagai berikut:

    https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.srt

    Catatan:

    • Anda dapat menentukan URL OSS publik atau URL publik yang dapat diakses melalui Internet untuk parameter ini.

    Contoh: Keterangan eksternal

    X

    Float

    Tidak

    Jarak horizontal antara pojok kiri atas teks banner dan pojok kiri atas video output. Parameter ini berlaku jika Anda mengatur Type ke Text. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    Y

    Float

    Tidak

    Jarak vertikal antara pojok kiri atas teks banner dan pojok kiri atas video output. Parameter ini berlaku jika Anda mengatur Type ke Text. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    TimelineIn

    Float

    Tidak

    Waktu mulai teks banner dalam timeline. Parameter ini berlaku jika Anda mengatur Type ke Text. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, material ditampilkan saat tampilan material sebelumnya dalam timeline berakhir.

    TimelineOut

    Float

    Tidak

    Waktu akhir teks banner dalam timeline. Parameter ini berlaku jika Anda mengatur Type ke Text. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, tampilan material berhenti saat tampilan material berikutnya dalam timeline dimulai.

    ClipId

    String

    Tidak

    Nilai penyelarasan track. Jika nilai ReferenceClipId yang sama ditetapkan untuk material di track audio, video, atau subtitle lainnya, waktu mulai dan waktu akhir material di track lainnya dalam timeline diselaraskan dengan waktu mulai dan waktu akhir material saat ini.

    • Anda harus menentukan TimelineIn dan TimelineOut untuk klip saat ini atau mengaktifkan durasi pengguliran adaptif.

    ReferenceClipId

    String

    Tidak

    Nilai penyelarasan track. Jika nilai ClipId yang sama ditetapkan untuk material di track audio, video, atau subtitle lainnya, waktu mulai dan waktu akhir material saat ini dalam timeline diselaraskan dengan waktu mulai dan waktu akhir material di track lainnya.

    Content

    String

    Tidak

    Teks banner. Parameter ini wajib jika Anda mengatur Type ke Text.

    Font

    String

    Tidak

    Font teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Nilai default: SimSun. Untuk informasi lebih lanjut mengenai font yang didukung, lihat Font.

    FontSize

    Int

    Tidak

    Ukuran font teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Nilai default: 0. Nilai maksimum: 5000.

    SizeRequestType

    String

    Tidak

    Metode perhitungan ukuran font yang dirender untuk teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Nilai default: RealDim.

    • Nominal: Tinggi rendering subtitle (dalam piksel) sama dengan ukuran font.

    • RealDim: Untuk beberapa font, tinggi rendering subtitle (dalam piksel) mungkin kurang dari ukuran font.

    FontColor

    String

    Tidak

    Warna teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Nilainya dalam format tanda pagar (#) dan nilai heksadesimal. Contoh: #ffffff.

    FontColorOpacity

    Float

    Tidak

    Opasitas teks banner. Parameter ini 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

    FontFace

    Tidak

    Penampilan font. Parameter ini berlaku jika Anda mengatur Type ke Text.

    Spacing

    Int

    Tidak

    Jarak antar kata teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Satuan: piksel. Nilai default: 0.

    LineSpacing

    Int

    Tidak

    Jarak antar baris teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Satuan: piksel. Nilai default: 0.

    Angle

    Float

    Tidak

    Sudut rotasi teks banner dalam arah berlawanan jarum jam. Parameter ini berlaku jika Anda mengatur Type ke Text. Satuan: derajat. Nilai default: 0.

    BorderStyle

    Int

    Tidak

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

    Outline

    Int

    Tidak

    Lebar garis luar teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Satuan: piksel. Nilai default: 0.

    OutlineColour

    String

    Tidak

    Warna garis luar teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Nilainya dalam format tanda pagar (#) dan nilai heksadesimal. Contoh: #ffffff.

    Shadow

    Int

    Tidak

    Ukuran bayangan teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Satuan: piksel. Nilai default: 0.

    BackColour

    String

    Tidak

    Warna bayangan teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Nilainya dalam format tanda pagar (#) dan nilai heksadesimal. Contoh: #ffffff.

    Alignment

    String

    Tidak

    Mode penyelarasan teks. Parameter ini berlaku jika Anda mengatur Type ke Text. Nilai default: TopLeft. Nilai yang valid:

    • TopLeft: Pojok kiri atas video.

    • TopCenter: Bagian atas sumbu vertikal video.

    • TopRight: Pojok kanan atas video.

    • CenterLeft: Area di sebelah kiri garis tengah horizontal video.

    • CenterCenter: Posisi tengah video.

    • CenterRight

    • BottomLeft

    • BottomCenter: Bagian bawah sumbu tengah vertikal video.

    • BottomRight

    Jika Anda ingin menentukan posisi subtitle yang akurat dalam berbagai mode penyelarasan, kami menyarankan Anda mengonfigurasi penyelarasan teks dengan cara berikut:

    • Penyelarasan kiri: Tentukan koordinat vertex kiri atas subtitle relatif terhadap pojok kiri atas video untuk X dan Y.

    • Penyelarasan tengah: Tentukan koordinat perpotongan batas pada sumbu pusat subtitle relatif terhadap pojok kiri atas video untuk X dan Y.

    • Penyelarasan kanan: Tentukan koordinat vertex kanan atas subtitle relatif terhadap pojok kiri atas video untuk X dan Y.

    AdaptMode

    String

    Tidak

    Menentukan apakah akan mengaktifkan pemutusan baris otomatis atau penskalaan otomatis saat teks banner melebihi lebar video atau lebar kotak teks yang ditentukan. Nilai yang valid:

    • AutoWrap: mengaktifkan pemutusan baris otomatis.

    • AutoScale: mengaktifkan penskalaan otomatis.

    • AutoWrapAtSpaces: mengaktifkan pemutusan baris otomatis dan hanya memutus teks pada posisi spasi. Opsi ini hanya berlaku untuk teks bahasa Inggris.

    • AutoWrapAtSpacesStrict: secara ketat mengikuti batas untuk pemutusan baris pada spasi guna menghindari distribusi karakter yang tidak merata. Pemutusan baris terjadi saat panjang margin tercapai.

    TextWidth

    Float

    Tidak

    Lebar kotak teks. Parameter ini berlaku jika Anda menentukan AdaptMode. Parameter ini digunakan saat Anda mengaktifkan pemutusan baris otomatis atau penskalaan otomatis. Jika Anda tidak menentukan parameter ini, lebar video digunakan untuk pemutusan baris otomatis atau penskalaan 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

    Tidak

    URL OSS file font. Parameter ini 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

    Tidak

    Efek seni kata teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Untuk informasi lebih lanjut mengenai efek seni kata, lihat Contoh efek seni kata.

    SubtitleEffects

    SubtitleEffect[]

    Tidak

    Efek multilapis teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Anda dapat mengonfigurasi garis luar multilapis, bayangan multilapis, efek buram Gaussian, dan efek latar belakang subtitle. Efek buram Gaussian hanya didukung jika teks subtitle diatur untuk memiliki bayangan.

    Catatan:

    • Jika Anda menentukan SubtitleEffects, Outline dan Shadow dalam SubtitleTrackClip menjadi tidak berlaku.

    • Jika Anda mengonfigurasi garis luar multilapis, bayangan multilapis, atau efek latar belakang subtitle, efek subtitle ditumpuk berdasarkan urutan elemen array SubtitleEffects. Lapisan yang sesuai dengan efek subtitle pertama dalam array ditempatkan di bagian bawah, dan lapisan yang sesuai dengan efek subtitle terakhir dalam array ditempatkan di bagian atas.

    ScrollStartY

    Float

    Tidak

    Nilai koordinat y titik awal untuk menggulir subtitle ke atas atau ke bawah. Parameter ini berlaku jika efek pengguliran subtitle dikonfigurasi. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output.

    ScrollEndY

    Float

    Tidak

    Nilai koordinat y titik akhir untuk menggulir subtitle ke atas atau ke bawah. Parameter ini berlaku jika efek pengguliran subtitle dikonfigurasi. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output.

    ScrollSpeed

    Float

    Tidak

    Kecepatan pengguliran subtitle ke atas atau ke bawah. Parameter ini berlaku jika efek pengguliran subtitle dikonfigurasi. Satuan: piksel per detik.

    ScrollStartShift

    Float

    Tidak

    Offset posisi pengguliran vertikal relatif terhadap titik awal. Parameter ini berlaku jika pengguliran subtitle vertikal dikonfigurasi. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output.

    ScrollEndShift

    Float

    Tidak

    Offset posisi pengguliran vertikal relatif terhadap titik akhir. Parameter ini berlaku jika pengguliran subtitle vertikal dikonfigurasi. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output.

    ScrollStartFreeze

    Float

    Tidak

    Durasi jeda di titik awal untuk pengguliran vertikal. Parameter ini berlaku jika pengguliran subtitle vertikal dikonfigurasi. Satuan: detik.

    ScrollEndFreeze

    Float

    Tidak

    Durasi jeda di titik akhir untuk pengguliran vertikal. Parameter ini berlaku jika pengguliran subtitle vertikal dikonfigurasi. Satuan: detik.

    ScrollDirection

    String

    Tidak

    Arah pengguliran horizontal. Parameter ini berlaku jika pengguliran subtitle horizontal dikonfigurasi. Nilai yang valid:

    • Left: menggulir ke kiri

    • Right: menggulir ke kanan

    ScrollStartX

    Float

    Tidak

    Nilai koordinat x titik awal untuk pengguliran horizontal. Parameter ini berlaku jika pengguliran subtitle horizontal dikonfigurasi. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output.

    ScrollEndX

    Float

    Tidak

    Nilai koordinat x titik akhir untuk pengguliran horizontal. Parameter ini berlaku jika pengguliran subtitle horizontal dikonfigurasi. Satuan: piksel. Jika nilainya kurang dari 1, nilai tersebut merepresentasikan ukuran relatif terhadap tinggi video output.

    ScrollLoop

    Boolean

    Tidak

    Menentukan apakah akan mengulang efek pengguliran horizontal. Parameter ini berlaku jika pengguliran subtitle horizontal dikonfigurasi.

    AaiMotionInEffect

    String

    Tidak

    Efek masuk teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Untuk informasi lebih lanjut mengenai efek masuk subtitle, lihat Contoh efek subtitle.

    AaiMotionIn

    Float

    Tidak

    Durasi efek masuk teks banner. Parameter ini 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 durasi total teks dikurangi durasi efek keluar.

    AaiMotionOutEffect

    String

    Tidak

    Efek keluar teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Untuk informasi lebih lanjut mengenai efek keluar subtitle, lihat Contoh efek subtitle.

    AaiMotionOut

    Float

    Tidak

    Durasi efek keluar teks banner. Parameter ini 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 durasi total teks.

    AaiMotionLoopEffect

    String

    Tidak

    Efek loop teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Efek loop tidak dapat berlaku bersamaan dengan efek masuk atau efek keluar. Untuk informasi lebih lanjut mengenai efek loop teks, lihat Contoh efek subtitle.

    Ratio

    Float

    Tidak

    Kecepatan efek loop teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan parameter ini, nilai default 1 digunakan. Nilai lebih dari 1 menunjukkan kecepatan loop lebih tinggi, dan nilai kurang dari 1 menunjukkan kecepatan loop lebih rendah.

    TextureURL

    String

    Tidak

    URL tekstur teks banner. Parameter ini 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

    Tidak

    ID efek gelembung teks banner. Parameter ini berlaku jika Anda mengatur Type ke Text. Untuk informasi lebih lanjut mengenai efek gelembung, lihat Contoh gelembung teks.

    BubbleWidth

    Float

    Tidak

    Lebar peta dasar gelembung relatif terhadap video output. Parameter ini hanya berlaku jika menggunakan subtitle gelembung. Nilai lebih dari 1 menunjukkan jumlah piksel. Nilai kurang dari atau sama dengan 1 menunjukkan persentase.

    BubbleHeight

    Float

    Tidak

    Tinggi peta dasar gelembung relatif terhadap video output. Parameter ini hanya berlaku jika menggunakan subtitle gelembung. 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 EffectTrack.

    Nama

    Tipe

    Wajib

    Deskripsi

    Type

    String

    Ya

    Jenis efek khusus. Nilai yang valid: VFX dan Filter.

    SubType

    String

    Ya

    Subjenis efek khusus. Untuk informasi lebih lanjut, lihat:

    Contoh efek visual

    Contoh efek filter

    TimelineIn

    Float

    Tidak

    Waktu mulai efek khusus dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineIn, nilai default 0 digunakan.

    TimelineOut

    Float

    Tidak

    Waktu akhir efek khusus dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan TimelineOut, efek berakhir saat video berakhir.

    Duration

    Float

    Tidak

    Durasi efek khusus dalam timeline. Satuan: detik. Nilai akurat hingga empat tempat desimal. Jika Anda tidak menentukan Duration, durasi video digunakan.

    Anda dapat menentukan Duration atau TimelineOut.

    X

    Float

    Tidak

    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 nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    Y

    Float

    Tidak

    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 nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    Width

    Float

    Tidak

    Parameter ini hanya berlaku jika Anda mengatur SubType ke mosaic_rect/blur. Lebar area efek dalam video output. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    Height

    Float

    Tidak

    Parameter ini hanya berlaku jika Anda mengatur SubType ke mosaic_rect/blur. Tinggi area efek dalam video output. Anda dapat mengatur nilainya sebagai persentase atau jumlah piksel. Jika nilainya berkisar antara 0 hingga 0,9999, nilai tersebut menunjukkan persentase. Jika nilainya bilangan bulat yang lebih besar atau sama dengan 2, nilai tersebut menunjukkan jumlah piksel.

    SubtitleEffect

    Anda dapat menambahkan garis luar atau bayangan ke SubtitleTrack.

    Nama

    Tipe

    Wajib

    Deskripsi

    Type

    String

    Ya

    -Outline: garis luar

    -Shadow: bayangan

    -Box: kotak latar belakang subtitle

    Bord

    Float

    Tidak

    Lebar atau tinggi garis luar 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

    Tidak

    Lebar garis luar 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 tinggi daripada Bord.

    YBord

    Float

    Tidak

    Tinggi garis luar 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 tinggi daripada Bord.

    Shift

    Float

    Tidak

    Offset horizontal atau vertikal garis luar 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

    Tidak

    Offset horizontal garis luar 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 tinggi daripada Shift.

    YShift

    Float

    Tidak

    Offset vertikal garis luar 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 tinggi daripada Shift.

    Color

    String

    Tidak

    Warna RGB. Nilainya dalam format tanda pagar (#) dan nilai heksadesimal. Contoh: #ffffff.

    Opacity

    String

    Tidak

    Opasitas. Nilai 1 menunjukkan bahwa subtitle sepenuhnya buram. Nilai 0 menunjukkan bahwa subtitle sepenuhnya transparan.

    Blur

    Float

    Tidak

    Jangkauan efek buram Gaussian dalam piksel. Parameter ini hanya berlaku jika Anda mengatur Type ke Shadow. Setelah Anda mengonfigurasi parameter ini, garis luar subtitle akan berpendar.

    Radius

    Float

    Tidak

    Jari-jari sudut latar belakang warna solid teks. Parameter ini hanya berlaku jika Anda mengatur Type ke Box. Setelah Anda mengonfigurasi parameter ini, latar belakang subtitle akan memiliki sudut membulat.

    ImageUrl

    String

    Tidak

    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

    Tidak

    Lebar peta dasar gelembung sumber. Parameter ini wajib jika menggunakan subtitle gelembung kustom.

    Height

    Float

    Tidak

    Tinggi peta dasar gelembung sumber. Parameter ini wajib jika menggunakan subtitle gelembung kustom.

    TextArea

    String

    Tidak

    Area teks dalam peta dasar gelembung. Parameter ini wajib jika menggunakan subtitle gelembung kustom. Area teks berisi empat bilangan titik mengambang dengan nilai antara 0 hingga 1, dan bilangan titik mengambang dipisahkan dengan koma (,). Misalnya, jika Anda menentukan "0,1,0,2,0,8,0,6", koordinat pojok kiri atas kotak teks relatif terhadap gelembung adalah 0,1 dan 0,2, serta lebar dan tinggi kotak teks relatif terhadap gelembung adalah 0,8 dan 0,6.

    FontFace

    Gaya Font: FontFace

    Nama

    Tipe

    Wajib

    Deskripsi

    Bold

    Boolean

    Tidak

    Tebal

    Italic

    Boolean

    Tidak

    Menentukan apakah font dicetak miring.

    Underline

    Boolean

    Tidak

    Garis bawah

    Effect

    Efek material

    Efek yang berbeda memiliki parameter yang berbeda. Beberapa parameter umum digunakan oleh berbagai jenis efek.

    Untuk informasi lebih lanjut mengenai parameter efek, lihat Konfigurasi efek.

    Tabel berikut menjelaskan parameter umum efek.

    Nama

    Tipe

    Wajib

    Deskripsi

    Type

    String

    Ya

    Jenis efek. Nilai yang valid:

    • Text: menambahkan teks banner ke material dalam track video.

    • DeWatermark: mengaburkan watermark pada material dalam track video.

    • Crop: memotong material dalam track video.

    • Pad: menambahkan padding ke material dalam track video.

    • Scale: menskala material dalam track video.

    • Transition: menambahkan efek transisi ke material dalam track video.

    • VFX: menambahkan efek visual ke material dalam track video.

    • Volume: menyesuaikan volume material dalam track audio.

    • AFade: mengonfigurasi fade-in dan fade-out audio untuk material dalam track audio.

    • AI_ASR: menghasilkan subtitle dari audio dalam track audio atau video.

    SubType

    String

    Tidak

    Subjenis efek.

    • Jika Anda mengatur Type ke Transition, parameter ini menentukan subjenis efek transisi. Untuk informasi lebih lanjut, lihat Contoh efek transisi

    • Jika Anda mengatur Type ke VFX, parameter ini menentukan subjenis efek visual. Untuk informasi lebih lanjut, lihat Contoh efek visual

    • Jika Anda mengatur Type ke Filter, parameter ini menentukan subjenis efek filter. Untuk informasi lebih lanjut, lihat Contoh efek filter