Gunakan API QueryJobList untuk mengkueri pekerjaan transkode berdasarkan ID pekerjaan - ApsaraVideo Media Processing

Anda dapat mengkueri beberapa pekerjaan transkoding berdasarkan ID-nya.

Deskripsi operasi

API ini memungkinkan Anda mengkueri hingga 10 pekerjaan transkoding sekaligus.
Jika Anda tidak menyediakan JobIds, sistem akan mengembalikan kode kesalahan InvalidParameter.

Batas QPS

API ini memiliki batas QPS (Queries Per Second) per pengguna sebesar 100 panggilan per detik. Jika batas ini terlampaui, panggilan API akan dibatasi lajunya (rate-limited), yang dapat memengaruhi bisnis Anda. Gunakan API sesuai kebutuhan. Untuk informasi selengkapnya, lihat Batas QPS.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

mts:QueryJobList

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
JobIds	string	No	ID pekerjaan transkoding. Anda dapat mengkueri maksimal 10 pekerjaan sekaligus. Pisahkan beberapa ID pekerjaan dengan koma (,). Anda dapat memperoleh ID pekerjaan dari halaman Job Management di Konsol MPS atau dari parameter respons yang dikembalikan setelah Anda mengirimkan pekerjaan transkoding. Catatan Jika parameter ini tidak ditentukan, kode kesalahan `InvalidParameter` akan dikembalikan.	bb558c1cc25b45309aab5be44d19**,d1ce4d3efcb549419193f50f1fcd**

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
NonExistJobIds	object
String	array	ID pekerjaan yang tidak ada.
	string	Daftar ID pekerjaan transkoding yang tidak ada. Struktur ini tidak dikembalikan jika tidak ada ID semacam itu.	d1ce4d3efcb549419193f50f1fcd****
RequestId	string	ID permintaan.	197ADF44-104C-514C-9F92-D8924CB34E2A
JobList	object
Job	array<object>	Daftar pekerjaan transkoding.
	array<object>	Detail pekerjaan transkoding.
