ApsaraVideo Media Processing:Detail parameter

Parameter

Tipe

Wajib

Deskripsi

Bucket

String

Ya

Bucket Object Storage Service (OSS) tempat file input disimpan.

Untuk informasi lebih lanjut tentang bucket OSS, lihat Istilah.

Location

String

Ya

Masukkan data center (Wilayah OSS) untuk Bucket OSS.

• Bucket OSS harus berada di wilayah yang sama dengan MPS.

• Wilayah harus mengikuti definisi Wilayah OSS. Untuk informasi lebih lanjut, lihat Konsep Dasar.

Object

String

Ya

Jalur OSS dari file input. Jalur OSS adalah jalur lengkap yang mencakup nama file input.

• Untuk informasi lebih lanjut tentang istilah object key, lihat Istilah.

• Jalur objek OSS harus dikodekan URL dalam UTF-8 sebelum digunakan di MPS. Untuk informasi lebih lanjut, lihat Pengkodean URL.

• Contohnya, Alibaba Cloud/mts HD+.mp4 dikodekan menjadi %E9%98%BF%E9%87%8C%E4%BA%91/mts%20HD%2B.mp4.

Referer

String

Tidak

Konfigurasi Perlindungan hotlink. Jika Anda mengaktifkan fitur Perlindungan hotlink untuk bucket OSS agar hanya memperbolehkan referer tertentu dalam daftar putih untuk mengunduh file, Anda harus menentukan parameter ini. Jika Anda tidak mengaktifkan fitur Perlindungan hotlink untuk bucket OSS, Anda tidak perlu menentukan parameter ini. Untuk informasi lebih lanjut, lihat Perlindungan hotlink.

• Untuk menggunakan transkoding alur kerja, Anda harus mengatur Referer di Konsol. Untuk informasi lebih lanjut, lihat Atur perlindungan hotlink.

• Jika Anda memanggil operasi API untuk mengirim pekerjaan transkoding, Anda harus menentukan parameter ini dalam permintaan.

Parameter

Type

Wajib

Deskripsi

OutputObject

String

Ya

Jalur OSS dari file output. Jalur OSS adalah jalur lengkap yang mencakup nama file output.

• Untuk informasi lebih lanjut tentang istilah object key, lihat Istilah.

• Placeholder didukung. Untuk informasi lebih lanjut, lihat bagian Aturan penggantian placeholder pada topik ini.

• Aturan untuk menentukan ekstensi nama file:

  • Alur kerja: Anda tidak perlu menentukan ekstensi nama file. MPS secara otomatis menambahkan ekstensi nama file ke nilai parameter OutputObject berdasarkan format kontainer dari template transkoding.

  • Pekerjaan transkoding: Anda harus menentukan ekstensi nama file, dan ekstensi nama file harus sesuai dengan format kontainer dari template transkoding. Jika format kontainer adalah M3U8, MPS secara otomatis menambahkan ekstensi nama file .m3u8 ke playlist. Nomor seri lima digit ditambahkan secara otomatis sebagai akhiran nama playlist untuk menghasilkan nama file segmen media. Nomor seri lima digit dimulai dari 00001 dan dihubungkan ke nama playlist dengan tanda hubung (-). Ekstensi nama file segmen media adalah .ts. Misalnya, jika nama file playlist adalah filename.m3u8, nama file segmen media pertama adalah filename-00001.ts.

• Jalur objek OSS harus dikodekan URL dalam UTF-8 sebelum digunakan di MPS. Untuk informasi lebih lanjut, lihat Pengkodean URL.

• Sebagai contoh, jalur file input adalah a/b/example.flv, dan Anda ingin mengatur jalur file output menjadi a/b/c/example+test.mp4. Dalam hal ini, Anda dapat menggunakan placeholder untuk menentukan jalur file output dalam format {ObjectPrefix}/c/{FileName}+test.mp4. Setelah pengkodean URL, jalurnya ditampilkan sebagai %7BObjectPrefix%7D/c/%7BFileName%7D%2Btest.mp4.

TemplateId

String

Ya

ID template transkoding.

• Anda dapat menggunakan template transkoding kustom dan template preset sistem. Untuk informasi lebih lanjut, lihat Template Transkoding Kustom dan Detail Template Preset.

• Contoh: S00000002-200040.

Container

Object

Tidak

Format kontainer. Untuk informasi lebih lanjut, lihat bagian Container pada topik ini.

• Jika Anda menentukan parameter ini, parameter terkait dalam template transkoding yang ditentukan akan ditimpa.

Video

Object

Tidak

Parameter terkait transkoding video. Untuk informasi lebih lanjut, lihat bagian Video pada topik ini.

• Jika Anda menentukan parameter ini, parameter terkait dalam template transkoding yang ditentukan akan ditimpa.

Audio

Object

Tidak

Parameter terkait transkoding audio. Untuk informasi lebih lanjut, lihat bagian Audio pada topik ini.

• Jika Anda menentukan parameter ini, parameter terkait dalam template transkoding yang ditentukan akan ditimpa.

TransConfig

Object

Tidak

Parameter terkait proses transkoding. Untuk informasi lebih lanjut, lihat bagian TransConfig pada topik ini.

• Jika Anda menentukan parameter ini, parameter terkait dalam template transkoding yang ditentukan akan ditimpa.

• Contoh: {"TransMode":"onepass","AdjDarMethod":"none","IsCheckVideoBitrateFail":"true","IsCheckAudioBitrateFail":"true"}.

VideoStreamMap

String

Tidak

Identifikasi aliran video yang akan dipertahankan dalam file input. Nilai yang valid:

• Tidak ditentukan: Aliran video default dipilih.

• 0:v:{Nomor seri}: Aliran video tertentu dipilih. Nomor seri menentukan subskrip aliran video. Nomor seri dimulai dari 0. Misalnya, 0:v:1 menentukan bahwa aliran video kedua dipilih untuk transkoding.

• 0:v: Semua aliran video dipilih.

AudioStreamMap

String

Tidak

Identifikasi aliran audio yang akan dipertahankan dalam file input. Nilai yang valid:

• Tidak ditentukan: Aliran audio default dipilih. Dalam kebanyakan kasus, aliran audio berbahasa Mandarin, multi-saluran suara, dan berkualitas tinggi lebih disukai.

• 0:a:{Nomor seri}: Aliran audio tertentu dipilih. Nomor seri menentukan subskrip aliran audio. Nomor seri dimulai dari 0. Misalnya, 0:a:1 menentukan bahwa aliran audio kedua dipilih untuk transkoding.

• 0:a: Semua aliran audio dipilih. Nilai ini berlaku untuk skenario dubbing multi-bahasa.

Rotate

String

Tidak

Sudut rotasi video dalam arah searah jarum jam.

• Nilai yang valid: 0, 90, 180, dan 270.

• Nilai default: 0, yang menentukan bahwa video tidak diputar.

WaterMarks

Object[]

Tidak

Watermark. Watermark adalah gambar atau teks yang ditambahkan ke gambar video. Jika Anda menentukan parameter ini, parameter terkait dalam template watermark yang ditentukan akan ditimpa. Untuk informasi lebih lanjut, lihat bagian WaterMarks pada topik ini.

• Anda dapat menambahkan hingga empat watermark ke pekerjaan transkoding.

