Menanyakan beberapa pekerjaan transkoding sekaligus berdasarkan ID pekerjaan transkoding.
Catatan penggunaan
- Secara default, pekerjaan yang dikembalikan diurutkan secara menurun berdasarkan CreationTime.
- Anda dapat memanggil operasi ini untuk menanyakan hingga 10 pekerjaan transkoding sekaligus.
- Jika parameter JobIds tidak ditentukan, kode kesalahan
InvalidParameterakan dikembalikan.
Batas QPS
Anda dapat memanggil operasi ini hingga 100 kali per detik per akun. Permintaan yang melebihi batas ini akan dibuang dan dapat menyebabkan gangguan layanan. Kami menyarankan agar Anda memperhatikan batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.
Debugging
Parameter permintaan
| Parameter | Type | Wajib | Contoh | Deskripsi |
| Action | String | Ya | QueryJobList | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke QueryJobList. |
| JobIds | String | Tidak | bb558c1cc25b45309aab5be44d19****,d1ce4d3efcb549419193f50f1fcd**** | ID pekerjaan transkoding. Pisahkan beberapa ID dengan koma (,). Anda dapat menanyakan maksimal 10 pekerjaan transkoding sekaligus. Anda dapat login ke Konsol ApsaraVideo Media Processing (MPS) dan klik Tasks di panel navigasi sebelah kiri untuk mendapatkan ID pekerjaan. Atau, Anda dapat memperoleh ID pekerjaan dari respons terhadap operasi SubmitJobs. Catatan Jika Anda tidak mengatur parameter JobIds, kode kesalahan InvalidParameter akan dikembalikan. |
Parameter respons
| Parameter | Type | Contoh | Deskripsi |
| NonExistJobIds | Array of String | d1ce4d3efcb549419193f50f1fcd**** | Daftar ID pekerjaan yang tidak ada. Jika semua ID pekerjaan yang ditanyakan ada, respons tidak berisi parameter ini. |
| RequestId | String | 197ADF44-104C-514C-9F92-D8924CB34E2A | ID permintaan. |
| JobList | Array of Job | Daftar pekerjaan transkoding. |
|
| Job | |||
| CreationTime | String | 2014-01-10T12:00:00Z | Waktu pembuatan pekerjaan. |
| Percent | Long | 100 | Kemajuan transkoding. |
| FinishTime | String | 2014-01-10T12:20:25Z | Waktu penyelesaian pekerjaan transkoding. |
| State | String | TranscodeSuccess | Status pekerjaan. Nilai valid:
|
| JobId | String | 31fa3c9ca8134fb4b0b0f7878301**** | ID task. |
| Code | String | InvalidParameter.NullValue | Kode kesalahan yang dikembalikan jika pekerjaan transkoding gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
| Message | String | The specified parameter "%s" cannot be null. | Pesan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
| Output | Object | Output pekerjaan. |
|
| Video | Object | Konfigurasi video. |
|
| Bufsize | String | 6000 | Ukuran buffer.
|
| Degrain | String | 5 | Tingkat algoritma denoising independen. |
| BitrateBnd | Object | Rentang bitrate rata-rata video. |
|
| Max | String | 1000 | Bitrate maksimum. |
| Min | String | 300 | Bitrate minimum. |
| PixFmt | String | yuv420p | Format piksel untuk encoding warna video. Format piksel standar seperti yuv420p dan yuvj420p didukung. |
| Pad | String | 1280:800:0:140 | Batas hitam yang akan ditambahkan ke video.
|
| Codec | String | H.264 | Kodek.
|
| Height | String | 720 | Tinggi video.
|
| Qscale | String | 15 | Tingkat kontrol kualitas pada video. |
| Crop | String | 1280:800:0:140 | Mode crop. Dua mode berikut didukung:
|
| Bitrate | String | 500 | Bitrate rata-rata video. Unit: Kbit/s. |
| Maxrate | String | 3000 | Bitrate maksimum video. Unit: Kbit/s. |
| MaxFps | String | 60 | Laju frame maksimum. |
| Profile | String | high | Profil kodek. Nilai valid: baseline, main, dan high. Catatan Jika terdapat beberapa definisi, kami menyarankan agar Anda mengatur parameter ini ke baseline untuk definisi terendah guna memastikan pemutaran normal pada perangkat low-end. Atur parameter ini ke main atau high untuk definisi lainnya.
|
| Crf | String | 26 | Faktor laju konstan (constant rate factor).
|
| Gop | String | 250 | Interval maksimum antara keyframe atau jumlah maksimum frame dalam grup frame. Unit: detik.
|
| Width | String | 1280 | Lebar video.
|
| Fps | String | 25 | Laju frame.
|
| Preset | String | medium | Algoritma video preset. Nilai default: medium. Nilai valid:
|
| ScanMode | String | interlaced | Mode pemindaian. Nilai valid:
|
| ResoPriority | String | 1 | Prioritas resource. |
| TransConfig | Object | Konfigurasi transkoding umum. Catatan Jika parameter ini ditentukan dalam permintaan, nilainya akan menggantikan parameter yang sesuai dalam template transkoding yang ditentukan. |
|
| IsCheckAudioBitrate | String | false | Menunjukkan apakah bitrate audio diperiksa. Jika fitur ini diaktifkan dan sistem mendeteksi bahwa bitrate audio file output lebih besar daripada file input, bitrate audio file input akan dipertahankan setelah transkoding. Dalam hal ini, pengaturan parameter Bitrate tidak berlaku. Parameter ini memiliki prioritas lebih rendah daripada parameter IsCheckAudioBitrateFail.
|
| TransMode | String | onepass | Mode transkoding.
|
| IsCheckReso | String | false | Menunjukkan apakah resolusi diperiksa. Jika resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, sistem menganggap bahwa resolusi output sama dengan resolusi input.
|
| IsCheckVideoBitrateFail | String | false | Menunjukkan apakah bitrate video diperiksa. Jika bitrate video output lebih tinggi daripada video input, kegagalan transkoding akan dikembalikan tanpa melakukan transkoding video. Parameter ini memiliki prioritas lebih tinggi daripada parameter IsCheckVideoBitrate.
|
| AdjDarMethod | String | none | Metode penyesuaian resolusi. Nilai default: none. Nilai valid: rescale, crop, pad, dan none. |
| IsCheckVideoBitrate | String | false | Menunjukkan apakah bitrate video diperiksa. Jika bitrate output lebih tinggi daripada bitrate input, sistem menganggap bahwa bitrate output sama dengan bitrate input.
|
| IsCheckResoFail | String | false | Menunjukkan apakah resolusi diperiksa. Jika resolusi output lebih tinggi daripada resolusi input berdasarkan lebar atau tinggi, kegagalan transkoding akan dikembalikan.
|
| IsCheckAudioBitrateFail | String | false | Menunjukkan apakah bitrate audio diperiksa. Jika bitrate audio output lebih tinggi daripada bitrate audio sumber media, kegagalan transkoding akan dikembalikan tanpa melakukan transkoding media. Nilai ini memiliki prioritas lebih tinggi daripada IsCheckAudioBitrate.
|
| Encryption | Object | Konfigurasi enkripsi. Hanya output dalam format M3U8 yang didukung. |
|
| Type | String | hls-aes-128 | Jenis enkripsi. Nilai valid: hls-aes-128. |
| Key | String | encryptionkey128 | Kunci yang digunakan untuk mengenkripsi video. |
| KeyType | String | Base64 | Metode enkripsi kunci. Nilai valid: Base64 dan KMS. Catatan Sebagai contoh, jika kuncinya adalah encryptionkey128, nilainya dapat berupa Base64("encryptionkey128") atau KMS(Base64("encryptionkey128"), tergantung metode enkripsi yang digunakan. |
| Id | String | 31fa3c9ca8134f9cec2b4b0b0f78**** | ID enkripsi. |
| KeyUri | String | https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/ | URL yang digunakan untuk meminta kunci. URL ini dienkripsi Base64. |
| SkipCnt | String | 3 | Jumlah frame yang tidak dienkripsi di awal video. Meninggalkan frame-frame ini tidak dienkripsi memungkinkan pemutaran video dimulai dengan cepat. |
| WaterMarkList | Array of WaterMark | Daftar watermark. |
|
| WaterMark | |||
| Type | String | Image | Jenis watermark. Jika parameter ini ditentukan dalam permintaan, nilainya akan menggantikan parameter yang sesuai dalam template watermark. Untuk informasi selengkapnya, lihat Detail parameter. Nilai valid:
|
| ReferPos | String | TopRight | Posisi watermark. Jika parameter ini ditentukan dalam permintaan, nilainya akan menggantikan parameter yang sesuai dalam template watermark. Nilai valid:
|
| Dx | String | 100 | Offset horizontal gambar watermark relatif terhadap video output. Jika parameter ini ditentukan dalam permintaan, nilainya akan menggantikan parameter yang sesuai dalam template watermark. Nilai default: 0. Nilainya dapat berupa bilangan bulat atau desimal.
|
| Width | String | 50 | Lebar watermark. Jika parameter ini ditentukan dalam permintaan, nilainya akan menggantikan parameter yang sesuai dalam template watermark. Nilainya dapat berupa bilangan bulat atau desimal.
|
| Height | String | 50 | Tinggi gambar watermark. Jika parameter ini ditentukan dalam permintaan, nilainya akan menggantikan parameter yang sesuai dalam template watermark. Nilainya dapat berupa bilangan bulat atau desimal.
|
| InputFile | Object | File input watermark. Anda dapat menggunakan gambar dalam format PNG atau file dalam format MOV sebagai file input watermark. |
|
| Object | String | example-logo-****.png | Nama objek Object Storage Service (OSS) yang digunakan sebagai file input. |
| Location | String | oss-cn-hangzhou | Wilayah OSS tempat file input berada. |
| Bucket | String | example-bucket | Nama bucket OSS tempat file input disimpan. |
| WaterMarkTemplateId | String | 88c6ca184c0e47098a5b665e2a12**** | ID template watermark. |
| Dy | String | 100 | Offset vertikal gambar watermark relatif terhadap video output. Jika parameter ini ditentukan dalam permintaan, nilainya akan menggantikan parameter yang sesuai dalam template watermark. Nilainya dapat berupa bilangan bulat atau desimal.
|
| WaterMarkConfigUrl | String | http://example.com/configure | URL file konfigurasi watermark. |
| DeWatermark | String | {"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}]} | Konfigurasi efek buram watermark. Nilainya harus berupa objek JSON. Untuk informasi selengkapnya, lihat Detail parameter. |
| M3U8NonStandardSupport | Object | Konfigurasi dukungan non-standar untuk M3U8. Nilainya harus berupa objek JSON. Untuk informasi selengkapnya, lihat Detail parameter. |
|
| TS | Object | Konfigurasi dukungan non-standar untuk M3U8 tentang file TS. Nilainya harus berupa objek JSON. Untuk informasi selengkapnya, lihat Detail parameter. |
|
| SizeSupport | Boolean | true | Menunjukkan apakah mendukung output ukuran file TS dalam file M3U8. Nilai valid:
|
| Md5Support | Boolean | true | Menunjukkan apakah mendukung output nilai md5 file TS dalam file M3U8. Nilai valid:
|
| Priority | String | 6 | Prioritas pekerjaan dalam antrian MPS tempat pekerjaan ditambahkan.
|
| Audio | Object | Konfigurasi audio. Catatan Jika parameter ini ditentukan dalam permintaan, nilainya akan menggantikan parameter yang sesuai dalam template transkoding yang ditentukan. |
|
| Profile | String | aaclow | Profil kodek file audio. Nilai valid saat parameter Codec diatur ke aac: aaclow, aache, aachev2, aacld, dan aaceld. |
| Codec | String | aac | Format encoding dan decoding audio.
|
| Samplerate | String | 44100 | Laju pengambilan sampel.
Catatan Jika format kontainer video adalah FLV dan kodek audio adalah MP3, Anda tidak dapat mengatur parameter ini ke 32000, 48000, atau 96000. Jika kodek audio adalah MP3, Anda tidak dapat mengatur parameter ini ke 96000. |
| Qscale | String | 15 | Tingkat kontrol kualitas pada audio. |
| Channels | String | 2 | Jumlah saluran suara.
|
| Volume | Object | Konfigurasi volume. |
|
| Method | String | auto | Metode penyesuaian volume. Nilai valid:
|
| Level | String | -20 | Rentang penyesuaian volume. Nilai default: -20db. |
| Bitrate | String | 128 | Bitrate audio file output.
|
| AudioStreamMap | String | 0:a:0 | Nomor urut aliran audio.
|
| MergeList | Array of Merge | Konfigurasi penggabungan. Maksimal empat URL dapat digabungkan. |
|
| Merge | |||
| Start | String | 01:59:59.999 | Titik waktu mulai klip.
|
| RoleArn | String | acs:ram::<your uid>:role/<your role name> | Nama Sumber Daya Alibaba Cloud (ARN) dari role yang digunakan untuk otorisasi proxy. |
| MergeURL | String | http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv | URL OSS klip.
|
| Duration | String | 01:59:59.999 | Durasi klip.
|
| SuperReso | Object | Menunjukkan bahwa resolusi video sumber digunakan. |
|
| IsHalfSample | String | true | Menunjukkan apakah akan mendapatkan parameter terkait laju pengambilan sampel. Nilai valid:
|
| UserData | String | testid-001 | Data kustom. |
| ExtendData | String | testid-002 | Bidang kustom. |
| OutSubtitleList | Array of OutSubtitle | Daftar subtitle output. |
|
| OutSubtitle | |||
| Map | String | 0:v:0 | Track video. Format: |
| OutSubtitleFile | Object | Detail file output. |
|
| RoleArn | String | acs:ram::<your uid>:role/<your role name> | ARN role yang digunakan untuk otorisasi proxy. |
| Object | String | example.flv | Nama objek OSS yang digunakan sebagai file output. |
| Location | String | oss-cn-hangzhou | ID wilayah OSS tempat file output berada. |
| Bucket | String | exampleBucket | Bucket OSS tempat file output disimpan. |
| Success | Boolean | true | Menunjukkan apakah Pekerjaan berhasil. Nilai yang valid:
|
| Message | String | The specified parameter "%s" cannot be null. | Pesan kesalahan yang dikembalikan jika pekerjaan gagal dibuat. Parameter ini tidak dikembalikan jika pekerjaan berhasil dibuat. |
| VideoStreamMap | String | 0 | Nomor urut aliran video. Nomor urut adalah indeks aliran video dalam daftar dan dimulai dari 0. Jika Anda tidak mengatur parameter yang sesuai dalam permintaan, aliran video default dipilih. |
| OutputFile | Object | Informasi tentang file output. |
|
| RoleArn | String | acs:ram::<your uid>:role/<your role name> | ARN role yang digunakan untuk otorisasi proxy. |
| Object | String | example-output.flv | Nama objek OSS yang digunakan sebagai file output. |
| Location | String | oss-cn-hangzhou | ID wilayah OSS tempat file output berada. |
| Bucket | String | example-bucket | Bucket OSS tempat file output disimpan. |
| Rotate | String | 90 | Sudut rotasi video. |
| Container | Object | Konfigurasi kontainer. |
|
| Format | String | mp4 | Format kontainer.
|
| Clip | Object | Informasi tentang klip media. |
|
| TimeSpan | Object | Rentang waktu klip. |
|
| Seek | String | 01:59:59.999 | Waktu mulai klip.
Atau
|
| Duration | String | 01:00:59.999 | Durasi klip.
Atau
|
| MergeConfigUrl | String | https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8 | URL file konfigurasi penggabungan. Anda hanya dapat menentukan salah satu dari parameter MergeList dan MergeConfigUrl.
|
| OpeningList | Array of Opening | Daftar bagian pembuka. Nilainya adalah objek JSON. |
|
| Opening | |||
| openUrl | String | http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4 | URL OSS bagian pembuka video. |
| Start | String | 0 | Jumlah waktu setelah bagian pembuka diputar.
|
| Width | String | -1 | Lebar bagian pembuka.
|
| Height | String | -1 | Tinggi bagian pembuka.
|
| MuxConfig | Object | Konfigurasi transmuxing. Konfigurasi transmuxing. Jika parameter ini ditentukan dalam permintaan, nilainya akan menggantikan parameter yang sesuai dalam template transkoding yang ditentukan. |
|
| Webp | Object | Konfigurasi transmuxing untuk WebP. |
|
| Loop | String | 0 | Jumlah loop. |
| Gif | Object | Konfigurasi transmuxing untuk GIF. |
|
| FinalDelay | String | 0 | Durasi jeda frame terakhir. Unit: centidetik. |
| DitherMode | String | bayer | Algoritma dithering warna palet. Nilai valid: sierra dan bayer. |
| Loop | String | 0 | Jumlah loop. |
| IsCustomPalette | String | false | Menunjukkan apakah palet kustom digunakan. Nilai valid:
|
| Segment | Object | Konfigurasi segmen. Nilainya adalah objek JSON. |
|
| Duration | String | 20 | Panjang segmen. Unit: detik. |
| TailSlateList | Array of TailSlate | Daftar bagian penutup. |
|
| TailSlate | |||
| Start | String | 00000.00 | Waktu pemutaran bagian penutup. |
| BgColor | String | White | Warna bilah yang ditambahkan ke bagian penutup jika ukuran bagian penutup lebih kecil daripada bagian utama. Nilai default: White. Untuk informasi selengkapnya, lihat Warna latar belakang. |
| IsMergeAudio | Boolean | true | Menunjukkan apakah konten audio bagian penutup digabungkan. Nilai valid:
|
| Width | String | -1 | Lebar bagian penutup. Nilai valid: nilai dalam rentang (0, 4096), -1, dan full.
|
| Height | String | -1 | Tinggi bagian penutup.
|
| BlendDuration | String | 0 | Jumlah waktu antara akhir bagian utama dan awal bagian penutup. Selama transisi bagian video, frame terakhir bagian utama memudar, dan frame pertama bagian penutup muncul perlahan. Unit: detik. Nilai default: 0. |
| TailUrl | String | http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv | URL OSS bagian penutup. |
| TemplateId | String | S00000001-200010 | ID template. |
| SubtitleConfig | Object | Konfigurasi subtitle. |
|
| ExtSubtitleList | Array of ExtSubtitle | Daftar subtitle eksternal. |
|
| ExtSubtitle | |||
| CharEnc | String | auto | Set karakter yang digunakan oleh subtitle eksternal.
Catatan Jika Anda mengatur parameter ini ke auto, set karakter yang terdeteksi mungkin bukan set karakter aktual. Kami menyarankan agar Anda mengatur parameter ini ke nilai lain. |
| FontName | String | "WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun" | Font subtitle hard yang dikonversi dari subtitle eksternal. Nilai default: SimSum. Untuk informasi selengkapnya, lihat Font. |
| Input | Object | File subtitle input.
|
|
| Object | String | example-output.flv | Nama objek OSS yang digunakan sebagai file media input. |
| Location | String | oss-cn-hangzhou | ID wilayah OSS tempat file input berada. |
| Bucket | String | example-bucket-**** | Nama bucket OSS tempat file input disimpan. |
| SubtitleList | Array of Subtitle | Daftar subtitle. |
|
| Subtitle | |||
| Map | String | 0:a:0 | Track audio. Format: |
| Properties | Object | Properti media. |
|
| Width | String | 720 | Lebar video. |
| Height | String | 1280 | Panjang video. |
| SourceLogos | Array of SourceLogo | Kata kunci lapisan non-engine. |
|
| SourceLogo | |||
| Source | String | example | Kata kunci. |
| Duration | String | 17 | Durasi. |
| Fps | String | 30 | Laju frame. |
| Bitrate | String | 490 | Bitrate. |
| FileFormat | String | mp4 | Format file media input. |
| Streams | Object | Aliran media yang terdapat dalam file media input. |
|
| VideoStreamList | Array of VideoStream | Daftar aliran video. |
|
| VideoStream | |||
| Index | String | 0 | Nomor urut aliran video. Nilai ini menunjukkan posisi aliran video di antara semua aliran video. |
| Timebase | String | 1/15360 | Basis waktu. |
| AvgFPS | String | 30.0 | Laju frame rata-rata. |
| PixFmt | String | yuv420p | Format piksel. |
| Sar | String | 1:1 | Rasio aspek sampel (SAR) aliran video. |
| Lang | String | eng | Bahasa aliran subtitle. Untuk informasi selengkapnya, lihat Definisi bahasa FFmpeg dan ISO 639. |
| CodecLongName | String | H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 | Nama lengkap format encoding. |
| Height | String | 1280 | Tinggi aliran video dalam piksel. |
| NumFrames | String | 30 | Jumlah total frame. |
| Bitrate | String | 421.117 | Bitrate. |
| CodecTagString | String | avc1 | String tag format encoding. |
| HasBFrames | String | 2 | Menunjukkan apakah aliran video berisi frame bidireksional (B-frame). |
| Profile | String | high | Profil kodek. |
| StartTime | String | 0.000000 | Waktu mulai. |
| NetworkCost | Object | Bandwidth jaringan yang dikonsumsi. |
|
| PreloadTime | String | 8 | Jumlah waktu preload. |
| AvgBitrate | String | 300 | Bitrate rata-rata. |
| CostBandwidth | String | 10 | Bandwidth maksimum yang dikonsumsi. |
| Dar | String | 9:16 | Rasio aspek tampilan (DAR). |
| CodecName | String | h264 | Nama singkat format encoding. |
| Width | String | 720 | Lebar video dalam piksel. |
| Duration | String | 17.233333 | Durasi. |
| Fps | String | 30.0 | Laju frame. |
| CodecTag | String | 0x31637661 | Tag format encoding. |
| CodecTimeBase | String | 1/60 | Basis waktu kodek. |
| Level | String | 31 | Level kodek. |
| colorTransfer | String | bt709 | Konfigurasi transfer warna. |
| colorPrimaries | String | bt709 | Warna primer. |
| bitsPerRawSample | String | 8 | Jumlah bit biner yang digunakan oleh setiap sampel atau piksel. |
| AudioStreamList | Array of AudioStream | Daftar aliran audio. |
|
| AudioStream | |||
| Timebase | String | 1/32000 | Basis waktu. |
| Index | String | 1 | Nomor urut aliran audio. Nilai ini menunjukkan posisi aliran audio di antara semua aliran audio. |
| SampleFmt | String | fltp | Format pengambilan sampel. |
| ChannelLayout | String | mono | Tata letak output saluran suara. |
| Lang | String | und | Bahasa aliran subtitle. Untuk informasi selengkapnya, lihat Definisi bahasa FFmpeg dan ISO 639. |
| Samplerate | String | 32000 | Laju pengambilan sampel. |
| CodecLongName | String | AAC (Advanced Audio Coding) | Nama lengkap format encoding. |
| Channels | String | 1 | Jumlah saluran suara. |
| NumFrames | String | 50 | Jumlah total frame. |
| Bitrate | String | 64.136 | Bitrate. |
| CodecTagString | String | mp4 | String tag format encoding. |
| StartTime | String | 0.064000 | Waktu mulai. |
| CodecName | String | aac | Nama singkat format encoding. |
| Duration | String | 17.223562 | Durasi. |
| CodecTag | String | 0x6134706d | Tag format encoding. |
| CodecTimeBase | String | 1/32000 | Basis waktu kodek. |
| SubtitleStreamList | Array of SubtitleStream | Daftar aliran subtitle. |
|
| SubtitleStream | |||
| Index | String | 1 | Nomor urut aliran subtitle. Parameter ini menunjukkan posisi aliran subtitle di antara semua aliran subtitle. |
| Lang | String | eng | Bahasa aliran subtitle. Untuk informasi selengkapnya, lihat Definisi bahasa FFmpeg dan ISO 639. |
| Format | Object | Informasi format. |
|
| StartTime | String | -0.064000 | Waktu mulai. |
| NumPrograms | String | 0 | Jumlah total aliran program. |
| Size | String | 1057273 | Ukuran file. |
| NumStreams | String | 2 | Jumlah total aliran media. |
| FormatLongName | String | QuickTime / MOV | Nama lengkap format kontainer. |
| Duration | String | 17.234000 | Durasi total. |
| Bitrate | String | 490.784 | Bitrate total. |
| FormatName | String | mov | Nama singkat format kontainer. Nilai valid: mov, mp4, m4a, 3gp, 3g2, dan mj2. |
| FileSize | String | 1057273 | Ukuran file. |
| PipelineId | String | 88c6ca184c0e47b665e2a1267971**** | ID Antrian MPS. |
| Input | Object | Informasi tentang input pekerjaan. |
|
| Object | String | video_01.mp4 | Nama objek OSS yang digunakan sebagai file media input. |
| Location | String | oss-cn-shanghai | Wilayah OSS tempat file input berada. |
| Bucket | String | exampleBucket | Nama bucket OSS tempat file input disimpan. |
| MNSMessageResult | Object | Pesan yang dikirim oleh Message Service (MNS) untuk memberi tahu pengguna tentang hasil pekerjaan. |
|
| MessageId | String | 123 | ID pesan sukses yang dikembalikan saat pekerjaan berhasil. |
| ErrorMessage | String | The resource operated "%s" cannot be found. | Pesan kesalahan yang dikembalikan saat pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
| ErrorCode | String | InvalidParameter.ResourceNotFound | Kode kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
Parameter callback
Saat status pekerjaan transkoding berubah, MPS mengirim pesan ke antrian MNS yang ditentukan. Untuk informasi selengkapnya tentang cara menentukan antrian MNS untuk menerima callback, lihat topik UpdatePipeline.~~188374~~ Pesan callback adalah string JSON yang berisi parameter yang dijelaskan dalam tabel berikut.
{
"Type": "Transcode",
"State": "Success",
"JobId": "39f8e0bc005e4f309379701645f4****",
"UserData": "{\"key\":\"value\"}",
"RequestId": "25818875-5F78-4A13-BEF6-D7393642****"
}
Parameter |
Type |
Deskripsi |
Type |
String |
Nilainya tetap Transcode, yang menunjukkan pekerjaan transkoding. |
JobId |
String |
ID unik pekerjaan. |
State |
String |
Status saat ini dari pekerjaan. Nilainya sama dengan nilai parameter State yang dikembalikan dalam operasi QueryJobList. |
UserData |
String |
Data pengguna yang ditentukan untuk pekerjaan dalam operasi SubmitJobs. |
Contoh
Permintaan Contoh
http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryJobList
&JobIds=bb558c1cc25b45309aab5be44d19****,d1ce4d3efcb549419193f50f1fcd****
&<Common request parameters>
Respons Sukses Contoh
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<QueryJobListResponse>
<NonExistJobIds>d1ce4d3efcb549419193f50f1fcd****</NonExistJobIds>
<RequestId>197ADF44-104C-514C-9F92-D8924CB34E2A</RequestId>
<JobList>
<CreationTime>2014-01-10T12:00:00Z</CreationTime>
<Percent>100</Percent>
<FinishTime>2014-01-10T12:20:25Z</FinishTime>
<State>TranscodeSuccess</State>
<JobId>31fa3c9ca8134fb4b0b0f7878301****</JobId>
<Code>InvalidParameter.NullValue</Code>
<Message>The specified parameter "%s" cannot be null.</Message>
<Output>
<Video>
<Bufsize>6000</Bufsize>
<Degrain>5</Degrain>
<BitrateBnd>
<Max>1000</Max>
<Min>300</Min>
</BitrateBnd>
<PixFmt>yuv420p</PixFmt>
<Pad>1280:800:0:140</Pad>
<Codec>H.264</Codec>
<Height>720</Height>
<Qscale>15</Qscale>
<Crop>1280:800:0:140</Crop>
<Bitrate>500</Bitrate>
<Maxrate>3000</Maxrate>
<MaxFps>60</MaxFps>
<Profile>high</Profile>
<Crf>26</Crf>
<Gop>250</Gop>
<Width>1280</Width>
<Fps>25</Fps>
<Preset>medium</Preset>
<ScanMode>interlaced</ScanMode>
<ResoPriority>1</ResoPriority>
</Video>
<TransConfig>
<IsCheckAudioBitrate>false</IsCheckAudioBitrate>
<TransMode>onepass</TransMode>
<IsCheckReso>false</IsCheckReso>
<IsCheckVideoBitrateFail>false</IsCheckVideoBitrateFail>
<AdjDarMethod>none</AdjDarMethod>
<IsCheckVideoBitrate>false</IsCheckVideoBitrate>
<IsCheckResoFail>false</IsCheckResoFail>
<IsCheckAudioBitrateFail>false</IsCheckAudioBitrateFail>
</TransConfig>
<Encryption>
<Type>hls-aes-128</Type>
<Key>encryptionkey128</Key>
<KeyType>Base64</KeyType>
<Id>31fa3c9ca8134f9cec2b4b0b0f78****</Id>
<KeyUri>https://1161758785*****.cn-shanghai.fc.aliyuncs.com/2016-08-15/proxy/HLS-decyptServer/decyptServer/</KeyUri>
<SkipCnt>3</SkipCnt>
</Encryption>
<WaterMarkList>
<Type>Image</Type>
<ReferPos>TopRight</ReferPos>
<Dx>100</Dx>
<Width>50</Width>
<Height>50</Height>
<InputFile>
<Object>example-logo-****.png</Object>
<Location>oss-cn-hangzhou</Location>
<Bucket>example-bucket</Bucket>
</InputFile>
<WaterMarkTemplateId>88c6ca184c0e47098a5b665e2a12****</WaterMarkTemplateId>
<Dy>100</Dy>
</WaterMarkList>
<WaterMarkConfigUrl>http://example.com/configure</WaterMarkConfigUrl>
<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}]}</DeWatermark>
<M3U8NonStandardSupport>
<TS>
<SizeSupport>true</SizeSupport>
<Md5Support>true</Md5Support>
</TS>
</M3U8NonStandardSupport>
<Priority>6</Priority>
<Audio>
<Profile>aaclow</Profile>
<Codec>aac</Codec>
<Samplerate>44100</Samplerate>
<Qscale>15</Qscale>
<Channels>2</Channels>
<Volume>
<Method>auto</Method>
<Level>-20</Level>
</Volume>
<Bitrate>128</Bitrate>
</Audio>
<AudioStreamMap>0:a:0</AudioStreamMap>
<MergeList>
<Start>01:59:59.999</Start>
<RoleArn>acs:ram::<your uid>:role/<your role name></RoleArn>
<MergeURL>http://example-bucket.oss-cn-hangzhou.aliyuncs.com/example-object.flv</MergeURL>
<Duration>01:59:59.999</Duration>
</MergeList>
<SuperReso>
<IsHalfSample>true</IsHalfSample>
</SuperReso>
<UserData>testid-001</UserData>
<ExtendData>testid-002</ExtendData>
<OutSubtitleList>
<Map>0:v:0</Map>
<OutSubtitleFile>
<RoleArn>acs:ram::<your uid>:role/<your role name></RoleArn>
<Object>example.flv</Object>
<Location>oss-cn-hangzhou</Location>
<Bucket>exampleBucket</Bucket>
</OutSubtitleFile>
<Success>true</Success>
<Message>The specified parameter "%s" cannot be null.</Message>
</OutSubtitleList>
<VideoStreamMap>0</VideoStreamMap>
<OutputFile>
<RoleArn>acs:ram::<your uid>:role/<your role name></RoleArn>
<Object>example-output.flv</Object>
<Location>oss-cn-hangzhou</Location>
<Bucket>example-bucket</Bucket>
</OutputFile>
<Rotate>90</Rotate>
<Container>
<Format>mp4</Format>
</Container>
<Clip>
<TimeSpan>
<Seek>01:59:59.999</Seek>
<Duration>01:00:59.999</Duration>
</TimeSpan>
</Clip>
<MergeConfigUrl>https://ceshi-***.oss-cn-shanghai.aliyuncs.com/ccc/p0903q9wkkb.m3u8</MergeConfigUrl>
<OpeningList>
<openUrl>http://example.oss-cn-shanghai.aliyuncs.com/t5.mp4</openUrl>
<Start>0</Start>
<Width>-1</Width>
<Height>-1</Height>
</OpeningList>
<MuxConfig>
<Webp>
<Loop>0</Loop>
</Webp>
<Gif>
<FinalDelay>0</FinalDelay>
<DitherMode>bayer</DitherMode>
<Loop>0</Loop>
<IsCustomPalette>false</IsCustomPalette>
</Gif>
<Segment>
<Duration>20</Duration>
</Segment>
</MuxConfig>
<TailSlateList>
<Start>00000.00</Start>
<BgColor>White</BgColor>
<IsMergeAudio>true</IsMergeAudio>
<Width>-1</Width>
<Height>-1</Height>
<BlendDuration>0</BlendDuration>
<TailUrl>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/opening_01.flv</TailUrl>
</TailSlateList>
<TemplateId>S00000001-200010</TemplateId>
<SubtitleConfig>
<ExtSubtitleList>
<CharEnc>auto</CharEnc>
<FontName>"WenQuanYi Zen Hei", "Yuanti SC Regular", "SimSun"</FontName>
<Input>
<Object>example-output.flv</Object>
<Location>oss-cn-hangzhou</Location>
<Bucket>example-bucket-****</Bucket>
</Input>
</ExtSubtitleList>
<SubtitleList>
<Map>0:a:0</Map>
</SubtitleList>
</SubtitleConfig>
<Properties>
<Width>720</Width>
<Height>1280</Height>
<SourceLogos>
<Source>example</Source>
</SourceLogos>
<Duration>17</Duration>
<Fps>30</Fps>
<Bitrate>490</Bitrate>
<FileFormat>mp4</FileFormat>
<Streams>
<VideoStreamList>
<Index>0</Index>
<Timebase>1/15360</Timebase>
<AvgFPS>30.0</AvgFPS>
<PixFmt>yuv420p</PixFmt>
<Sar>1:1</Sar>
<Lang>eng</Lang>
<CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
<Height>1280</Height>
<NumFrames>30</NumFrames>
<Bitrate>421.117</Bitrate>
<CodecTagString>avc1</CodecTagString>
<HasBFrames>2</HasBFrames>
<Profile>high</Profile>
<StartTime>0.000000</StartTime>
<NetworkCost>
<PreloadTime>8</PreloadTime>
<AvgBitrate>300</AvgBitrate>
<CostBandwidth>10</CostBandwidth>
</NetworkCost>
<Dar>9:16</Dar>
<CodecName>h264</CodecName>
<Width>720</Width>
<Duration>17.233333</Duration>
<Fps>30.0</Fps>
<CodecTag>0x31637661</CodecTag>
<CodecTimeBase>1/60</CodecTimeBase>
<Level>31</Level>
<colorTransfer>bt709</colorTransfer>
<colorPrimaries>bt709</colorPrimaries>
<bitsPerRawSample>8</bitsPerRawSample>
</VideoStreamList>
<AudioStreamList>
<Timebase>1/32000</Timebase>
<Index>1</Index>
<SampleFmt>fltp</SampleFmt>
<ChannelLayout>mono</ChannelLayout>
<Lang>und</Lang>
<Samplerate>32000</Samplerate>
<CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
<Channels>1</Channels>
<NumFrames>50</NumFrames>
<Bitrate>64.136</Bitrate>
<CodecTagString>mp4</CodecTagString>
<StartTime>0.064000</StartTime>
<CodecName>aac</CodecName>
<Duration>17.223562</Duration>
<CodecTag>0x6134706d</CodecTag>
<CodecTimeBase>1/32000</CodecTimeBase>
</AudioStreamList>
<SubtitleStreamList>
<Index>1</Index>
<Lang>eng</Lang>
</SubtitleStreamList>
</Streams>
<Format>
<StartTime>-0.064000</StartTime>
<NumPrograms>0</NumPrograms>
<Size>1057273</Size>
<NumStreams>2</NumStreams>
<FormatLongName>QuickTime / MOV</FormatLongName>
<Duration>17.234000</Duration>
<Bitrate>490.784</Bitrate>
<FormatName>mov</FormatName>
</Format>
<FileSize>1057273</FileSize>
</Properties>
</Output>
<PipelineId>88c6ca184c0e47b665e2a1267971****</PipelineId>
<Input>
<Object>video_01.mp4</Object>
<Location>oss-cn-shanghai</Location>
<Bucket>exampleBucket</Bucket>
</Input>
<MNSMessageResult>
<MessageId>123</MessageId>
<ErrorMessage>The resource operated "%s" cannot be found.</ErrorMessage>
<ErrorCode>InvalidParameter.ResourceNotFound</ErrorCode>
</MNSMessageResult>
</JobList>
</QueryJobListResponse>
JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"NonExistJobIds" : [ "d1ce4d3efcb549419193f50f1fcd****" ],
"RequestId" : "197ADF44-104C-514C-9F92-D8924CB34E2A",
"JobList" : [ {
"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" : [ {
"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" : [ {
"Start" : "01:59:59.999",
"RoleArn" : "acs:ram::<your uid>:role/<your role name>",
"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" : [ {
"Map" : "0:v:0",
"OutSubtitleFile" : {
"RoleArn" : "acs:ram::<your uid>:role/<your role name>",
"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::<your uid>:role/<your role name>",
"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" : [ {
"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" : [ {
"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" : [ {
"CharEnc" : "auto",
"FontName" : "\"WenQuanYi Zen Hei\", \"Yuanti SC Regular\", \"SimSun\"",
"Input" : {
"Object" : "example-output.flv",
"Location" : "oss-cn-hangzhou",
"Bucket" : "example-bucket-****"
}
} ],
"SubtitleList" : [ {
"Map" : "0:a:0"
} ]
},
"Properties" : {
"Width" : "720",
"Height" : "1280",
"SourceLogos" : [ {
"Source" : "example"
} ],
"Duration" : "17",
"Fps" : "30",
"Bitrate" : "490",
"FileFormat" : "mp4",
"Streams" : {
"VideoStreamList" : [ {
"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" : [ {
"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" : [ {
"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"
},
"FileSize" : "1057273"
}
},
"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"
}
} ]
}
Kode kesalahan
Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.