CreationTime	string	Waktu saat pekerjaan dikirimkan.	2014-01-10T12:00:00Z
Percent	integer	Kemajuan transkoding, dalam persentase.	100
FinishTime	string	Waktu saat pekerjaan selesai.	2014-01-10T12:20:25Z
State	string	Status pekerjaan. Submitted: Pekerjaan telah dikirimkan. Transcoding: Transkoding sedang berlangsung. TranscodeSuccess: Transkoding berhasil. TranscodeFail: Transkoding gagal. TranscodeCancelled: Transkoding dibatalkan.	TranscodeSuccess
JobId	string	ID pekerjaan.	31fa3c9ca8134fb4b0b0f7878301****
Code	string	Kode kesalahan untuk pekerjaan yang gagal. Parameter ini tidak dikembalikan untuk pekerjaan yang berhasil.	InvalidParameter.NullValue
Message	string	Pesan kesalahan untuk pekerjaan yang gagal. Parameter ini tidak dikembalikan untuk pekerjaan yang berhasil.	The specified parameter "%s" cannot be null.
Output	object	Output pekerjaan.
Video	object	Konfigurasi video.
Bufsize	string	Ukuran buffer. Unit: Kb. Nilai default: 6000.	6000
Degrain	string	Kekuatan algoritma penghilangan derau mandiri.	5
BitrateBnd	object	Rentang bitrate rata-rata video.
Max	string	Bitrate maksimum.	1000
Min	string	Bitrate minimum.	300
PixFmt	string	Format warna video. Nilai yang valid meliputi yuv420p dan yuvj420p.	yuv420p
Pad	string	Tambahkan bilah hitam ke video. Unit: px. Format: width:height:left:top.	1280:800:0:140
Codec	string	Format kodek. Nilai yang valid: H.264 dan H.265. Nilai default: H.264.	H.264
Height	string	Tinggi video output. Unit: px. Nilai default: Tinggi asli video input.	720
Qscale	string	Faktor kontrol kualitas video.	15
Crop	string	Potong frame video. Metode yang didukung: Otomatis mendeteksi dan memotong bilah hitam. Atur parameter ini ke border. Pemotongan kustom. Format: width:height:left:top.	1280:800:0:140
Bitrate	string	Bitrate rata-rata video. Unit: Kbps.	500
Maxrate	string	Bitrate puncak video. Unit: Kbps.	3000
MaxFps	string	Laju frame maksimum.	60
Profile	string	Profil encoding. Nilai yang valid: baseline, main, dan high. Catatan Jika Anda memiliki beberapa resolusi, gunakan baseline untuk resolusi terendah agar pemutaran kompatibel dengan perangkat low-end. Gunakan main atau high untuk resolusi lainnya. baseline: Untuk perangkat seluler. main: Untuk perangkat resolusi standar. high: Untuk perangkat resolusi tinggi. Nilai default: high.	high
Crf	string	Constant Rate Factor (CRF) untuk kontrol bitrate-kualitas. Nilai default: 23 untuk H.264 dan 26 untuk H.265. Jika CRF diatur, pengaturan Bitrate akan diabaikan.	26
Gop	string	Interval waktu maksimum atau jumlah frame antara keyframe. Unit: detik. Nilai default: 250. Tidak ada unit saat menentukan jumlah maksimum frame.	250
Width	string	Lebar video output. Unit: px. Nilai default: Lebar asli video input.	1280
Fps	string	Laju frame. Unit: fps. Jika laju frame file input melebihi 60, nilainya dibatasi hingga 60. Nilai default: Laju frame file input.	25
Preset	string	Preset untuk penyandi video. Nilai default: medium. Nilai yang valid: veryfast: Sangat cepat. fast: Cepat. medium: Sedang. slow: Lambat. slower: Sangat lambat.	medium
ScanMode	string	Mode pemindaian. Nilai yang valid: Not set: Gunakan mode pemindaian asli file input. auto: Auto-deinterlace. progressive: Pemindaian progresif (baris demi baris). interlaced: Pemindaian interlaced. Default value: Kosong (tidak diatur). Best practice: Pemindaian interlaced menghemat bandwidth tetapi mengurangi kualitas. Sebagian besar video modern menggunakan pemindaian progresif. Jika Anda mengatur progressive atau interlaced tetapi tidak sesuai dengan sumber, transkoding akan gagal. Kami merekomendasikan menggunakan mode pemindaian asli atau auto-deinterlace untuk kompatibilitas yang lebih baik.	interlaced
ResoPriority	string	Prioritas sumber daya.	1
TransConfig	object	Konfigurasi transkoding umum. Catatan Jika Anda menentukan nilai-nilai ini dalam permintaan, mereka akan menggantikan pengaturan yang sesuai dalam template transkoding.
IsCheckAudioBitrate	string	Apakah akan memeriksa bitrate audio. Jika bitrate audio output melebihi bitrate audio sumber, bitrate output diatur ke bitrate sumber, dan bitrate yang Anda konfigurasikan diabaikan. Pengaturan ini memiliki prioritas lebih rendah daripada IsCheckAudioBitrateFail. true: Periksa. false: Jangan periksa. Nilai default: Parameter kosong dan kodek berbeda dari sumber: false. Parameter kosong dan kodek sama dengan sumber: true.	false
TransMode	string	Mode transkoding. Nilai yang valid: onepass, twopass, dan CBR. Nilai default: onepass.	onepass
IsCheckReso	string	Apakah akan memeriksa resolusi. Jika resolusi output melebihi resolusi input (lebar atau tinggi), resolusi output diatur ke resolusi input. true: Periksa. false: Jangan periksa. Nilai default: false.	false
IsCheckVideoBitrateFail	string	Apakah akan memeriksa bitrate video. Jika bitrate video output melebihi bitrate video sumber, transkoding langsung gagal. Pengaturan ini memiliki prioritas lebih tinggi daripada IsCheckVideoBitrate. true: Periksa. false: Jangan periksa. Nilai default: false.	false
AdjDarMethod	string	Metode penyesuaian resolusi. Nilai default: none. Nilai yang valid: rescale, crop, pad, dan none.	none
IsCheckVideoBitrate	string	Apakah akan memeriksa bitrate video. Jika bitrate video output melebihi bitrate video input, bitrate output diatur ke bitrate input. true: Periksa. false: Jangan periksa. Nilai default: false.	false
IsCheckResoFail	string	Apakah akan memeriksa resolusi. Jika resolusi output melebihi resolusi input (lebar atau tinggi), transkoding gagal. true: Periksa. false: Jangan periksa. Nilai default: false.	false
IsCheckAudioBitrateFail	string	Apakah akan memeriksa bitrate audio. Jika bitrate audio output melebihi bitrate audio sumber, transkoding langsung gagal. Pengaturan ini memiliki prioritas lebih tinggi daripada IsCheckAudioBitrate. true: Periksa. false: Jangan periksa. Nilai default: false.	false
Encryption	object	Enkripsi data. Hanya didukung untuk output m3u8.
Type	string	Jenis enkripsi. Nilai yang valid: hls-aes-128.	hls-aes-128
Key	string	Kunci enkripsi untuk video.	encryptionkey128
KeyType	string	Metode enkripsi kunci. Nilai yang valid: Base64 dan KMS. Catatan Contohnya, jika kuncinya adalah `"encryptionkey128"`, maka `Base64("encryptionkey128")` atau `KMS(Base64("encryptionkey128"))`.	Base64
Id	string	ID enkripsi.	31fa3c9ca8134f9cec2b4b0b0f78****
KeyUri	string	URL untuk mengakses kunci. Diencode dengan BASE64.	https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/
SkipCnt	string	Jumlah segmen awal yang tidak dienkripsi (untuk memungkinkan pemutaran cepat).	3
WaterMarkList	object
WaterMark	array<object>	Daftar watermark.
	array<object>	Detail watermark.
