Mengirimkan pekerjaan analisis informasi media.
Deskripsi
Setelah Anda memanggil operasi SubmitMediaInfoJob, ApsaraVideo Media Processing (MPS) menganalisis file media input dan menghasilkan hasil analisis tersebut. Anda dapat memanggil operasi QueryMediaInfoJobList untuk menanyakan hasil analisis tersebut.
Batas QPS
Anda dapat memanggil operasi ini hingga 50 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 | Tipe | Wajib | Contoh | Deskripsi |
| Action | String | Ya | SubmitMediaInfoJob | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke SubmitMediaInfoJob. |
| Input | String | Ya | {"Bucket":"example-bucket","Location":"example-location","Object":"example%2Fexample.flv"} | Informasi mengenai file media input. Nilainya berupa string JSON. Anda harus melakukan langkah-langkah berikut untuk memberikan izin kepada MPS agar dapat mengakses bucket OSS tempat file media input disimpan: Login ke MPS console, pilih Workflows > Media Buckets pada panel navigasi sebelah kiri, lalu klik Add Bucket. Setelah itu, Anda harus melakukan URL-encode terhadap objek tersebut. Misalnya, Catatan Bucket OSS harus berada di wilayah tempat Anda menggunakan MPS. |
| UserData | String | Tidak | testid-001 | Data kustom. Data kustom dapat berisi huruf, angka, dan tanda hubung (-), serta panjangnya maksimal 1.024 byte. Data tidak boleh diawali dengan tanda hubung (-). |
| PipelineId | String | Tidak | 88c6ca184c0e432bbf5b665e2a15**** | ID Antrian MPS tempat pekerjaan analisis dikirimkan. Untuk melihat ID Antrian MPS, login ke MPS console dan pilih Global Settings > Pipelines pada panel navigasi sebelah kiri. |
| Async | Boolean | Tidak | true | Menentukan apakah mode asinkron diaktifkan untuk pekerjaan ini. Kami menyarankan agar Anda menetapkan parameter ini ke true. Nilai yang valid:
|
Parameter respons
| Parameter | Tipe | Contoh | Deskripsi |
| MediaInfoJob | Object | Detail pekerjaan analisis informasi media. |
|
| CreationTime | String | 2014-01-10T12:00:00Z | Waktu saat pekerjaan dibuat. |
| State | String | Analyzing | Status pekerjaan. Nilai yang valid:
|
| JobId | String | 23ca1d184c0e4341e5b665e2a12**** | ID pekerjaan. |
| UserData | String | testid-001 | Data kustom. |
| Code | String | InvalidParameter.JsonObjectFormatInvalid | Kode kesalahan yang dikembalikan jika pekerjaan gagal. |
| Message | String | The parameter "*" does not conform to the JSON Object specification | Pesan kesalahan yang dikembalikan jika pekerjaan gagal. |
| PipelineId | String | 88c6ca184c0e432bbf5b665e2a15**** | ID Antrian MPS tempat pekerjaan analisis dikirimkan. |
| Async | Boolean | true | Menunjukkan apakah pekerjaan dijalankan dalam mode asinkron. |
| Input | Object | Informasi mengenai file media input. |
|
| Object | String | example.flv | Nama objek OSS yang digunakan sebagai file media input. |
| Location | String | example-location | Wilayah bucket OSS tempat file media input disimpan. |
| Bucket | String | example-bucket | Nama bucket OSS tempat file media input disimpan. |
| MNSMessageResult | Object | Detail pesan yang dikirim ke Message Service (MNS) untuk memberi tahu pengguna mengenai hasil pekerjaan. |
|
| MessageId | String | 16f01ad6175e4230ac42bb5182cd**** | ID pesan yang dikembalikan jika pekerjaan berhasil. Parameter ini tidak dikembalikan jika pekerjaan gagal. |
| ErrorMessage | String | InvalidParameter.JsonObjectFormatInvalid | Pesan kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
| ErrorCode | String | The parameter \"Input\" does not conform to the JSON Object specification | Kode kesalahan yang dikembalikan jika pekerjaan gagal. Parameter ini tidak dikembalikan jika pekerjaan berhasil. |
| Properties | Object | Properti file media input. |
|
| Width | String | 1920 | Lebar video. Satuan: piksel. |
| Height | String | 1080 | Tinggi video. Satuan: piksel. |
| Duration | String | 17.226000 | Durasi total file media input. Satuan: detik. |
| Fps | String | 25 | Laju frame. |
| Bitrate | String | 1630.045 | Bitrate. Satuan: Kbit/s. |
| FileFormat | String | QuickTime/MOV | Format file media input. |
| Streams | Object | Aliran media yang terdapat dalam file media input. |
|
| VideoStreamList | Array of VideoStream | Aliran video. Sebuah file media dapat berisi hingga empat aliran video. |
|
| VideoStream | |||
| Sar | String | 1:1 | Rasio aspek sampel (SAR). |
| Height | String | 1080 | Tinggi video. Satuan: piksel. |
| CodecTagString | String | avc1 | String tag format encoding. |
| NetworkCost | Object | Lebar pita jaringan yang dikonsumsi. |
|
| PreloadTime | String | 8 | Waktu yang dikonsumsi untuk preload video. |
| AvgBitrate | String | 300.34 | Rata-rata bitrate. Satuan: Kbit/s. |
| CostBandwidth | String | 10 | Lebar pita maksimum yang dikonsumsi. |
| Width | String | 1920 | Lebar video. Satuan: piksel. |
| Index | String | 1 | Nomor urut aliran video. Nilai ini menunjukkan posisi aliran video di antara semua aliran video. Nomor urut aliran video pertama yang diputar dapat ditentukan di beberapa pemutar. Nilai default: 1. |
| Timebase | String | 1/24000 | Dasar waktu. |
| AvgFPS | String | 23.976025 | Rata-rata laju frame. |
| PixFmt | String | yuv420p | Format piksel. |
| Lang | String | eng | Bahasa. |
| CodecLongName | String | H.264/AVC/MPEG-4 AVC/MPEG-4 part 10 | Nama lengkap format encoding. |
| NumFrames | String | 100 | Jumlah total frame. |
| Rotate | String | 90 | Sudut rotasi video. |
| Bitrate | String | 1496.46 | Bitrate. Satuan: Kbit/s. |
| HasBFrames | String | 0 | Menunjukkan apakah aliran video berisi frame bidireksional (B-frame). Nilai 1 berarti aliran video berisi B-frame. Nilai 0 berarti aliran video tidak berisi B-frame. |
| Profile | String | High | Profil codec. |
| StartTime | String | 0.042000 | Waktu mulai. |
| Dar | String | 16:9 | Rasio aspek tampilan (DAR). DAR adalah hubungan proporsional antara lebar dan tinggi video. Nilai ini digunakan untuk menentukan apakah video berada dalam mode potret atau lanskap. |
| CodecName | String | h264 | Nama singkat format encoding. Nilai yang valid:
|
| Duration | String | 17.225542 | Durasi. Satuan: detik. |
| Fps | String | 25 | Laju frame. |
| CodecTag | String | 0x31637661 | Tag format encoding. |
| CodecTimeBase | String | 1001/48000 | Dasar waktu codec. |
| Level | String | 41 | Tingkat codec. |
| ColorRange | String | 700 | Rentang warna. |
| ColorTransfer | String | R255 G83 B170 | Saluran warna. |
| ColorPrimaries | String | 700 | Tingkat rekonstruksi warna. |
| AudioStreamList | Array of AudioStream | Aliran audio. Sebuah file media dapat berisi hingga empat aliran audio. |
|
| AudioStream | |||
| Timebase | String | 1/44100 | Dasar 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 | stereo | Tata letak output saluran suara. |
| Lang | String | eng | Bahasa. |
| Samplerate | String | 44100 | Laju pengambilan sampel. Satuan: Hz. |
| CodecLongName | String | AAC (Advanced Audio Coding) | Nama lengkap format encoding. |
| Channels | String | 2 | Jumlah saluran suara. |
| NumFrames | String | 123 | Jumlah total frame. |
| Bitrate | String | 128.806 | Bitrate. Satuan: Kbit/s. |
| CodecTagString | String | mp4a | String tag dari format encoding. |
| StartTime | String | 0.000000 | Waktu mulai. |
| CodecName | String | aac | Nama singkat format encoding. Nilai default: acc. Nilai yang valid:
|
| Duration | String | 17.159546 | Durasi. Satuan: detik. |
| CodecTag | String | 0x6134706d | Tag format encoding. |
| CodecTimeBase | String | 1/44100 | Dasar waktu codec. |
| SubtitleStreamList | Array of SubtitleStream | Aliran subtitle. Sebuah file media dapat berisi hingga empat aliran subtitle. |
|
| SubtitleStream | |||
| Timebase | String | 1/1000 | Dasar waktu. |
| Index | String | 3 | Nomor urut aliran subtitle. Nilai ini menunjukkan posisi aliran subtitle di antara semua aliran subtitle. |
| StartTime | String | 0.000000 | Waktu mulai. |
| CodecName | String | ass | Nama singkat format encoding. Nilai yang valid:
|
| Lang | String | eng | Bahasa. |
| CodecLongName | String | ASS (Advanced SSA) subtitle | Nama lengkap format encoding. |
| Duration | String | 1370.116000 | Durasi. Satuan: detik. |
| CodecTag | String | 0x0000 | Tag format encoding. |
| CodecTimeBase | String | 0/1 | Dasar waktu codec. |
| CodecTagString | String | [0][0][0][0] | String tag dari format encoding. |
| Format | Object | Informasi format. |
|
| StartTime | String | 0.000000 | Waktu mulai. |
| NumPrograms | String | 0 | Jumlah total aliran program. |
| Size | String | 3509895 | Ukuran file. Satuan: byte. |
| NumStreams | String | 2 | Jumlah total aliran media. |
| FormatLongName | String | QuickTime/MOV | Nama lengkap format kontainer. |
| Duration | String | 17.226000 | Durasi total file media input. Satuan: detik. |
| Bitrate | String | 1630.045 | Total bitrate. Satuan: Kbit/s. |
| FormatName | String | mov | Nama singkat format kontainer. Untuk informasi lebih lanjut mengenai parameter, lihat Detail parameter. |
| FileSize | String | 3509895 | Ukuran file. Satuan: byte. |
| RequestId | String | 62D9BE16-B7D5-550C-A482-7A0F60E09877 | ID permintaan. Catatan Jika terjadi kesalahan permintaan, periksa apakah file media input valid. Jika file tersebut valid tetapi masalah masih berlanjut, kirim tiket untuk menghubungi layanan pelanggan Alibaba Cloud. |
Contoh
Contoh permintaan
http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=SubmitMediaInfoJob
&ResourceOwnerId=1
&Input={"Bucket":"example-bucket","Location":"example-location","Object":"example%2Fexample.flv"}
&UserData=testid-001
&PipelineId=88c6ca184c0e432bbf5b665e2a15****
&Async=true
&<Common request parameters>
Contoh respons sukses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<SubmitMediaInfoJobResponse>
<MediaInfoJob>
<CreationTime>2014-01-10T12:00:00Z</CreationTime>
<State>Analyzing</State>
<JobId>23ca1d184c0e4341e5b665e2a12****</JobId>
<UserData>testid-001</UserData>
<PipelineId>88c6ca184c0e432bbf5b665e2a15****</PipelineId>
<Async>true</Async>
<Input>
<Object>example.flv</Object>
<Location>example-location</Location>
<Bucket>example-bucket</Bucket>
</Input>
<MNSMessageResult>
<MessageId>16f01ad6175e4230ac42bb5182cd****</MessageId>
</MNSMessageResult>
<Properties>
<Width>1920</Width>
<Height>1080</Height>
<Duration>17.226000</Duration>
<Fps>25</Fps>
<Bitrate>1630.045</Bitrate>
<FileFormat>QuickTime/MOV</FileFormat>
<Streams>
<VideoStreamList>
<Sar>1:1</Sar>
<Height>1080</Height>
<CodecTagString>avc1</CodecTagString>
<NetworkCost>
<PreloadTime>8</PreloadTime>
<AvgBitrate>300.34</AvgBitrate>
<CostBandwidth>10</CostBandwidth>
</NetworkCost>
<Width>1920</Width>
<Index>1</Index>
<Timebase>1/24000</Timebase>
<AvgFPS>23.976025</AvgFPS>
<PixFmt>yuv420p</PixFmt>
<Lang>eng</Lang>
<CodecLongName>H.264/AVC/MPEG-4 AVC/MPEG-4 part 10</CodecLongName>
<NumFrames>100</NumFrames>
<Rotate>90</Rotate>
<Bitrate>1496.46</Bitrate>
<HasBFrames>0</HasBFrames>
<Profile>High</Profile>
<StartTime>0.042000</StartTime>
<Dar>16:9</Dar>
<CodecName>h264</CodecName>
<Duration>17.225542</Duration>
<Fps>25</Fps>
<CodecTag>0x31637661</CodecTag>
<CodecTimeBase>1001/48000</CodecTimeBase>
<Level>41</Level>
<ColorRange>700</ColorRange>
<ColorTransfer>R255 G83 B170</ColorTransfer>
<ColorPrimaries>700</ColorPrimaries>
</VideoStreamList>
<AudioStreamList>
<Timebase>1/44100</Timebase>
<Index>1</Index>
<SampleFmt>fltp</SampleFmt>
<ChannelLayout>stereo</ChannelLayout>
<Lang>eng</Lang>
<Samplerate>44100</Samplerate>
<CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
<Channels>2</Channels>
<NumFrames>123</NumFrames>
<Bitrate>128.806</Bitrate>
<CodecTagString>mp4a</CodecTagString>
<StartTime>0.000000</StartTime>
<CodecName>aac</CodecName>
<Duration>17.159546</Duration>
<CodecTag>0x6134706d</CodecTag>
<CodecTimeBase>1/44100</CodecTimeBase>
</AudioStreamList>
<SubtitleStreamList>
<Timebase>1/1000</Timebase>
<Index>3</Index>
<StartTime>0.000000</StartTime>
<CodecName>ass</CodecName>
<Lang>eng</Lang>
<CodecLongName>ASS (Advanced SSA) subtitle</CodecLongName>
<Duration>1370.116000</Duration>
<CodecTag>0x0000</CodecTag>
<CodecTimeBase>0/1</CodecTimeBase>
<CodecTagString>[0][0][0][0]</CodecTagString>
</SubtitleStreamList>
</Streams>
<Format>
<StartTime>0.000000</StartTime>
<NumPrograms>0</NumPrograms>
<Size>3509895</Size>
<NumStreams>2</NumStreams>
<FormatLongName>QuickTime/MOV</FormatLongName>
<Duration>17.226000</Duration>
<Bitrate>1630.045</Bitrate>
<FormatName>mov</FormatName>
</Format>
<FileSize>3509895</FileSize>
</Properties>
</MediaInfoJob>
<RequestId>62D9BE16-B7D5-550C-A482-7A0F60E09877</RequestId>
</SubmitMediaInfoJobResponse>
JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"MediaInfoJob": {
"CreationTime": "2014-01-10T12:00:00Z",
"State": "Analyzing",
"JobId": "23ca1d184c0e4341e5b665e2a12****",
"UserData": "testid-001",
"PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
"Async": true,
"Input": {
"Object": "example.flv",
"Location": "example-location",
"Bucket": "example-bucket"
},
"MNSMessageResult": {
"MessageId": "16f01ad6175e4230ac42bb5182cd****",
},
"Properties": {
"Width": "1920",
"Height": "1080",
"Duration": "17.226000",
"Fps": "25",
"Bitrate": "1630.045",
"FileFormat": "QuickTime/MOV",
"Streams": {
"VideoStreamList": [
{
"Sar": "1:1",
"Height": "1080",
"CodecTagString": "avc1",
"NetworkCost": {
"PreloadTime": "8",
"AvgBitrate": "300.34",
"CostBandwidth": "10"
},
"Width": "1920",
"Index": "1",
"Timebase": "1/24000",
"AvgFPS": "23.976025",
"PixFmt": "yuv420p",
"Lang": "eng",
"CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
"NumFrames": "100",
"Rotate": "90",
"Bitrate": "1496.46",
"HasBFrames": "0",
"Profile": "High",
"StartTime": "0.042000",
"Dar": "16:9",
"CodecName": "h264",
"Duration": "17.225542",
"Fps": "25",
"CodecTag": "0x31637661",
"CodecTimeBase": "1001/48000",
"Level": "41",
"ColorRange": "700",
"ColorTransfer": "R255 G83 B170",
"ColorPrimaries": "700"
}
],
"AudioStreamList": [
{
"Timebase": "1/44100",
"Index": "1",
"SampleFmt": "fltp",
"ChannelLayout": "stereo",
"Lang": "eng",
"Samplerate": "44100",
"CodecLongName": "AAC (Advanced Audio Coding)",
"Channels": "2",
"NumFrames": "123",
"Bitrate": "128.806",
"CodecTagString": "mp4a",
"StartTime": "0.000000",
"CodecName": "aac",
"Duration": "17.159546",
"CodecTag": "0x6134706d",
"CodecTimeBase": "1/44100"
}
],
"SubtitleStreamList": [
{
"Timebase": "1/1000",
"Index": "3",
"StartTime": "0.000000",
"CodecName": "ass",
"Lang": "eng",
"CodecLongName": "ASS (Advanced SSA) subtitle",
"Duration": "1370.116000",
"CodecTag": "0x0000",
"CodecTimeBase": "0/1",
"CodecTagString": "[0][0][0][0]"
}
]
},
"Format": {
"StartTime": "0.000000",
"NumPrograms": "0",
"Size": "3509895",
"NumStreams": "2",
"FormatLongName": "QuickTime/MOV",
"Duration": "17.226000",
"Bitrate": "1630.045",
"FormatName": "mov"
},
"FileSize": "3509895"
}
},
"RequestId": "62D9BE16-B7D5-550C-A482-7A0F60E09877"
}
Kode kesalahan
Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.