• Kode berikut menunjukkan contoh watermark gambar tunggal: ["WaterMarkTemplateId":"88c6ca184c0e47098a5b665e2a12****"},{"InputFile":{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"},{"Timeline":{"Start":"0","Duration":"ToEND"}}].

• Contoh watermark teks tunggal: ["Type":"Text","TextWaterMark":{"Content":"5rWL6K+V5paH5a2X5rC05Y2w","FontName":"SimSun","FontSize":"16","Top":2,"Left":10}].

DeWatermark

Object

Tidak

Anda dapat melakukan pemrosesan efek buram. Untuk informasi lebih lanjut, lihat Detail pemrosesan efek buram.

• Contoh: {"0": [{"l":10,"t":10,"w":10,"h":10},{"l":100,"t":0.1,"w":10,"h":10}],"128000": [],"250000": [{"l":0.2,"t":0.1,"w":0.01,"h":0.05}]}.

SubtitleConfig

Object

Tidak

Konfigurasi subtitle hard. Parameter ini memungkinkan Anda menambahkan file subtitle eksternal ke video. Untuk informasi lebih lanjut, lihat bagian SubtitleConfig pada topik ini.

• Anda dapat menambahkan hingga empat file subtitle ke pekerjaan transkoding.

• Contoh: {"ExtSubtitleList":[{"Input":{"Bucket":"example-bucket-****","Location":"oss-cn-hangzhou","Object":"example.srt"},"CharEnc":"UTF-8"}]}.

Clip

Object

Tidak

Clip. Untuk informasi lebih lanjut, lihat bagian Clip pada topik ini.

• Contoh: {"TimeSpan":{"Seek":"00:01:59.999","End":"18000.30"},"ConfigToClipFirstPart":false}, yang menentukan bahwa clip dimulai pada 1 menit, 59 detik, dan 999 milidetik serta berakhir pada titik waktu yang 5 menit dan 30 milidetik sebelum akhir video. Clip dipotong dari video yang dibentuk dengan menggabungkan beberapa file input.

MergeList

Object[]

Tidak

Daftar penggabungan. Anda dapat menggabungkan beberapa file input dan clip secara berurutan untuk menghasilkan video baru. Untuk informasi lebih lanjut, lihat bagian MergeList pada topik ini.

• Anda hanya dapat menentukan salah satu parameter MergeList dan MergeConfigUrl. Parameter MergeConfigUrl memiliki prioritas lebih tinggi daripada parameter MergeList.

• Anda dapat menambahkan hingga empat parameter MergeURL ke pekerjaan transkoding. Untuk menambahkan lebih banyak parameter MergeURL ke pekerjaan transkoding, Anda harus menentukan parameter MergeConfigUrl.

• Contoh untuk menentukan satu parameter MergeURL: [{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4"}].

• Contoh untuk menentukan dua parameter MergeURL: [{"MergeURL":"http://exampleBucket****m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4","Start":"1","Duration":"20"},{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_comm_02.mp4","Start":"5.4","Duration":"10.2"}].

MergeConfigUrl

String

Tidak

Jalur OSS dari file konfigurasi untuk menggabungkan clip.

• Anda hanya dapat menentukan salah satu parameter MergeList dan MergeConfigUrl. Parameter MergeConfigUrl memiliki prioritas lebih tinggi daripada parameter MergeList.

• File harus disimpan di bucket OSS. Contoh: http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/mergeConfigfile.

• File berisi beberapa parameter MergeURL. Tentukan parameter MergeURL sesuai urutan penggabungan clip yang diinginkan. Anda dapat menentukan hingga 50 parameter MergeURL. Untuk informasi lebih lanjut tentang formatnya, lihat bagian MergeList pada topik ini. Contoh isi file konfigurasi: {"MergeList":[{"MergeURL":"http://exampleBucket****m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4","Start":"1","Duration":"20"},{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_comm_02.mp4","Start":"5.4","Duration":"10.2"}]}.

OpeningList

Object[]

Tidak

Bagian pembuka. Pembuka adalah efek penggabungan khusus yang memungkinkan Anda menyematkan bagian pembuka di awal video input. Bagian pembuka ditampilkan dalam mode Gambar-dalam-Gambar (PiP). Untuk informasi lebih lanjut, lihat bagian OpeningList pada topik ini.

• Anda dapat menambahkan hingga dua bagian pembuka ke pekerjaan transkoding. Tentukan bagian pembuka sesuai urutan penyematan dalam video output.

• Contoh: [{"OpenUrl":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv","Start":"1","Width":"1920","Height":"1080"},{"OpenUrl":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/opening_02.flv","Start":"1","Width":"-1","Height":"full"}].

TailSlateList

Object[]

Tidak

Bagian penutup. Penutup adalah efek penggabungan khusus yang memungkinkan Anda menambahkan bagian penutup di akhir video input. Bagian penutup ditampilkan dalam mode fade-in dan fade-out. Untuk informasi lebih lanjut, lihat bagian TailSlateList pada topik ini.

• Anda dapat menambahkan hingga dua bagian penutup ke pekerjaan transkoding. Tentukan bagian penutup sesuai urutan penyematan dalam video output.

• Contoh: [{"TailUrl":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_01.flv","Start":"1","BlendDuration":"2","Width":"1920","Height":"1080","IsMergeAudio":false,"BgColor":"White"}].

Amix

Object[]

Tidak

Konfigurasi pencampuran audio. Parameter ini cocok untuk skenario di mana Anda ingin menggabungkan beberapa track audio dalam video atau menambahkan musik latar. Untuk informasi lebih lanjut, lihat bagian Amix pada topik ini.

• Anda dapat menambahkan hingga empat file audio campuran ke pekerjaan transkoding.

• Contoh untuk mencampur dua aliran audio dari file input: [{"AmixURL":"input","MixDurMode":"longest","Start":"1","Duration":"2"}].

• Contoh untuk menambahkan file eksternal dan mencampurnya dengan file input: [{"AmixURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail.flv","Map":"0:a:1","MixDurMode":"longest","Start":"1","Duration":"2"}].

MuxConfig

Object

Tidak

Konfigurasi pengemasan. Untuk informasi lebih lanjut, lihat bagian MuxConfig pada topik ini.

• Jika Anda menentukan parameter ini, parameter terkait dalam template transkoding yang ditentukan akan ditimpa.

• Contoh: {"Segment":{"Duration":"10","ForceSegTime":"1,2,4,6,10,14,18"}}, yang menentukan bahwa video dipotong secara paksa pada detik ke-1, ke-2, ke-4, ke-6, ke-10, ke-14, ke-18, ke-20, ke-30, ke-40, ke-50, dan seterusnya.

M3U8NonStandardSupport

Object

Tidak

Dukungan non-standar untuk format M3U8. Untuk informasi lebih lanjut, lihat bagian M3U8NonStandardSupport pada topik ini.

• Contoh: {"TS":{"Md5Support":true,"SizeSupport":true}}, yang menentukan bahwa nilai MD5 dan ukuran setiap file TS disertakan dalam video M3U8 output.

Encryption

String

Tidak

Konfigurasi enkripsi. Parameter ini hanya berlaku jika parameter Container diatur ke m3u8. Untuk informasi lebih lanjut, lihat Detail parameter Enkripsi.

• Contoh: {"Type":"hls-aes-128","Key":"ZW5jcnlwdGlvbmtleTEyMw","KeyType":"Base64","KeyUri":"aHR0cDovL2FsaXl1bi5jb20vZG9jdW1lbnQvaGxzMTI4LmtleQ=="}.

UserData

String

Tidak

Data kustom, yang ukurannya dapat mencapai 1.024 byte.

Priority

String

Tidak

Prioritas pekerjaan transkoding dalam antrian MPS.

• Nilai yang valid: [1,10]. Nilai 1 menentukan prioritas terendah, sedangkan nilai 10 menentukan prioritas tertinggi.

• Nilai default: 6.

• Praktik terbaik: Antrian MPS memiliki batas konkurensi. Jika Anda mengirim banyak pekerjaan, pekerjaan tersebut mungkin masuk antrian. Kami menyarankan Anda mengonfigurasi prioritas lebih tinggi untuk pekerjaan yang memerlukan kinerja waktu tinggi atau memproses konten penting.

Metadata

Map

Tidak

metadata untuk format kontainer video output, ditentukan sebagai pasangan kunci-nilai JSON. Contoh: {"key1":"value1","key2":"value2"}.

• Panjang maksimum key: 64.

• Panjang maksimum value: 512.

• Anda dapat menambahkan hingga 4 pasangan kunci-nilai metadata.

Parameter

Tipe

Wajib

Deskripsi

Format

String

Tidak

Format kontainer.

• Untuk informasi lebih lanjut tentang format yang didukung dan kodek yang kompatibel, lihat Format yang didukung.

  • Format video yang didukung: 3GP, AVI, FLV, F4V, fMP4, MKV, MOV, MP4, TS, MXF, WebM, M3U8, HLS-fMP4, MPD, CMAF-HLS, dan CMAF-DASH.

  • Format audio yang didukung: AAC, M4A, MP2, MP3, MP4, Ogg, FLAC, M3U8, HLS-fMP4, MPD, CMAF-HLS, dan CMAF-DASH.

  • Gambar animasi: GIF dan WebP.

• Format default: MP4.

Parameter

Type

Wajib

Deskripsi

Remove

String

Tidak

Menentukan apakah akan menghapus aliran video. Nilai yang valid:

• true: menghapus aliran video. Jika Anda mengatur parameter ini ke true, semua parameter terkait video tidak valid.

• false: Item dipertahankan.

• Nilai default: false.

Codec

String

Tidak

Format encoding video.

• Nilai yang valid: H.264, H.265, AV1, GIF, dan WEBP. Untuk informasi lebih lanjut tentang format yang didukung dan format kontainer yang kompatibel, lihat Format yang didukung.

• Nilai default: H.264.

Width

String

Tidak

Lebar atau sisi panjang video output. Jika parameter LongShortMode diatur ke false atau dibiarkan kosong, parameter ini menentukan lebar video output. Jika parameter LongShortMode diatur ke true, parameter ini menentukan sisi panjang video output.

• Unit: piksel.

• Nilai yang valid: [128,4096]. Nilainya harus bilangan genap.

• Nilai default:

  • Jika parameter Width maupun Height tidak ditentukan, nilai default adalah lebar atau sisi panjang video input.

  • Jika hanya parameter Height yang ditentukan, nilai default dihitung berdasarkan rasio aspek video input.

Height

String

Tidak

Tinggi atau sisi pendek video output. Jika parameter LongShortMode diatur ke false atau dibiarkan kosong, parameter ini menentukan tinggi video output. Jika parameter LongShortMode diatur ke true, parameter ini menentukan sisi pendek video output.

• Unit: piksel.

• Nilai yang valid: [128,4096]. Nilainya harus bilangan genap.

• Nilai default:

  • Jika Width maupun Height tidak diatur, dimensi yang lebih pendek dari video input digunakan.

  • Jika hanya parameter Width yang ditentukan, nilai default dihitung berdasarkan rasio aspek video input.

LongShortMode

String

Tidak

Menentukan apakah akan mengaktifkan rotasi otomatis (menyesuaikan dengan tepi panjang dan pendek). Pengaturan ini hanya berlaku ketika `Width` atau `Height` ditentukan.

• true: Fitur diaktifkan.

• false: Dimatikan.

• Nilai default: false.

• Praktik terbaik: Jika video input Anda berisi video landscape dan portrait, aktifkan fitur rotasi otomatis dan konfigurasikan penskalaan proporsional berdasarkan parameter resolusi untuk mencegah peregangan dan distorsi video. Untuk contoh, lihat Konfigurasi rotasi otomatis.

Fps

String

Tidak

Laju frame aliran video.

• Unit: frame per detik.

• Nilai yang valid: (0,60].

• Nilai default: laju frame file input. Jika laju frame file input melebihi 60, digunakan nilai 60.

• Nilai umum: 24, 25, dan 30.

MaxFps

String

Tidak

Laju frame maksimum.

Gop

String

Tidak

Mengatur interval antara Frame-I yang berdekatan dalam waktu atau jumlah frame.

• Format interval waktu maksimum antara dua Frame-I berturut-turut: {Waktu}s. Nilai yang valid: [1,100000].

• Format interval frame maksimum antara dua Frame-I berturut-turut: {Jumlah frame}. Nilai yang valid: [1,100000].

• Nilai default: 10s, yang menentukan bahwa interval waktu antara dua Frame-I berturut-turut adalah 10 detik.

• Praktik terbaik: Kami menyarankan Anda mengatur parameter ke interval waktu dua hingga tujuh detik dalam skenario media streaming untuk mengurangi waktu mulai pemutaran dan waktu respons untuk seeking.

Bitrate

String

Tidak

Bitrate rata-rata video output. Jika Anda menggunakan mode kontrol bitrate CRB, ABR, atau VBR, Anda harus menentukan parameter Bitrate, dan Anda harus mengatur parameter TransMode ke nilai yang valid. Untuk informasi lebih lanjut, lihat bagian Mode kontrol bitrate pada topik ini.

• Unit: Kbit/s.

• Nilai yang valid: -1 dan [10,50000]. Nilai -1 menunjukkan bahwa bitrate asli video input digunakan.

• Praktik terbaik:

  • CBR: Atur parameter TransMode ke CBR dan parameter Bitrate, Maxrate, dan Bufsize ke nilai yang sama.

  • ABR: Atur parameter TransMode ke onepass dan tentukan parameter Bitrate. Anda juga dapat menentukan parameter Maxrate dan Bufsize untuk mengontrol rentang bitrate.

  • VBR: Atur parameter TransMode ke twopass dan tentukan parameter Maxrate atau BitrateBnd serta parameter Bufsize.

BitrateBnd

String

Tidak

Rentang bitrate rata-rata video output.

• Parameter ini hanya berlaku jika parameter Codec diatur ke H.264.

• Contoh: {"Max":"5000","Min":"1000"}.

Maxrate

String

Tidak

Bitrate puncak video output. Untuk informasi lebih lanjut, lihat bagian Mode kontrol bitrate pada topik ini.

• Unit: Kbit/s.

• Nilai yang valid: [10,50000].

Bufsize

String

Tidak

Ukuran buffer untuk kontrol bitrate. Anda dapat menentukan parameter ini untuk mengontrol fluktuasi bitrate. Untuk informasi lebih lanjut, lihat bagian Mode kontrol bitrate pada topik ini.

• Unit: Kbit.

• Nilai yang valid: [1000,128000].

• Nilai default: 6000.

Crf

String

Tidak

Faktor kontrol kualitas. Untuk menggunakan mode CRF, Anda harus menentukan parameter Crf dan mengatur parameter TransMode ke fixCRF. Untuk informasi lebih lanjut, lihat bagian Mode kontrol bitrate pada topik ini.

• Nilai yang valid: [20,51].

• Jika parameter Codec diatur ke H.264, nilai default adalah 23. Jika parameter Codec diatur ke H.265, nilai default adalah 26. Jika parameter Codec diatur ke AV1, nilai default adalah 32.

• Praktik terbaik:

  • Nilai 0 menentukan bahwa video lossless. Nilai 51 menentukan bahwa kualitas gambar terburuk. Kami menyarankan Anda mengatur nilainya dalam rentang 23 hingga 29. Anda dapat menyesuaikan nilai berdasarkan kompleksitas gambar video. Jika Anda menaikkan atau menurunkan nilai sebesar enam, bitrate berkurang separuh atau berlipat ganda. Di bawah definisi yang sama, Anda dapat mengatur nilai untuk kartun animasi lebih tinggi daripada video shot.

  • Mode CRF memberikan prioritas pada kualitas video, dan bitrate video output tidak dapat diprediksi. Anda dapat menentukan parameter Maxrate dan Bufsize untuk mengontrol rentang bitrate.

Qscale

String

Tidak

Nilai faktor untuk kontrol kualitas video. Parameter ini berlaku jika Anda menggunakan mode VBR.

• Parameter ini hanya berlaku jika parameter Codec diatur ke H.264.

• Nilai yang valid: [0,51].

Profile

String

Tidak

Menentukan profil encoding. Untuk informasi lebih lanjut, lihat Istilah.

• Parameter ini hanya berlaku jika Codec diatur ke H.264.

• Nilai yang valid: baseline, main, dan high.

• Nilai default: high.

• Praktik terbaik: Jika Anda ingin menghasilkan video output dalam beberapa definisi dari video yang sama, kami menyarankan Anda mengatur parameter ini ke baseline untuk definisi terendah. Hal ini memastikan bahwa video output dapat diputar di berbagai perangkat. Jika Anda ingin menghasilkan video output dalam definisi lain, atur parameter ini ke main atau high.

Preset

String

Tidak

Mode preset encoder H.264.

• Parameter ini hanya berlaku jika parameter Codec diatur ke H.264.

• Nilai yang valid: veryfast, fast, medium, slow, dan slower.

• Nilai default: medium.

ScanMode

String

Tidak

Mode pemindaian. Nilai yang valid:

• Jika Anda membiarkan parameter ini kosong, mode pemindaian file input digunakan.

• auto: Melakukan deinterlacing secara otomatis.

• progressive: Pemindaian berurutan, baris demi baris.

• interlaced: Pemindaian interlaced.

• Nilai default: None.

Praktik terbaik: Mode pemindaian interlaced menghemat trafik data dibandingkan mode pemindaian progressive tetapi memberikan kualitas gambar yang buruk. Oleh karena itu, mode pemindaian progressive umumnya digunakan dalam produksi video utama.

• Jika Anda mengatur parameter ScanMode ke progressive atau interlaced tetapi mode pemindaian ini tidak sesuai dengan file input, file gagal ditranskode.

• Kami merekomendasikan mengatur Original Video Mode atau Automatic Deinterlacing untuk meningkatkan kompatibilitas.

PixFmt

String

Tidak

Format warna video.

• Untuk menggunakan format warna asli, atur PixFmt ke "".

• Nilai yang valid meliputi yuv420p, yuvj420p, yuv422p, yuvj422p, yuv444p, yuvj444p, yuv444p, yuv444p161e, pc, bt470bg, dan smpte170m. Jika parameter Codec diatur ke GIF, bgr8 didukung.

Crop

String

Tidak

Metode yang digunakan untuk memotong video. Batas dapat dideteksi dan dihapus secara otomatis. Anda juga dapat memotong video secara manual.

• Tentukan parameter ini jika resolusi video input lebih besar daripada video output. Jangan tentukan parameter AdjDarMethod jika parameter ini ditentukan.

• Penghapusan batas hitam otomatis.

• Untuk menggunakan metode pemotongan kustom, atur parameter dalam format {width}:{height}:{left}:{top}.

  • width: lebar video output setelah dipotong.

  • height: tinggi video output setelah dipotong.

  • left: margin kiri antara gambar output dan gambar asli.

  • top: margin atas antara gambar output dan gambar asli.

• Contoh pemotongan kustom: 1920:800:0:140.

Pad

String

Tidak

Video diberi padding dengan batang hitam.

• Tentukan parameter ini jika resolusi video input lebih kecil daripada video output. Jangan tentukan parameter IsCheckReso, IsCheckResoFail, atau AdjDarMethod jika parameter ini ditentukan.

• Format: {width}:{height}:{left}:{top}.

  • width: lebar video output setelah batang hitam ditambahkan.

  • height: tinggi video output setelah batang hitam ditambahkan.

  • left: Margin kiri frame sumber relatif terhadap frame output.

  • top: Margin antara bagian atas frame output dan bagian atas frame asli.

• Contoh: 1920:1080:0:140.

Parameter

Tipe

Wajib

Deskripsi

Remove

String

Tidak

Menentukan apakah akan menghapus aliran audio.

• true: menghapus aliran audio. Jika Anda mengatur parameter ini ke true, semua parameter terkait audio tidak valid.

• false: Resource dipertahankan.

• Nilai default: false.

Codec

String

Tidak

Format kodek audio.

• Nilai yang valid: AAC, AC3, EAC3, MP2, MP3, FLAC, OPUS, VORBIS, WMA-V1, WMA-V2, dan pcm_s16le. Untuk informasi lebih lanjut tentang format yang didukung dan format kontainer yang kompatibel, lihat Format yang didukung.

• Nilai default: AAC.

Profile

String

Tidak

Profil encoding audio.

• Parameter ini hanya berlaku jika parameter Codec diatur ke AAC.

• Nilai yang valid: aac_low, aac_he, aac_he_v2, aac_ld, dan aac_eld. Untuk informasi lebih lanjut tentang istilah profil encoding, lihat Istilah.

• Nilai default: aac_low.

Bitrate

String

Tidak

Bitrate audio file output.

• Unit: Kbit/s.

• Nilai yang valid: [8,1000].

• Nilai default: 128.

• Nilai umum: 64, 128, dan 256.

Samplerate

String

Tidak

Laju pengambilan sampel.

• Unit: Hz.

• Nilai yang valid: 22050, 32000, 44100, 48000, dan 96000.

  Catatan

  Laju pengambilan sampel yang didukung bervariasi berdasarkan format encoding dan format kontainer. Untuk informasi lebih lanjut, lihat Laju pengambilan sampel audio. Misalnya, jika Codec diatur ke MP3, Anda tidak dapat mengatur parameter ini ke 96000. Jika Codec diatur ke FLV, Anda hanya dapat mengatur parameter ini ke 22050 atau 44100.

• Nilai default: 44100.

Channels

String

Tidak

Jumlah saluran suara.

• Nilai yang valid: 0, 1, 2, 4, 5, 6, dan 8.

  • Jika parameter Codec diatur ke MP3 atau OPUS, Anda dapat mengatur parameter ini ke 0, 1, atau 2.

  • Jika parameter Codec diatur ke AAC atau FLAC, Anda dapat mengatur parameter ini ke 0, 1, 2, 4, 5, 6, atau 8.

  • Jika parameter Codec diatur ke VORBIS, Anda dapat mengatur parameter ini ke 2.

  • Jika parameter Format diatur ke MPD, Anda tidak dapat mengatur parameter ini ke 8.

• Nilai default: 2.

• Jika Anda ingin mempertahankan jumlah saluran suara asli, atur parameter ini ke 0.

Volume

String

Tidak

Konfigurasi volume. Untuk informasi lebih lanjut, lihat bagian Volume pada topik ini.

• Parameter ini hanya didukung jika hanya satu aliran audio output yang dikonfigurasi. Parameter ini tidak didukung jika lebih dari satu aliran audio output dikonfigurasi.

Parameter

Tipe

Wajib

Deskripsi

Type

String

Tidak

Jenis watermark. Nilai yang valid:

• Text: watermark teks. Jika Anda mengatur parameter ini ke Text, Anda harus menentukan parameter TextWaterMark.

• Image: watermark gambar. Jika Anda mengatur parameter ini ke Image, Anda harus menentukan parameter terkait watermark gambar.

• Nilai default: Image.

TextWaterMark

Object

Tidak

Konfigurasi watermark teks. Untuk informasi lebih lanjut, lihat bagian TextWaterMark pada topik ini.

• Jika parameter Type diatur ke Text, parameter ini wajib.

• Contoh: {"Content":"5rWL6K+V5paH5a2X5rC05Y2w","FontName":"SimSun","FontSize":"16","Top":2,"Left":10}.

InputFile

Object

Tidak

File yang akan digunakan sebagai watermark gambar. Anda dapat menggunakan parameter Bucket, Location, dan Object untuk menentukan lokasi file.

• Jenis file yang didukung: gambar statis PNG dalam format .png, gambar animasi PNG dalam format .apng, file MOV dalam format .mov, dan file GIF dalam format .gif.

• File harus disimpan di bucket OSS. Untuk informasi lebih lanjut, lihat bagian Input pada topik ini.

• Dalam API ApsaraVideo Media Processing, Object memerlukan Pengkodean URL (berdasarkan UTF-8) sebelum digunakan.

• Contoh: {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"}.

WaterMarkTemplateId

String

Tidak

ID template watermark gambar. Jika Anda tidak menentukan parameter ini, konfigurasi default berikut digunakan untuk parameter terkait watermark gambar:

• Posisi watermark gambar adalah TopRight.

• Dx dan Dy: 0.

• Lebar: 0,12 kali lebar video output.

• Tinggi watermark gambar: diskalakan secara proporsional berdasarkan lebar watermark gambar.

• Durasi tampil watermark gambar: Seluruh durasi.

ReferPos

String

Tidak

Lokasi watermark gambar.

• Nilai yang valid: TopRight, TopLeft, BottomRight, dan BottomLeft.

Dx

String

Tidak

Offset horizontal watermark gambar relatif terhadap video output. Jika Anda menentukan parameter ini, parameter terkait dalam template watermark yang ditentukan akan ditimpa. Jenis nilai yang didukung:

• Bilangan bulat: nilai piksel offset horizontal.

  • Unit: piksel.

  • Nilai yang valid: [8,4096].

• Desimal: rasio offset horizontal terhadap lebar video output.

  • Nilai yang valid: (0,1).

  • Mendukung empat tempat desimal, seperti 0,9999. Tempat desimal berlebih dibuang.

Dy

String

Tidak

Offset vertikal watermark gambar relatif terhadap video output. Jenis nilai yang didukung:

• Bilangan bulat: nilai piksel offset vertikal.

  • Unit: piksel.

  • Nilai yang valid: [8,4096].

• Desimal: rasio offset vertikal terhadap tinggi video output.

  • Nilai yang valid: (0,1).

  • Mendukung empat tempat desimal, seperti 0,9999. Tempat desimal berlebih dibuang.

Width

String

Tidak

Anda dapat mengatur lebar watermark gambar dengan dua cara:

• Bilangan bulat: nilai piksel lebar watermark.

  • Rentang: [8,4096].

  • Unit: piksel.

• Nilai desimal yang merepresentasikan lebar video output sebagai persentase.

  • Rentang: (0,1).

  • Mendukung empat tempat desimal, seperti 0,9999. Tempat desimal berlebih secara otomatis dibuang.

Height

String

Tidak

Anda dapat mengatur tinggi watermark gambar dengan dua cara:

• Bilangan bulat: nilai piksel tinggi watermark.

  • Rentang: [8,4096].

  • Unit: piksel.

• Nilai desimal yang menentukan tinggi sebagai proporsi dari tinggi video output.

  • Rentang: (0,1).

  • Mendukung empat tempat desimal, seperti 0,9999. Tempat desimal berlebih secara otomatis dibuang.

Timeline

String

Tidak

Durasi tampil watermark gambar. Untuk informasi lebih lanjut, lihat bagian Timeline pada topik ini.

Parameter

Tipe

Wajib

Deskripsi

Content

String

Ya

Teks yang akan ditampilkan sebagai watermark. Teks harus dikodekan dalam format Base64.

• Sebagai contoh, untuk menambahkan watermark teks "test text watermark", atur Content ke "5rWL6K+V5paH5a2X5rC05Y2w".

FontName

String

Tidak

Font.

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

• Nilai default: SimSun.

FontSize

Int

Tidak

Ukuran font.

• Nilai yang valid: (4,120).

• Nilai default: 16.

FontColor

String

Tidak

Warna font.

• Untuk informasi lebih lanjut tentang warna yang didukung, lihat kolom name di FontColor.

• Nilai default: black.

FontAlpha

Float

Tidak

Transparansi teks.

• Nilai yang valid: (0,1].

• Nilai default: 1,0.

BorderWidth

Int

Tidak

Lebar garis luar

• Unit: piksel.

• Nilai yang valid: [0,4096].

• Nilai default: 0.

BorderColor

String

Tidak

Warna garis luar.

• Untuk informasi lebih lanjut tentang warna yang didukung, lihat kolom name di BorderColor.

• Nilai default: Black.

Top

Int

Tidak

Margin atas teks.

• Unit: piksel.

• Nilai yang valid: [0,4096].

• Nilai default: 0.

Left

Int

Tidak

Margin kiri.

• Unit: piksel.

• Nilai yang valid: [0,4096].

• Nilai default: 0.

Parameter

Tipe

Wajib

Deskripsi

Start

String

Tidak

Awal rentang waktu di mana watermark gambar ditampilkan.

• Format: sssss[.SSS].

• Nilai yang valid: [0,000, 86399,999]. Proses transkoding gagal jika waktu mulai melebihi durasi.

• Nilai default: 0.

• Contoh: 18000,30.

Duration

String

Tidak

Rentang waktu di mana watermark gambar ditampilkan.

• Jika parameter diatur ke ToEND, watermark ditampilkan terus-menerus hingga video berakhir.

• Format: sssss[.SSS]. Unit: detik.

• Nilai default: ToEND.

Parameter

Tipe

Wajib

Deskripsi

Type

String

Tidak

Jenis watermark.

• Image: watermark gambar.

• Nilai default: Image.

ReferPos

String

Tidak

Lokasi watermark gambar.

• Nilai yang valid: TopRight, TopLeft, BottomRight, dan BottomLeft.

• Gambar berikut menunjukkan contoh cara menggunakan parameter ReferPos, Dx, dan Dy untuk menentukan lokasi watermark gambar.

Dx

String

Tidak

Offset horizontal watermark gambar relatif terhadap video output. Jenis nilai yang didukung:

• Bilangan bulat: nilai piksel offset horizontal.

  • Unit: piksel.

  • Nilai yang valid: [8,4096].

• Desimal: rasio offset horizontal terhadap lebar video output.

  • Nilai yang valid: (0,1).

  • Mendukung empat tempat desimal, seperti 0,9999. Tempat desimal berlebih dibuang.

Dy

String

Tidak

Offset vertikal watermark gambar relatif terhadap video output. Jenis nilai yang didukung:

• Bilangan bulat: nilai piksel offset vertikal.

  • Unit: piksel.

  • Nilai yang valid: [8,4096].

• Desimal: rasio offset vertikal terhadap tinggi video output.

  • Nilai yang valid: (0,1).

  • Mendukung empat tempat desimal, seperti 0,9999. Tempat desimal berlebih dibuang.

Width

String

Tidak

Lebar watermark gambar. Jenis nilai yang didukung:

• Bilangan bulat: nilai piksel lebar watermark.

  • Unit: piksel.

  • Rentang: [8,4096].

• Jenis desimal: Rasio terhadap resolusi lebar video output.

  • Rentang nilai: (0,1).

  • Mendukung empat tempat desimal, seperti 0,9999. Tempat desimal berlebih secara otomatis dibuang.

Height

String

Tidak

Tinggi watermark gambar dapat diatur dengan salah satu dari dua cara:

• Bilangan bulat: nilai piksel tinggi watermark.

  • Unit: piksel.

  • Rentang: [8,4096].

• Nilai desimal: Rasio relatif terhadap tinggi resolusi video output.

  • Rentang nilai: (0,1).

  • Mendukung empat tempat desimal, seperti 0,9999. Tempat desimal berlebih secara otomatis dibuang.

Timeline

String

Tidak

Watermark dinamis: Untuk informasi lebih lanjut, lihat Detail parameter Timeline.

Parameter

Tipe

Wajib

Deskripsi

ExtSubtitleList

Object[]

Tidak

Subtitle eksternal. Untuk informasi lebih lanjut, lihat bagian ExtSubtitle pada topik ini.

• Anda dapat menambahkan hingga empat file subtitle ke pekerjaan transkoding.

• Contoh: [{"Input":{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.srt"},"CharEnc":"UTF-8"}].

Parameter

Tipe

Wajib

Deskripsi

Input

String

Ya

File subtitle eksternal. Anda dapat menggunakan parameter Bucket, Location, dan Object untuk menentukan lokasi file.

• Format SRT dan ASS didukung. Informasi warna dalam file subtitle dapat dibaca.

• File harus disimpan di bucket OSS. Untuk informasi lebih lanjut, lihat bagian Input pada topik ini.

• Placeholder didukung. Untuk informasi lebih lanjut, lihat bagian Aturan penggantian placeholder pada topik ini.

• Jalur objek OSS harus dikodekan URL dalam UTF-8 sebelum digunakan di MPS. Untuk informasi lebih lanjut, lihat Pengkodean URL.

• Sebagai contoh, jika jalur file input adalah a/b/example.flv dan jalur file subtitle adalah a/b/example-cn.mp4, Anda dapat menggunakan placeholder untuk menentukan objek dalam format berikut: {ObjectPrefix}{FileName}-cn.srt. Setelah jalur dikodekan, objeknya adalah {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"%7bObjectPrefix%7d%7bFileName%7d-cn.srt"}.

CharEnc

String

Tidak

Format encoding subtitle eksternal.

• Nilai yang valid: UTF-8, GBK, BIG5, dan auto.

• Nilai default: auto.

FontName

String

Tidak

Font subtitle.

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

• Nilai default: SimSun.

FontSize

Int

Tidak

Ukuran font subtitle.

• Nilai yang valid: (4,120).

• Nilai default: 16.

Parameter

Tipe

Wajib

Deskripsi

TimeSpan

String

Tidak

Rentang waktu pemotongan clip dari file input. Untuk informasi lebih lanjut, lihat bagian TimeSpan pada topik ini.

• Contoh untuk menentukan rentang waktu menggunakan parameter Duration: {"Seek":"00:01:59.999","Duration":"180.30"}, yang menentukan bahwa clip dimulai pada 1 menit, 59 detik, dan 999 milidetik serta berakhir pada 5 menit dan 30 milidetik.

• Contoh untuk menentukan rentang waktu menggunakan parameter End: {"Seek":"00:01:59.999","End":"180.30"}, yang menentukan bahwa clip dimulai pada 1 menit, 59 detik, dan 999 milidetik serta berakhir pada titik waktu yang 5 menit dan 30 milidetik sebelum akhir video.

ConfigToClipFirstPart

Boolean

Tidak

Menentukan apakah akan melakukan pengeditan video pada segmen pertama.

• true: memotong bagian pertama file menjadi clip sebelum penggabungan clip.

• false: Konten pertama kali digabungkan (ditranskode) lalu diedit.

• Nilai default: false.

Parameter

Tipe

Wajib

Deskripsi

Seek

String

Tidak

Titik awal waktu clip. Anda dapat menggunakan parameter ini untuk menentukan titik awal waktu clip. Titik awal waktu default adalah awal video.

• Format: hh:mm:ss[.SSS] atau sssss[.SSS].

• Nilai yang valid: [00:00:00.000,23:59:59.999] atau [0.000,86399.999].

• Contoh: 00:01:59.999 atau 180.30.

Duration

String

Tidak

Panjang clip. Anda dapat menentukan panjang clip relatif terhadap titik waktu yang ditentukan oleh parameter Seek. Secara default, panjang clip adalah dari titik waktu yang ditentukan oleh parameter Seek hingga akhir video. Anda hanya dapat menentukan salah satu parameter Duration dan End. Jika Anda menentukan parameter End, pengaturan parameter Duration tidak valid.

• Format: hh:mm:ss[.SSS] atau sssss[.SSS].

• Nilai yang valid: [00:00:00.000,23:59:59.999] atau [0.000,86399.999].

• Contoh: 00:01:59.99 atau 180.30.

End

String

Tidak

Panjang bagian akhir video asli yang akan dipotong. Anda hanya dapat menentukan salah satu parameter Duration dan End. Jika Anda menentukan parameter End, pengaturan parameter Duration tidak valid.

• Format: hh:mm:ss[.SSS] atau sssss[.SSS].

• Nilai yang valid: [00:00:00.000,23:59:59.999] atau [0.000,86399.999].

• Contoh: 00:01:59.999 atau 180.30.

Parameter

Tipe

Wajib

Deskripsi

MergeURL

String

Ya

Jalur OSS clip yang akan digabungkan.

• Jalur objek OSS harus dikodekan URL dalam UTF-8 sebelum digunakan di MPS. Untuk informasi lebih lanjut, lihat Pengkodean URL.

• Contoh: http://exampleBucket****m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4.

Start

String

Tidak

Titik waktu di mana output clip dipotong dari clip asli. Tentukan parameter ini jika Anda hanya ingin menggabungkan bagian video ke file output. Titik awal waktu default adalah awal video.

• Format: hh:mm:ss[.SSS] atau sssss[.SSS].

• Nilai yang valid: [00:00:00.000,23:59:59.999] atau [0.000,86399.999].

• Contoh: 01:59:59.999 atau 32000.23.

Duration

String

Tidak

Panjang video campuran. Panjang relatif terhadap titik awal waktu yang ditentukan oleh parameter Start. Tentukan parameter ini jika Anda hanya ingin menggabungkan bagian video ke file output. Secara default, panjangnya adalah periode dari titik awal waktu yang ditentukan oleh parameter Start hingga akhir video.

• Format: hh:mm:ss[.SSS] atau sssss[.SSS].

• Nilai yang valid: [00:00:00.000,23:59:59.999] atau [0.000,86399.999].

• Contoh: 01:59:59.999 atau 32000.23.

Parameter

Tipe

Wajib

Deskripsi

OpenUrl

String

Ya

Jalur OSS bagian pembuka.

• Jalur objek OSS harus dikodekan URL dalam UTF-8 sebelum digunakan di MPS. Untuk informasi lebih lanjut, lihat Pengkodean URL.

• Contoh: http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv.

Start

String

Tidak

Durasi yang berlalu setelah video input diputar sebelum adegan pembuka diputar. Nilai dimulai dari 0.

• Unit: detik.

• Nilai default: 0.

Width

String

Tidak

Lebar video output dapat diatur dengan tiga cara:

• Lebar: Lebar dalam piksel. Nilainya harus bilangan bulat dari 0 hingga 4096.

• -1: Lebar sama dengan lebar slate pembuka video input.

• Full: Video mengisi seluruh area pemutaran.

• Nilai default: -1.

Height

String

Tidak

Anda dapat mengatur tinggi video output dengan tiga cara:

• Lebar: Lebar dalam piksel. Nilainya harus bilangan bulat dari 0 hingga 4096.

• -1: Sama dengan tinggi video input.

• full: Mengisi seluruh frame video.

• Nilai default: -1.

Parameter

Tipe

Wajib

Deskripsi

TailUrl

String

Ya

URL video slate akhir di OSS.

• Jalur objek OSS harus dikodekan URL dalam UTF-8 sebelum digunakan di MPS. Untuk informasi lebih lanjut, lihat Pengkodean URL.

• Contoh: http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_01.flv.

BlendDuration

String

Tidak

Jumlah waktu antara akhir bagian utama dan awal bagian penutup. Selama transisi, frame terakhir bagian utama memudar keluar, dan frame pertama bagian penutup memudar masuk.

• Unit: detik.

• Nilai default: 0.

Width

String

Tidak

Lebar bagian penutup output. Nilai yang valid:

• Lebar: Lebar, dalam piksel, harus dalam rentang [0, 4096].

• -1: Lebar sama dengan video outro input.

• full: Video mengisi seluruh frame.

• Nilai default: -1.

Height

String

Tidak

Tinggi slate akhir output memiliki tiga pengaturan yang tersedia:

• Lebar: Lebar dalam piksel. Nilainya harus bilangan bulat dari 0 hingga 4096.

• -1: Tinggi video slate input.

• full: Video mengisi area pemutaran.

• Nilai default: -1.

IsMergeAudio

Boolean

Tidak

Menentukan apakah akan menambahkan audio video outro.

• true: Mengaktifkan penggabungan.

• false: Tidak terjadi penggabungan.

• Nilai default: true.

BgColor

String

Tidak

Warna margin jika lebar dan tinggi bagian penutup kurang dari bagian utama.

• Untuk informasi lebih lanjut tentang warna yang didukung, lihat kolom name di bgcolor.

• Nilai default: White.

Parameter

Tipe

Wajib

Deskripsi

AmixURL

String

Ya

Aliran audio yang akan dicampur mendukung dua mode:

• input: mencampur beberapa aliran audio file input. Anda dapat mencampur dua aliran audio file input.

• Jalur OSS: menambahkan aliran audio eksternal. Misalnya, Anda dapat menambahkan musik latar. Anda dapat mencampur aliran audio file input dengan aliran audio yang ditentukan oleh jalur OSS. Contoh: http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail.flv.

Map

String

Tidak

Untuk memilih aliran audio target untuk pencampuran dalam AmixURL, gunakan parameter AudioStreamMap untuk menentukan nomor urut aliran audio dalam file input.

• Format: 0:a:{Nomor seri}. Nomor seri menentukan subskrip aliran audio. Nomor seri dimulai dari 0.

• Misalnya, 0:a:1 menentukan aliran audio kedua.

MixDurMode

String

Tidak

Durasi file output campuran.

• first: Panjang file input digunakan.

• longest: Yang lebih panjang antara panjang file input dan aliran audio yang ditentukan oleh parameter AmixURL digunakan.

• Nilai default: longest.

Start

String

Tidak

Titik awal waktu aliran audio. Tentukan parameter ini jika Anda hanya ingin mencampur bagian audio ke file output. Titik awal waktu default adalah awal audio.

• Format: hh:mm:ss[.SSS] atau sssss[.SSS].

• Nilai yang valid: [00:00:00.000,23:59:59.999] atau [0.000,86399.999].

• Contoh: 00:01:59.999 atau 18000.30.

Duration

String

Tidak

Panjang audio campuran. Panjang relatif terhadap titik awal waktu yang ditentukan oleh parameter Start. Tentukan parameter ini jika Anda hanya ingin mencampur bagian audio ke file output. Secara default, panjangnya adalah periode dari titik awal waktu yang ditentukan oleh parameter Start hingga akhir audio.

• Format: hh:mm:ss[.SSS] atau sssss[.SSS].

• Nilai yang valid: [00:00:00.000,23:59:59.999] atau [0.000,86399.999].

• Contoh: 00:01:59.999 atau 18000.30.

Parameter

Type

Wajib

Deskripsi

Segment

String

Tidak

Konfigurasi segmen. Untuk informasi lebih lanjut, lihat bagian Segment pada topik ini.

• Parameter ini hanya berlaku jika format kontainer diatur ke M3U8, HLS-FMP4, MPD, atau CMAF.

• Contoh: {"Duration":"10","ForceSegTime":"1,2,4,6,10,14,18"}, yang menentukan bahwa video dipotong secara paksa pada detik ke-1, ke-2, ke-4, ke-6, ke-10, ke-14, ke-18, ke-20, ke-30, ke-40, ke-50, dan seterusnya.

Parameter

Tipe

Wajib

Deskripsi

Duration

Int

Tidak

Durasi segmen.

• Unit: detik.

• Nilai yang valid: [1,60].

• Nilai default: 10, yang menentukan bahwa video dipotong secara paksa pada detik ke-10, ke-20, ke-30, dan ke-40.

ForceSegTime

String

Tidak

Titik waktu di mana video dipotong secara paksa. Pisahkan titik waktu dengan koma (,). Anda dapat menentukan hingga 10 titik waktu.

• Format: {Titik waktu},{Titik waktu},{Titik waktu}.

• Tipe: desimal. Parameter ini mendukung hingga tiga tempat desimal.

• Unit: detik.

• Contoh: 1,2,4,6,10,14,18, yang menentukan bahwa video dipotong secara paksa pada detik ke-1, ke-2, ke-4, ke-6, ke-10, ke-14, dan ke-18.

Parameter

Tipe

Wajib

Deskripsi

TS

Object

Tidak

Dukungan non-standar untuk file TS. Untuk informasi lebih lanjut, lihat bagian TS pada topik ini.

Parameter

Tipe

Wajib

Deskripsi

Md5Support

Boolean

Tidak

Menentukan apakah akan menyertakan nilai MD5 setiap file TS dalam video M3U8 output.

SizeSupport

Boolean

Tidak

Menentukan apakah akan menyertakan ukuran setiap file TS dalam video M3U8 output.

Parameter

Tipe

Wajib

Deskripsi

Type

String

Ya

Metode enkripsi video. Nilai yang valid:

• hls-aes-128: enkripsi standar.

KeyType

String

Ya

Metode enkripsi kunci.

• Base64: metode enkripsi dasar.

• KMS: Key Management Service (KMS). KMS digunakan untuk menghasilkan kunci plaintext dan ciphertext.

Key

String

Ya

Kunci ciphertext untuk video terenkripsi. Format kunci ditentukan oleh metode enkripsi.

• Base64:

  • Enkripsi kunci plaintext menggunakan Base64 dan atur parameter ini ke kunci ciphertext yang dihasilkan.

  • Kunci plaintext dikustomisasi dan panjangnya dapat mencapai 16 karakter.

  • Sebagai contoh, kunci ciphertext yang sesuai untuk kunci plaintext "encryptionkey128" adalah "ZW5jcnlwdGlvbmtleTEyOA==".

• KMS:

  • Panggil operasi GenerateKMSDataKey, masukkan customer master key (CMK), lalu atur parameter KeySpec ke AES_128 untuk mendapatkan kunci ciphertext yang sesuai dari parameter CiphertextBlob.

KeyUri

String

Ya

Ini adalah titik akhir layanan dekripsi. Anda harus mengatur layanan ini sendiri.

• URL tidak dapat diteruskan ke MPS dalam bentuk plaintext. Anda harus mengenkripsi URL dalam Base64.

• Sebagai contoh, jika URL adalah http://aliyun.com/document/hls128.key, URL tersebut dienkripsi menjadi aHR0cDovL2FsaXl1bi5jb20vZG9jdW1lbnQvaGxzMTI4LmtleQ== dalam Base64.

SkipCnt

String

Tidak

Jumlah clip yang tidak dienkripsi di awal video. Hal ini memastikan waktu pemuatan lebih singkat selama startup.

• Contoh: 3.

Parameter

Tipe

Wajib

Deskripsi

Num

String

Tidak

Jumlah tangkapan yang akan diambil.

• Jika Anda menentukan salah satu parameter Interval dan Num, mode asinkron digunakan secara default. Nilai parameter Num harus lebih besar dari 0.

• Jika Anda membiarkan parameter Num dan Interval kosong dan menentukan parameter Time, sistem secara sinkron mengambil satu tangkapan pada waktu yang Anda tentukan.

• Jika Anda mengatur parameter Num ke 1 dan menentukan parameter Time, sistem secara asinkron mengambil satu tangkapan pada waktu yang Anda tentukan.

• Jika Anda mengatur parameter Num ke nilai lebih dari 1, sistem mulai mengambil tangkapan secara asinkron pada waktu yang Anda tentukan untuk parameter Time dan berhenti ketika jumlah tangkapan yang diambil mencapai jumlah yang Anda tentukan untuk parameter Num. Tangkapan diambil pada interval yang ditentukan oleh parameter Interval. Jika Anda tidak menentukan parameter Interval, tangkapan diambil setiap 10 detik. Jika hasil dari Time + Interval × Num lebih besar dari panjang video input, hanya tangkapan yang diambil pada titik waktu dalam panjang video input yang dapat dihasilkan. Setelah tangkapan dihasilkan, jumlah aktual tangkapan dikembalikan.

• Jika Anda mengatur parameter Num ke nilai lebih dari 1 dan parameter Interval ke 0, sistem mulai mengambil tangkapan secara asinkron pada titik waktu yang Anda tentukan untuk parameter Time. Jumlah tangkapan ditentukan oleh parameter Num dan tangkapan diambil secara merata dalam panjang video input.

Time

String

Tidak

Titik waktu di mana sistem mulai mengambil tangkapan dalam video input.

• Unit: milidetik.

• Jika nilai parameter Time melebihi panjang video, tangkapan gagal dihasilkan.

• Parameter ini tidak wajib jika tangkapan diambil pada titik waktu tertentu. Dalam skenario lain, parameter ini wajib.

  Catatan

  Dalam skenario di mana tangkapan diambil pada titik waktu tertentu, MPS mengonversi titik waktu minimum dalam parameter TimeArray menjadi nilai dalam milidetik. Nilai ini digunakan untuk parameter Time dalam skenario ini. Jika Anda menentukan placeholder {SnapshotTime} dalam jalur output, placeholder tersebut diganti dengan nilai parameter Time.

Interval

String

Tidak

Interval pengambilan tangkapan.

• Jika Anda menentukan parameter ini, mode asinkron secara otomatis digunakan untuk mengambil tangkapan.

• Atur parameter Interval ke nilai lebih dari 0 jika Anda ingin mengambil beberapa tangkapan secara asinkron. Unit: detik.

• Interval untuk tangkapan rata-rata asinkron adalah 0.

• Nilai default adalah 10. Nilai ini dikirim jika `Num` diatur tetapi parameter ini tidak ditentukan.

TimeArray

Array

Tidak

Array titik waktu tertentu. Parameter ini wajib jika Anda mengambil tangkapan pada titik waktu tertentu.

• Nilainya harus bilangan bulat unik dalam milidetik.

• Titik waktu tidak boleh melebihi panjang video. Jika tidak, tangkapan tidak dapat diambil.

• Anda dapat menentukan titik waktu secara berurutan atau tidak berurutan. Kami menyarankan Anda menentukan titik waktu secara berurutan. Jika Anda menentukan titik waktu tidak berurutan, MPS mengurutkan titik waktu tersebut.

FrameType

String

Tidak

Menentukan jenis tangkapan layar.

• Nilai default: intra.

• normal: frame biasa. Kualitas gambar frame biasa lebih rendah daripada frame kunci. Selain itu, waktu yang dibutuhkan untuk mengambil frame biasa lebih lama daripada frame kunci. Namun, frame biasa dapat diambil pada titik waktu tertentu.

• intra (default): frame kunci. Frame kunci video memiliki kualitas gambar yang baik dan dapat diambil dengan cepat karena frame kunci didekode secara independen. Namun, frame kunci muncul dalam video pada interval dan tidak dapat diambil pada titik waktu tertentu. Jika titik waktu yang Anda tentukan tidak akurat, sistem mengambil frame kunci yang paling dekat dengan titik waktu yang Anda tentukan. Dalam hal ini, jika jarak antara dua frame kunci lebih besar daripada interval pengambilan tangkapan, jumlah tangkapan yang dihasilkan mungkin kurang dari jumlah tangkapan yang ingin Anda ambil.

Width

String

Tidak

Lebar tangkapan.

• Unit: piksel.

• Nilai yang valid: [8,4096]. Kami menyarankan Anda menentukan bilangan genap.

• Nilai default:

  • Secara default, jika Anda tidak menentukan lebar atau tinggi, lebar video input digunakan.

  • Jika hanya tinggi yang ditentukan, lebar tangkapan dihitung berdasarkan rasio aspek video input.

Height

String

Tidak

Tinggi tangkapan.

• Unit: piksel.

• Nilai yang valid: [8,4096]. Kami menyarankan Anda menentukan bilangan genap.

• Nilai default:

  • Secara default, jika Anda tidak menentukan lebar atau tinggi, tinggi video input digunakan.

  • Jika hanya lebar yang ditentukan, tinggi tangkapan dihitung berdasarkan rasio aspek video input.

BlackLevel

String

Tidak

Batas atas piksel hitam dalam tangkapan. Jika piksel hitam dalam tangkapan melebihi nilai ini, sistem menentukan bahwa gambar adalah Layar hitam. Untuk informasi lebih lanjut tentang piksel hitam, lihat deskripsi parameter PixelBlackThreshold.

PixelBlackThreshold

String

Tidak

Ambang batas nilai warna untuk piksel. Jika nilai warna piksel kurang dari ambang batas, sistem menentukan bahwa piksel tersebut adalah piksel hitam.

• Nilai yang valid: [0,255]. 0 menentukan piksel hitam murni dan 255 menentukan piksel putih murni.

• Jika Anda ingin meningkatkan penyaringan Layar hitam, tentukan nilai yang lebih tinggi untuk parameter ini. Kami menyarankan Anda mengatur parameter ini ke 30 dan menyesuaikan nilainya sesuai kebutuhan.

• Sebagai contoh, jika Anda mengatur parameter ini ke 100, piksel yang nilai warnanya kurang dari 100 dianggap sebagai piksel hitam.

Format

String

Tidak

Format file output.

• Jika Anda mengatur parameter ini ke vtt, file output dalam format WebVTT. Anda harus menentukan parameter SubOut untuk menentukan apakah akan menghasilkan file WebVTT.

• Secara default, parameter ini dibiarkan kosong. Dalam hal ini, file output dihasilkan dalam format JPG.

SubOut

Object

Tidak

Konfigurasi file WebVTT. Untuk informasi lebih lanjut, lihat bagian SubOut Webvtt pada topik ini.

• Parameter ini wajib jika parameter Format diatur ke vtt.

TileOut

Object

Tidak

Konfigurasi gambar sprite. Untuk informasi lebih lanjut, lihat bagian TileOut pada topik ini.

• Setelah Anda mengatur parameter ini, tangkapan yang dihasilkan digabungkan menjadi gambar sprite. Parameter TileOutputFile menentukan output gambar sprite.

• Jika Anda membiarkan parameter ini kosong, tidak ada gambar sprite yang dihasilkan.

OutputFile

Object

Ya

Output adalah file gambar kecil tunggal yang disimpan di lokasi yang ditentukan oleh Bucket OSS, Location, dan Object. Untuk informasi lebih lanjut, lihat Detail tangkapan OutputFile.

• File tangkapan dalam format JPG.

• Contoh: {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.jpg"}.

TileOutputFile

Object

Tidak

Output gambar sprite. Anda harus menentukan jalur penyimpanan objek di OSS. Nilai parameter ini mirip dengan nilai parameter OutputFile.

• Parameter ini wajib jika Anda menentukan parameter TileOut untuk menghasilkan gambar sprite.

• File puzzle dalam format JPG.

• Contoh: {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.jpg"}.

Parameter

Tipe

Wajib

Deskripsi

IsSptFrag

String

Tidak

Menentukan apakah akan menghasilkan file indeks WebVTT. Nilai yang valid:

• true: menghasilkan file indeks WebVTT. File indeks WebVTT disimpan di jalur yang sama dengan tangkapan.

• false: tidak menghasilkan file indeks WebVTT. Hanya tangkapan yang diekspor.

• Nilai default: false.

Parameter

Tipe

Wajib

Deskripsi

Lines

Int

Tidak

Jumlah baris yang berisi tangkapan berpetak.

• Nilai yang valid: (0,10000].

• Nilai default: 10.

Columns

Int

Tidak

Jumlah kolom yang berisi tangkapan berpetak.

• Nilai yang valid: (0,10000].

• Nilai default: 10.

CellWidth

String

Tidak

Lebar gambar tunggal.

• Unit: piksel.

• Nilai default: lebar tangkapan asli.

CellHeight

String

Tidak

Tinggi gambar tunggal.

• Unit: piksel.

• Nilai default: tinggi tangkapan asli.

Padding

String

Tidak

Pitch gambar tunggal

• Unit: piksel.

• Nilai default: 0.

Margin

String

Tidak

Lebar bingkai.

• Nilai default: 0.

• Unit: piksel.

Color

String

Tidak

Warna latar belakang. Warna latar belakang yang digunakan untuk mengisi margin, padding antar tangkapan, dan area tempat tidak ada tangkapan yang ditampilkan.

• Anda dapat menentukan kata kunci warna atau nilai acak untuk parameter ini. Misalnya, jika Anda ingin mengatur warna latar belakang menjadi hitam, Anda dapat menentukan kata kunci warna dalam salah satu format berikut: Black, black, dan #000000.

• Nilai default: black.

IsKeepCellPic

String

Tidak

Menentukan apakah akan menyimpan thumbnail individual.

• true: Grafik tunggal disimpan di OutputFile.

• false: Item tidak dipertahankan.

• Default: false (tidak dipertahankan).

Parameter

Type

Wajib

Deskripsi

Bucket

String

Ya

Bucket OSS tempat file output gambar kecil individual disimpan.

• Bucket harus mematuhi definisi Bucket OSS. Untuk informasi lebih lanjut, lihat Konsep Dasar.

Location

String

Ya

Wilayah tempat bucket OSS berada.

• Bucket OSS harus berada di wilayah yang sama dengan MPS.

• Patuhi definisi Wilayah OSS. Untuk informasi lebih lanjut, lihat Konsep Dasar.

Object

String

Ya

Jalur tempat tangkapan output disimpan di OSS.

• Jalur mencakup nama file dan ekstensi nama file. Untuk informasi lebih lanjut tentang istilah object key, lihat Istilah.

• Placeholder didukung. Untuk informasi lebih lanjut, lihat bagian Aturan penggantian placeholder pada topik ini.

• Satu-satunya ekstensi nama file yang didukung adalah .jpg.

• Jalur objek OSS harus dikodekan URL dalam UTF-8 sebelum digunakan di MPS. Untuk informasi lebih lanjut, lihat Pengkodean URL.

Parameter

Tipe

Wajib

Deskripsi

QueueName

String

Tidak

Antrian MNS yang dilampirkan. Ketika pekerjaan di antrian MPS selesai, hasil eksekusinya dikirim ke antrian ini. Untuk informasi lebih lanjut tentang cara menerima notifikasi pesan, lihat Menerima notifikasi pesan.

• Anda dapat menentukan salah satu parameter QueueName dan Topic.

• Nilai yang valid: Topik MNS yang telah Anda buat. Jika tidak ada topik aktif yang tersedia, Anda dapat membuka Simple Message Queue (formerly MNS) untuk membuatnya.

Topic

String

Tidak

Topik SMQ tempat Anda ingin menerima notifikasi. Setelah pekerjaan selesai, hasil pekerjaan didorong ke topik SMQ. Kemudian, topik SMQ mendorong pesan ke beberapa antrian atau URL yang berlangganan ke topik tersebut. Untuk informasi lebih lanjut tentang menerima notifikasi, lihat Menerima notifikasi.

• Anda dapat menentukan salah satu parameter QueueName dan Topic.

• Nilainya harus berupa topik MNS yang telah Anda buat. Jika tidak ada topik yang tersedia, buka konsol Simple Message Queue (formerly MNS) untuk membuatnya.

Parameter

Tipe

Wajib

Deskripsi

Bucket

String

Ya

Bucket OSS tempat file input disimpan.

• Berikan izin baca pada bucket OSS ke ApsaraVideo Media Processing di halaman Otorisasi Bucket di konsol OSS.

• Bucket harus sesuai dengan definisi bucket OSS. Untuk informasi lebih lanjut, lihat Glosarium.

Location

String

Ya

Wilayah tempat bucket OSS berada.

Ikuti definisi Lokasi OSS. Untuk informasi lebih lanjut, lihat Glosarium.

Object

String

Ya

Objek OSS yang digunakan sebagai file input.

• Jalur objek OSS harus mematuhi RFC 2396 dan dikodekan URL dalam UTF-8. Untuk informasi lebih lanjut, lihat Pengkodean URL.

• Ini mematuhi definisi Objek OSS. Untuk informasi lebih lanjut, lihat Glosarium.

Audio

String

Tidak

Konfigurasi audio file input. Nilainya harus berupa objek JSON.

• Untuk informasi lebih lanjut, lihat bagian InputAudio pada topik ini.

• Contoh: {"Channels":"2","Samplerate":"44100"}.

Container

String

Tidak

Konfigurasi kontainer file input. Nilainya harus berupa objek JSON.

• Untuk informasi lebih lanjut, lihat bagian InputContainer pada topik ini.

• Contoh: {"Format":"u8"}.

Parameter

Type

Wajib

Deskripsi

Format

String

Ya

Format audio file input.

Nilai yang valid: alaw, f32be, f32le, f64be, f64le, mulaw, s16be, s16le, s24be, s24le, s32be, s32le, s8, u16be, u16le, u24be, u24le, u32be, u32le, dan u8.

Parameter

Tipe

Wajib

Deskripsi

Channels

String

Ya

Jumlah saluran suara dalam file input. Nilai yang valid: [1,8].

Samplerate

String

Ya

Laju pengambilan sampel audio file input.

• Nilai yang valid: (0,320000].

• Unit: Hz.

Parameter

Type

Wajib

Deskripsi

QualityControl

String

Tidak

Konfigurasi kualitas file output. Nilainya harus berupa objek JSON. Untuk informasi lebih lanjut, lihat bagian QualityControl pada topik ini.

PropertiesControl

String

Tidak

Konfigurasi properti. Nilainya harus berupa objek JSON. Untuk informasi lebih lanjut, lihat bagian PropertiesControl pada topik ini.

Parameter

Tipe

Wajib

Deskripsi

RateQuality

String

Tidak

Tingkat kualitas file output.

• Nilai yang valid: (0,51).

• Nilainya harus bilangan bulat.

• Nilai default: 25.

MethodStreaming

String

Tidak

Mode pemutaran. Nilai yang valid: network dan local.

Nilai default: network.

Parameter

Tipe

Wajib

Deskripsi

Deinterlace

String

Tidak

Menentukan mode pemindaian paksa.

• Auto adalah singkatan dari Automatic.

• Force: menjalankan deinterlacing secara paksa.

• None: melarang deinterlacing.

Crop

String

Tidak

Konfigurasi pemotongan gambar video.

• Nilai default adalah Automatic.

• Jika Anda tidak mengatur parameter ini ke objek JSON kosong, parameter Mode wajib.

• Untuk informasi lebih lanjut, lihat bagian Crop pada topik ini.

Parameter

Tipe

Wajib

Deskripsi

Mode

String

Tidak

Parameter ini wajib jika nilai parameter Crop bukan objek JSON kosong. Nilai yang valid:

• Auto (Automatic)

• Force: menjalankan pemotongan secara paksa.

• None: Tidak ada operasi yang dilakukan.

Width

Integer

Tidak

Lebar yang dipotong

• Nilai yang valid: [8,4096].

• Jika Anda mengatur parameter Mode ke Auto atau None, pengaturan parameter ini tidak valid.

Height

Integer

Tidak

Tinggi gambar yang dipotong.

• Nilai yang valid: [8,4096].

• Jika Anda mengatur parameter Mode ke Auto atau None, pengaturan parameter ini tidak valid.

Top

Integer

Tidak

Margin atas yang akan dipotong.

• Nilai yang valid: [8,4096].

• Jika Anda mengatur parameter Mode ke Auto atau None, pengaturan parameter ini tidak valid.

Left

Integer

Tidak

Margin kiri yang akan dipotong.

• Nilai yang valid: [8,4096].

• Jika Anda mengatur parameter Mode ke Auto atau None, pengaturan parameter ini tidak valid.

Parameter

Tipe

Wajib

Deskripsi

MergeList

String

Tidak

Bidang konfigurasi untuk penggabungan video.

• Nilainya harus berupa array JSON yang berisi hingga empat parameter MergeURL. Untuk informasi lebih lanjut, lihat bagian MergeList pada topik ini.

• Contoh: [{"MergeURL":"http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/k/mp4.mp4"},{"MergeURL":"http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/c/ts.ts","Start":"1:14","Duration":"29"}].

Parameter

Tipe

Wajib

Deskripsi

URL

String

Tidak

URL file input di OSS.

• Contoh: http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example.flv.

• Jika Anda tidak menentukan parameter ini, parameter Bucket, Location, dan Object wajib.

Bucket

String

Tidak

• Nilai ini wajib jika Anda tidak menentukan URL.

• Jika tidak, pengaturan parameter ini tidak valid. Sebelum menentukan bucket OSS, berikan izin tulis pada bucket OSS ke MPS di halaman Kontrol Akses di konsol OSS.

• Untuk informasi lebih lanjut tentang istilah bucket, lihat Glosarium.

Location

String

Tidak

• Nilai ini wajib jika Anda tidak menentukan URL.

• Jika tidak, nilainya tidak valid dan data center (Lokasi OSS) dari Bucket OSS dikeluarkan.

• Ini mematuhi definisi Lokasi OSS. Untuk informasi lebih lanjut, lihat Glosarium.

Object

String

Tidak

• Nilai ini wajib jika Anda tidak menentukan URL.

• Jika nilainya tidak valid, file output (Objek OSS) dikodekan dalam UTF-8 lalu dikodekan URL sesuai RFC 2396. Untuk informasi lebih lanjut, lihat Pengkodean URL.

• Ini harus sesuai dengan definisi Objek OSS. Untuk informasi lebih lanjut, lihat Glosarium.

Parameter

Tipe

Wajib

Deskripsi

URI

String

Tidak

Nama aliran video output, yang harus diakhiri dengan .m3u8. Contoh: a/b/test.m3u8. Format: ^[a-z]{1}[a-z0-9./-]+$.

RefActivityName

String

Ya

Nama aktivitas terkait.

ExtXStreamInfo

Json

Ya

Informasi tentang aliran. Contoh: {"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}.

Parameter

Tipe

Wajib

Deskripsi

Name

String

Ya

Nama resource. Nama dapat mencapai panjang 64 byte dan harus dikodekan dalam UTF-8. Parameter ini sesuai dengan NAME dalam protokol HTTP Live Streaming (HLS) V5.

Language

String

Tidak

Opsional. Kode bahasa dalam format RFC 5646 yang sesuai dengan atribut `LANGUAGE` protokol HLS V5.

URI

String

Ya

Jalur resource.

Format: ^[a-z]{1}[a-z0-9./-]+$. Contoh: a/b/c/d/audio-1.m3u8.

Parameter

Tipe

Wajib

Deskripsi

MultiBitrateVideoStreams

JsonArray

Ya

Array beberapa aliran. Contoh: [{"RefActivityName": "video-1","ExtXStreamInfo": {"BandWidth": "111110","Audio":"auds","Subtitles": "subs"}}].

Parameter

Tipe

Wajib

Deskripsi

BandWidth

String

Ya

Bandwidth. Parameter ini menentukan batas atas bitrate total dan sesuai dengan BANDWIDTH dalam protokol HLS V5.

Audio

String

Tidak

ID grup aliran audio. Parameter ini sesuai dengan AUDIO dalam protokol HLS V5.

Subtitles

String

Tidak

ID grup aliran subtitle. Parameter ini sesuai dengan SUBTITLES dalam protokol HLS V5.

Parameter

Tipe

Wajib

Deskripsi

Group

String

Ya

Nama grup. Contoh:

<AdaptationSet group="videostreams" mimeType="video/mp4" par="4096:1744"
              minBandwidth="258157" maxBandwidth="10285391" minWidth="426" maxWidth="4096"
              minHeight="180" maxHeight="1744" segmentAlignment="true"
              startWithSAP="1">

Lang

String

Tidak

Bahasa resource. Anda dapat menentukan parameter ini untuk resource audio dan subtitle.

Parameter

Type

Wajib

Deskripsi

Id

String

Ya

ID aliran. Contoh:

<Representation id="240p250kbps" frameRate="24" bandwidth="258157"
              codecs="avc1.4d400d" width="426" height="180">

URI

String

Ya

Jalur resource. Format: ^[a-z]{1}[a-z0-9./-]+$. Contoh: a/b/c/d/video-1.mpd.

Parameter

Type

Wajib

Deskripsi

Format

String

Ya

Format file subtitle input. Nilai yang valid: stl, ttml, dan vtt.

InputFile

String

Ya

{"Bucket":"example-bucket-****","Location":"oss-cn-hangzhou","Object":"example-logo****.png"}
              or
              {"URL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/subtitle/test****.chs.vtt"}