Type	string	Jenis watermark. Jika ditentukan dalam permintaan, nilai ini menggantikan parameter yang sesuai dalam template watermark. Untuk informasi lebih lanjut, lihat Detail parameter. Nilai yang valid: Image: Watermark gambar. Text: Watermark teks.	Image
ReferPos	string	Posisi watermark. Jika ditentukan dalam permintaan, nilai ini menggantikan parameter yang sesuai dalam template watermark. Nilai yang valid: TopRight: Kanan atas. TopLeft: Kiri atas. BottomRight: Kanan bawah. BottomLeft: Kiri bawah.	TopRight
Dx	string	Offset horizontal gambar watermark relatif terhadap video output. Jika ditentukan dalam permintaan, nilai ini menggantikan parameter yang sesuai dalam template watermark. Nilai default: 0. Nilai dapat berupa: Bilangan bulat: Offset dalam piksel. Rentang: [8,4096]. Unit: px. Desimal: Rasio offset horizontal terhadap lebar video output. Rentang: (0,1). Mendukung hingga empat tempat desimal. Contoh: 0.9999. Digit tambahan dipotong.	100
Width	string	Lebar gambar watermark. Jika ditentukan dalam permintaan, nilai ini menggantikan parameter yang sesuai dalam template watermark. Nilai dapat berupa: Bilangan bulat: Lebar dalam piksel. Rentang: [8,4096]. Unit: px. Desimal: Rasio lebar watermark terhadap lebar video output. Rentang: (0,1). Mendukung hingga empat tempat desimal. Contoh: 0.9999. Digit tambahan dipotong.	50
Height	string	Tinggi gambar watermark. Jika ditentukan dalam permintaan, nilai ini menggantikan parameter yang sesuai dalam template watermark. Nilai dapat berupa: Bilangan bulat: Tinggi dalam piksel. Rentang: [8,4096]. Unit: px. Desimal: Rasio tinggi watermark terhadap tinggi video output. Rentang: (0,1). Mendukung hingga empat tempat desimal. Contoh: 0.9999. Digit tambahan dipotong.	50
InputFile	object	File input untuk watermark. Format yang didukung: gambar PNG dan file MOV.
Object	string	Objek OSS dari file input.	example-logo-****.png
Location	string	Lokasi OSS dari file input.	oss-cn-hangzhou
Bucket	string	Bucket OSS dari file input.	example-bucket
WaterMarkTemplateId	string	ID template watermark.	88c6ca184c0e47098a5b665e2a12****
Dy	string	Offset vertikal gambar watermark relatif terhadap video output. Jika ditentukan dalam permintaan, nilai ini menggantikan parameter yang sesuai dalam template watermark. Nilai dapat berupa: Bilangan bulat: Offset vertikal dalam piksel. Rentang: [8,4096]. Unit: px. Desimal: Rasio offset vertikal terhadap tinggi video output. Rentang: (0,1). Mendukung hingga empat tempat desimal. Contoh: 0.9999. Digit tambahan dipotong.	100
WaterMarkConfigUrl	string	URL file konfigurasi watermark.	http://example.com/configure
DeWatermark	string	Konfigurasi efek buram, sebagai objek JSON. Untuk informasi lebih lanjut, lihat detail konfigurasi efek buram di Detail parameter.	{"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}]}
M3U8NonStandardSupport	object	Dukungan non-standar m3u8, sebagai objek JSON. Untuk informasi lebih lanjut, lihat detail dukungan parameter non-standar m3u8 di Detail parameter.
TS	object	Objek JSON untuk dukungan non-standar file TS. Untuk informasi lebih lanjut, lihat detail dukungan parameter TS di Detail parameter.
SizeSupport	boolean	Apakah menyertakan ukuran file TS dalam file m3u8. Nilai yang valid: true: Sertakan. false: Jangan sertakan.	true
Md5Support	boolean	Apakah menyertakan hash MD5 file TS dalam file m3u8. Nilai yang valid: true: Sertakan. false: Jangan sertakan.	true
Priority	string	Prioritas pekerjaan dalam pipelinenya. Prioritas maksimum: 10. Nilai default: 6.	6
Audio	object	Konfigurasi audio. Catatan Jika Anda menentukan konfigurasi audio dalam permintaan, mereka akan menggantikan pengaturan yang sesuai dalam template transkoding.
Profile	string	Profil kodek audio. Nilai yang valid ketika Codec adalah aac: aaclow, aache, aachev2, aacld, dan aaceld.	aaclow
Codec	string	Format kodek audio. Nilai yang valid: aac, mp3, vorbis, dan flac. Nilai default: aac.	aac
Samplerate	string	Laju sampel. Nilai yang valid: 22050, 32000, 44100, 48000, dan 96000. Unit: Hz. Nilai default: 44100. Catatan Jika format kontainer adalah flv dan kodek audio adalah mp3, laju sampel 32000, 48000, dan 96000 tidak didukung. Jika kodek audio adalah mp3, laju sampel 96000 tidak didukung.	44100
Qscale	string	Faktor kontrol kualitas audio.	15
Channels	string	Jumlah saluran suara. Nilai yang valid: 1, 2, 3, 4, 5, 6, 7, dan 8. Nilai default: 2.	2
Volume	object	Konfigurasi volume.
Method	string	Metode penyesuaian volume. Nilai yang valid: auto: Penyesuaian otomatis. dynamic: Penyesuaian dinamis. linear: Penyesuaian linear.	auto
Level	string	Tingkat penyesuaian volume. Nilai default: -20 dB.	-20
Bitrate	string	Bitrate audio file output. Unit: Kbps. Nilai default: 128.	128
AudioStreamMap	string	Indeks aliran audio. Format: 0:a:{index}. Contoh: 0:a:0. Indeks adalah posisi dalam daftar aliran audio, dimulai dari 0. Jika tidak diatur, aliran audio default digunakan.	0:a:0
MergeList	object
Merge	array<object>	Pengaturan penggabungan. Maksimal empat MergeURL didukung.
	object	Detail operasi penggabungan.
Start	string	Titik waktu mulai. Format: `hh:mm:ss[.SSS]` atau `sssss[.SSS]`. Contoh: 01:59:59.999 atau 32000.23.	01:59:59.999
RoleArn	string	ARN Role untuk otorisasi agen.	acs:ram:::role/
MergeURL	string	URL segmen yang akan digabungkan. Contoh: `http://example-bucket-.oss-cn-hangzhou.aliyuncs.com/example-object.flv`. Nama objek harus diencode URL menggunakan UTF-8. Untuk informasi lebih lanjut, lihat Petunjuk encoding URL.	http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv
Duration	string	Durasi. Format: `hh:mm:ss[.SSS]` atau `sssss[.SSS]`. Contoh: 01:59:59.999 atau 32000.23.	01:59:59.999
SuperReso	object	Resolusi mengikuti sumber.
IsHalfSample	string	Apakah akan memperoleh parameter terkait laju pengambilan sampel. Nilai yang valid: true: Ya. false: Tidak.	true
UserData	string	Data yang ditentukan pengguna.	testid-001
ExtendData	string	Bidang ekstensi yang ditentukan pengguna.	testid-002
OutSubtitleList	object
OutSubtitle	array<object>	Daftar subtitle output.
	array<object>	Detail subtitle output.
Map	string	Track video. Format: `0:{stream}:{index}`, yaitu `0:v:{video_index}`. Nilai stream: v untuk video. Indeks adalah posisi dalam daftar aliran video, dimulai dari 0.	0:v:0
OutSubtitleFile	object	Detail file output.
RoleArn	string	ARN Role untuk otorisasi agen.	acs:ram:::role/
Object	string	Objek OSS dari file output.	example.flv
Location	string	Lokasi OSS dari file output.	oss-cn-hangzhou
Bucket	string	Bucket OSS dari file output.	exampleBucket
Success	boolean	Apakah operasi berhasil. Nilai yang valid: true: Berhasil. false: Gagal.	true
Message	string	Pesan kesalahan untuk pekerjaan yang gagal. Parameter ini tidak dikembalikan untuk pekerjaan yang berhasil.	The specified parameter “%s” cannot be null.
VideoStreamMap	string	Indeks aliran video. Indeks dimulai dari 0. Indeks adalah posisi dalam daftar aliran video. Jika tidak diatur, aliran video default digunakan.	0
OutputFile	object	File output.
RoleArn	string	ARN Role untuk otorisasi agen.	acs:ram:::role/
Object	string	Objek OSS dari file output.	example-output.flv
Location	string	Lokasi OSS dari file output.	oss-cn-hangzhou
Bucket	string	Bucket OSS dari file output.	example-bucket
Rotate	string	Sudut rotasi video.	90
Container	object	Kontainer.
Format	string	Format kontainer. Nilai default: mp4. Untuk transkoding video, nilai yang valid adalah flv, mp4, HLS (m3u8+ts), dan MPEG-DASH (MPD+fMP4). Untuk transkoding audio, nilai yang valid adalah mp3, mp4, ogg, flac, dan m4a. Untuk gambar, nilai yang valid adalah gif dan WEBP. Jika kontainer adalah gif, VideoCodec harus GIF. Jika kontainer adalah webp, VideoCodec harus WEBP. Jika kontainer adalah flv, VideoCodec tidak boleh H.265.	mp4
Clip	object	Segmen yang dipotong.
TimeSpan	object	Rentang waktu pemotongan.
Seek	string	Titik waktu mulai. Format: `hh:mm:ss[.SSS]`. Contoh: 01:59:59.999. Atau Format: `sssss[.SSS]`. Contoh: 32000.23.	01:59:59.999
Duration	string	Durasi. Format: `hh:mm:ss[.SSS]`. Contoh: 01:00:59.999. Atau Format: `sssss[.SSS]`. Contoh: 32000.23.	01:00:59.999
MergeConfigUrl	string	URL file konfigurasi penggabungan. Anda dapat menentukan MergeList atau MergeConfigUrl, tetapi tidak keduanya. File konfigurasi yang ditentukan oleh MergeConfigUrl mendukung hingga 50 segmen gabungan. MergeConfigUrl adalah URL file konfigurasi penggabungan. File harus disimpan di OSS dan dapat diakses oleh MPS. Untuk detail konten file, lihat detail parameter penggabungan. Contoh isi file mergeConfigfile: `{"MergeList":[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/video_01.mp4"}]}`.	https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8
OpeningList	object
Opening	array<object>	Daftar video pembuka, sebagai objek JSON.
	object	Detail pembuka.
openUrl	string	URL OSS video pembuka.	http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4
Start	string	Waktu mulai relatif terhadap video utama. Penundaan sebelum menampilkan video pembuka. Unit: detik. Nilai default: 0.	0
Width	string	Lebar. Nilai yang valid: (0,4096), 1, dan full. -1 berarti menggunakan lebar video sumber. full berarti mengisi seluruh layar. Nilai default: -1.	-1
Height	string	Tinggi. Nilai yang valid: (0,4096), -1, dan full. -1 berarti menggunakan tinggi video sumber. full berarti mengisi seluruh layar. Nilai default: -1.	-1
MuxConfig	object	Konfigurasi muxing. Jika Anda menentukan parameter ini dalam permintaan, ia akan menggantikan pengaturan yang sesuai dalam template transkoding.
Webp	object	Konfigurasi muxing WebP.
Loop	string	Jumlah putaran.	0
Gif	object	Konfigurasi muxing GIF.
FinalDelay	string	Durasi jeda pada frame terakhir. Unit: centidetik.	0
DitherMode	string	Metode dithering untuk palet warna. Nilai yang valid: sierra dan bayer.	bayer
Loop	string	Jumlah putaran.	0
IsCustomPalette	string	Apakah akan menggunakan palet warna kustom. Nilai yang valid: true: Gunakan palet kustom. false: Jangan gunakan palet kustom.	false
Segment	object	Konfigurasi segmentasi, sebagai objek JSON.
Duration	string	Durasi segmen. Unit: detik.	20
TailSlateList	object
TailSlate	array<object>	Daftar video tail slate.
	object	Detail video tail slate.
Start	string	Waktu mulai video tail slate.	00000.00
BgColor	string	Warna latar belakang untuk area kosong ketika video tail slate lebih kecil dari video utama. Nilai default: White. Untuk informasi lebih lanjut, lihat bgcolor.	White
IsMergeAudio	boolean	Apakah akan menggabungkan audio dari video tail slate. Nilai yang valid: true: Gabungkan. false: Jangan gabungkan.	true
Width	string	Lebar. Nilai yang valid: (0,4096), -1, dan full. -1 berarti menggunakan lebar video sumber. full berarti mengisi seluruh layar. Nilai default: -1.	-1
Height	string	Tinggi. Nilai yang valid: (0,4096), -1, dan full. -1 berarti menggunakan tinggi video sumber. full berarti mengisi seluruh layar. Nilai default: -1.	-1
BlendDuration	string	Durasi transisi antara video utama dan video tail slate. Efek transisi: fade out frame terakhir video utama sambil fade in video tail slate. Unit: detik. Nilai default: 0.	0
TailUrl	string	URL OSS video tail slate.	http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv
TemplateId	string	ID template.	S00000001-200010
SubtitleConfig	object	Konfigurasi subtitle.
ExtSubtitleList	object
ExtSubtitle	array<object>	Daftar subtitle eksternal.
	array<object>	Detail subtitle.
CharEnc	string	Pengkodean karakter untuk subtitle eksternal. Nilai yang valid: UTF-8, GBK, BIG5, dan auto. Nilai default: auto. Catatan Ketika diatur ke auto, deteksi pengkodean karakter mungkin gagal. Kami merekomendasikan menentukan pengkodean eksplisit.	auto
FontName	string	Nama font yang digunakan saat mengonversi subtitle eksternal menjadi subtitle hard. Nilai default: SimSun. Untuk informasi lebih lanjut, lihat Daftar font.	"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"
Input	object	File input subtitle eksternal. Format yang didukung: srt dan ass. Untuk informasi lebih lanjut, lihat Detail parameter, parameter Input. Contoh: `{“Bucket”:”example-bucket”,“Location”:”oss-cn-hangzhou”,“Object”:”example.srt”}`.
Object	string	Objek OSS dari file input.	example-output.flv
Location	string	Lokasi OSS dari file input.	oss-cn-hangzhou
Bucket	string	Bucket OSS dari file input.	example-bucket-****
SubtitleList	object
Subtitle	array<object>	Daftar subtitle.
	object	Detail subtitle.
Map	string	Track audio. Format: `0:{stream}:{index}`, yaitu `0:a:{audio_index}`. Nilai stream: a untuk audio. Indeks adalah posisi dalam daftar aliran audio, dimulai dari 0.	0:a:0
Properties	object	Properti media.
Width	string	Lebar video.	720
Height	string	Tinggi video.	1280
SourceLogos	object
SourceLogo	array<object>	Kata kunci yang tidak diproses oleh lapisan mesin.
	object	Detail kata kunci.
Source	string	Kata kunci.	example
Duration	string	Durasi.	17
Fps	string	Laju frame.	30
Bitrate	string	Bitrate.	490
FileFormat	string	Format file.	mp4
Streams	object	Informasi aliran.
VideoStreamList	object
VideoStream	array<object>	Daftar aliran video.
	array<object>	Detail aliran video.
Index	string	Indeks aliran video, menunjukkan posisinya dalam aliran media.	0
Timebase	string	Basis waktu.	1/15360
AvgFPS	string	Laju frame rata-rata.	30.0
PixFmt	string	Format piksel.	yuv420p
Sar	string	Rasio aspek sampel.	1:1
Lang	string	Bahasa. Untuk informasi lebih lanjut, lihat definisi bahasa FFmpeg dan ISO-639.	eng
CodecLongName	string	Nama panjang kodek.	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Height	string	Tinggi resolusi video.	1280
NumFrames	string	Jumlah total frame.	30
Bitrate	string	Bitrate.	421.117
CodecTagString	string	String tag kodek.	avc1
HasBFrames	string	Apakah B-frame ada.	2
Profile	string	Profil encoding.	high
StartTime	string	Waktu mulai.	0.000000
NetworkCost	object	Konsumsi bandwidth jaringan.
PreloadTime	string	Waktu preload.	8
AvgBitrate	string	Bitrate rata-rata.	300
CostBandwidth	string	Bandwidth maksimum yang dikonsumsi.	10
Dar	string	Rasio aspek tampilan.	9:16
CodecName	string	Nama singkat kodek.	h264
Width	string	Lebar resolusi video, sebagai angka.	720
Duration	string	Durasi.	17.233333
Fps	string	Laju frame.	30.0
CodecTag	string	Tag kodek.	0x31637661
CodecTimeBase	string	Basis waktu kodek.	1/60
Level	string	Tingkat encoding.	31
colorTransfer	string	Transfer warna.	bt709
colorPrimaries	string	Primer warna.	bt709
bitsPerRawSample	string	Jumlah bit per sampel mentah atau piksel.	8
AudioStreamList	object
AudioStream	array<object>	Daftar aliran audio.
	object	Detail aliran audio.
Timebase	string	Basis waktu.	1/32000
Index	string	Indeks aliran audio, menunjukkan posisinya dalam aliran media.	1
SampleFmt	string	Format sampel.	fltp
ChannelLayout	string	Tata letak saluran.	mono
Lang	string	Bahasa. Untuk informasi lebih lanjut, lihat definisi bahasa FFmpeg dan ISO-639.	und
Samplerate	string	Laju sampel.	32000
CodecLongName	string	Nama panjang kodek.	AAC (Advanced Audio Coding)
Channels	string	Jumlah saluran suara.	1
NumFrames	string	Jumlah total frame.	50
Bitrate	string	Bitrate.	64.136
CodecTagString	string	String tag kodek.	mp4
StartTime	string	Waktu mulai.	0.064000
CodecName	string	Nama singkat kodek.	aac
Duration	string	Durasi.	17.223562
CodecTag	string	Tag kodek.	0x6134706d
CodecTimeBase	string	Basis waktu kodek.	1/32000
SubtitleStreamList	object
SubtitleStream	array<object>	Daftar aliran subtitle.
	object	Detail aliran subtitle.
Index	string	Indeks aliran subtitle. Menunjukkan posisinya dalam aliran media.	1
Lang	string	Bahasa. Untuk informasi lebih lanjut, lihat definisi bahasa FFmpeg dan ISO-639.	eng
Format	object	Informasi format.
StartTime	string	Waktu mulai.	-0.064000
NumPrograms	string	Jumlah total aliran program.	0
Size	string	Ukuran file.	1057273
NumStreams	string	Jumlah total aliran media.	2
FormatLongName	string	Nama panjang format kontainer atau wrapper.	QuickTime / MOV
Duration	string	Durasi total.	17.234000
Bitrate	string	Bitrate total.	490.784
FormatName	string	Nama singkat format kontainer atau wrapper. Nilai yang valid: mov, mp4, m4a, 3gp, 3g2, dan mj2.	mov
FileMd5	string		ad195fd1317a761d4425232867759d1e
FileSize	string	Ukuran file.	1057273
MultiSpeedInfo	object	Informasi tentang pekerjaan multi-kecepatan. Bidang ini hanya muncul untuk pekerjaan yang dikirimkan ke pipeline multi-kecepatan (tidak tersedia untuk pekerjaan multi-kecepatan lama).
Enable	string	Apakah fitur multi-kecepatan diaktifkan.	true
Code	string	Kode kesalahan (untuk kasus di mana multi-kecepatan sebenarnya tidak diaktifkan).	Boost.NotNeedSpeed
Message	string	Pesan kesalahan (untuk kasus di mana multi-kecepatan sebenarnya tidak diaktifkan).	success
SettingSpeed	integer	Kecepatan yang dikonfigurasi.	30
DowngradePolicy	string	Kebijakan downgrade ketika multi-kecepatan tidak didukung.	NormalSpeed
RealSpeed	number	Nilai multi-kecepatan aktual.	6.576886940181647
Duration	number	Durasi video output.	21.0
TimeCost	number	Waktu yang dihabiskan untuk pekerjaan.	3.193
PipelineId	string	ID pipeline.	88c6ca184c0e47b665e2a1267971****
Input	object	Input pekerjaan.
Object	string	Objek OSS dari file input.	video_01.mp4
Location	string	Lokasi OSS dari file input.	oss-cn-shanghai
Bucket	string	Bucket OSS dari file input.	exampleBucket
MNSMessageResult	object	Hasil notifikasi MNS untuk penyelesaian pekerjaan.
MessageId	string	ID pesan untuk pekerjaan yang berhasil.	123
ErrorMessage	string	Pesan kesalahan untuk pekerjaan yang gagal. Tidak dikembalikan untuk pekerjaan yang berhasil.	The resource operated “%s” cannot be found.
ErrorCode	string	Kode kesalahan untuk pekerjaan yang gagal. Tidak dikembalikan untuk pekerjaan yang berhasil.	InvalidParameter.ResourceNotFound
SubmitTime	string	Waktu saat pekerjaan dikeluarkan dari antrian dan mulai dieksekusi.	2021-03-04T06:44:43Z

Format pesan callback

Ketika status pekerjaan transkoding berubah, MPS (Media Processing Service) mengirimkan pesan ke antrian yang Anda tentukan. Untuk mempelajari cara menentukan antrian callback, lihat operasi MPS UpdatePipeline. Isi pesan berupa string JSON yang berisi bidang-bidang berikut:

{
  "Type": "Transcode",
  "State": "Success",
  "JobId": "39f8e0bc005e4f309379701645f4****",
  "UserData": "{\"key\":\"value\"}",
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642****"
}

Nama	Tipe	Deskripsi
Type	String	String tetap "Transcode". Ini menunjukkan pekerjaan transkoding.
JobId	String	ID unik pekerjaan.
State	String	Status pekerjaan saat ini. Sesuai dengan bidang State dalam QueryJobList.
UserData	String	Nilai UserData yang Anda kirimkan dalam SubmitJobs.

Contoh

Respons sukses

JSONformat

{
  "NonExistJobIds": {
    "String": [
      "d1ce4d3efcb549419193f50f1fcd****"
    ]
  },
  "RequestId": "197ADF44-104C-514C-9F92-D8924CB34E2A",
  "JobList": {
    "Job": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "Percent": 100,
        "FinishTime": "2014-01-10T12:20:25Z",
        "State": "TranscodeSuccess",
        "JobId": "31fa3c9ca8134fb4b0b0f7878301****",
        "Code": "InvalidParameter.NullValue",
        "Message": "The specified parameter \"%s\" cannot be null.",
        "Output": {
          "Video": {
            "Bufsize": "6000",
            "Degrain": "5",
            "BitrateBnd": {
              "Max": "1000",
              "Min": "300"
            },
            "PixFmt": "yuv420p",
            "Pad": "1280:800:0:140",
            "Codec": "H.264",
            "Height": "720",
            "Qscale": "15",
            "Crop": "1280:800:0:140",
            "Bitrate": "500",
            "Maxrate": "3000",
            "MaxFps": "60",
            "Profile": "high",
            "Crf": "26",
            "Gop": "250",
            "Width": "1280",
            "Fps": "25",
            "Preset": "medium",
            "ScanMode": "interlaced",
            "ResoPriority": "1"
          },
          "TransConfig": {
            "IsCheckAudioBitrate": "false",
            "TransMode": "onepass",
            "IsCheckReso": "false",
            "IsCheckVideoBitrateFail": "false",
            "AdjDarMethod": "none",
            "IsCheckVideoBitrate": "false",
            "IsCheckResoFail": "false",
            "IsCheckAudioBitrateFail": "false"
          },
          "Encryption": {
            "Type": "hls-aes-128",
            "Key": "encryptionkey128",
            "KeyType": "Base64",
            "Id": "31fa3c9ca8134f9cec2b4b0b0f78****",
            "KeyUri": "https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/",
            "SkipCnt": "3"
          },
          "WaterMarkList": {
            "WaterMark": [
              {
                "Type": "Image",
                "ReferPos": "TopRight",
                "Dx": "100",
                "Width": "50",
                "Height": "50",
                "InputFile": {
                  "Object": "example-logo-****.png",
                  "Location": "oss-cn-hangzhou",
                  "Bucket": "example-bucket"
                },
                "WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a12****",
                "Dy": "100"
              }
            ]
          },
          "WaterMarkConfigUrl": "http://example.com/configure",
          "DeWatermark": "{\"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}]}",
          "M3U8NonStandardSupport": {
            "TS": {
              "SizeSupport": true,
              "Md5Support": true
            }
          },
          "Priority": "6",
          "Audio": {
            "Profile": "aaclow",
            "Codec": "aac",
            "Samplerate": "44100",
            "Qscale": "15",
            "Channels": "2",
            "Volume": {
              "Method": "auto",
              "Level": "-20"
            },
            "Bitrate": "128"
          },
          "AudioStreamMap": "0:a:0",
          "MergeList": {
            "Merge": [
              {
                "Start": "01:59:59.999",
                "RoleArn": "acs:ram:::role/",
                "MergeURL": "http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv",
                "Duration": "01:59:59.999"
              }
            ]
          },
          "SuperReso": {
            "IsHalfSample": "true"
          },
          "UserData": "testid-001",
          "ExtendData": "testid-002",
          "OutSubtitleList": {
            "OutSubtitle": [
              {
                "Map": "0:v:0",
                "OutSubtitleFile": {
                  "RoleArn": "acs:ram:::role/",
                  "Object": "example.flv",
                  "Location": "oss-cn-hangzhou",
                  "Bucket": "exampleBucket"
                },
                "Success": true,
                "Message": "The specified parameter “%s” cannot be null."
              }
            ]
          },
          "VideoStreamMap": "0",
          "OutputFile": {
            "RoleArn": "acs:ram:::role/",
            "Object": "example-output.flv",
            "Location": "oss-cn-hangzhou",
            "Bucket": "example-bucket"
          },
          "Rotate": "90",
          "Container": {
            "Format": "mp4"
          },
          "Clip": {
            "TimeSpan": {
              "Seek": "01:59:59.999",
              "Duration": "01:00:59.999"
            }
          },
          "MergeConfigUrl": "https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8",
          "OpeningList": {
            "Opening": [
              {
                "openUrl": "http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4",
                "Start": "0",
                "Width": "-1",
                "Height": "-1"
              }
            ]
          },
          "MuxConfig": {
            "Webp": {
              "Loop": "0"
            },
            "Gif": {
              "FinalDelay": "0",
              "DitherMode": "bayer",
              "Loop": "0",
              "IsCustomPalette": "false"
            },
            "Segment": {
              "Duration": "20"
            }
          },
          "TailSlateList": {
            "TailSlate": [
              {
                "Start": "00000.00",
                "BgColor": "White",
                "IsMergeAudio": true,
                "Width": "-1",
                "Height": "-1",
                "BlendDuration": "0",
                "TailUrl": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv"
              }
            ]
          },
          "TemplateId": "S00000001-200010",
          "SubtitleConfig": {
            "ExtSubtitleList": {
              "ExtSubtitle": [
                {
                  "CharEnc": "auto",
                  "FontName": "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
                  "Input": {
                    "Object": "example-output.flv",
                    "Location": "oss-cn-hangzhou",
                    "Bucket": "example-bucket-****"
                  }
                }
              ]
            },
            "SubtitleList": {
              "Subtitle": [
                {
                  "Map": "0:a:0"
                }
              ]
            }
          },
          "Properties": {
            "Width": "720",
            "Height": "1280",
            "SourceLogos": {
              "SourceLogo": [
                {
                  "Source": "example"
                }
              ]
            },
            "Duration": "17",
            "Fps": "30",
            "Bitrate": "490",
            "FileFormat": "mp4",
            "Streams": {
              "VideoStreamList": {
                "VideoStream": [
                  {
                    "Index": "0",
                    "Timebase": "1/15360",
                    "AvgFPS": "30.0",
                    "PixFmt": "yuv420p",
                    "Sar": "1:1",
                    "Lang": "eng",
                    "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                    "Height": "1280",
                    "NumFrames": "30",
                    "Bitrate": "421.117",
                    "CodecTagString": "avc1",
                    "HasBFrames": "2",
                    "Profile": "high",
                    "StartTime": "0.000000",
                    "NetworkCost": {
                      "PreloadTime": "8",
                      "AvgBitrate": "300",
                      "CostBandwidth": "10"
                    },
                    "Dar": "9:16",
                    "CodecName": "h264",
                    "Width": "720",
                    "Duration": "17.233333",
                    "Fps": "30.0",
                    "CodecTag": "0x31637661",
                    "CodecTimeBase": "1/60",
                    "Level": "31",
                    "colorTransfer": "bt709",
                    "colorPrimaries": "bt709",
                    "bitsPerRawSample": "8"
                  }
                ]
              },
              "AudioStreamList": {
                "AudioStream": [
                  {
                    "Timebase": "1/32000",
                    "Index": "1",
                    "SampleFmt": "fltp",
                    "ChannelLayout": "mono",
                    "Lang": "und",
                    "Samplerate": "32000",
                    "CodecLongName": "AAC (Advanced Audio Coding)",
                    "Channels": "1",
                    "NumFrames": "50",
                    "Bitrate": "64.136",
                    "CodecTagString": "mp4",
                    "StartTime": "0.064000",
                    "CodecName": "aac",
                    "Duration": "17.223562",
                    "CodecTag": "0x6134706d",
                    "CodecTimeBase": "1/32000"
                  }
                ]
              },
              "SubtitleStreamList": {
                "SubtitleStream": [
                  {
                    "Index": "1",
                    "Lang": "eng"
                  }
                ]
              }
            },
            "Format": {
              "StartTime": "-0.064000",
              "NumPrograms": "0",
              "Size": "1057273",
              "NumStreams": "2",
              "FormatLongName": "QuickTime / MOV",
              "Duration": "17.234000",
              "Bitrate": "490.784",
              "FormatName": "mov"
            },
            "FileMd5": "ad195fd1317a761d4425232867759d1e",
            "FileSize": "1057273"
          },
          "MultiSpeedInfo": {
            "Enable": "true",
            "Code": "Boost.NotNeedSpeed",
            "Message": "success",
            "SettingSpeed": 30,
            "DowngradePolicy": "NormalSpeed",
            "RealSpeed": 6.576886940181647,
            "Duration": 21,
            "TimeCost": 3.193
          }
        },
        "PipelineId": "88c6ca184c0e47b665e2a1267971****",
        "Input": {
          "Object": "video_01.mp4",
          "Location": "oss-cn-shanghai",
          "Bucket": "exampleBucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "The resource operated “%s” cannot be found.",
          "ErrorCode": "InvalidParameter.ResourceNotFound"
        },
        "SubmitTime": "2021-03-04T06:44:43Z"
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.