QueryMediaInfoJobList - - Alibaba Cloud Documentation Center

Menanyakan satu atau beberapa pekerjaan analisis informasi media.

Catatan penggunaan

Anda dapat memanggil operasi ini untuk menanyakan hingga 10 pekerjaan analisis informasi media sekaligus.
Setelah mengunggah file media, informasi medianya hanya dapat diambil setelah callback dikembalikan, yang menandakan bahwa file tersebut telah dianalisis. Jika Anda belum menerima callback dalam waktu lama atau belum mengonfigurasi pengaturan callback tetapi tetap tidak dapat mengambil informasi media meskipun pekerjaan analisis informasi media telah diajukan sejak lama, kemungkinan besar pekerjaan tersebut gagal. Dalam kasus ini, submit a ticket dan sertakan ID akun Alibaba Cloud Anda, wilayah tempat Anda menggunakan ApsaraVideo Media Processing (MPS), serta ID video untuk keperluan troubleshooting.

Batas QPS

Anda dapat memanggil operasi API ini hingga 100 kali per detik per akun. Permintaan yang melebihi batas ini akan dibuang dan dapat menyebabkan gangguan layanan. Pastikan Anda memperhatikan batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	QueryMediaInfoJobList	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke QueryMediaInfoJobList.
MediaInfoJobIds	String	Ya	23ca1d184c0e4341e5b665e2a12****	ID dari pekerjaan analisis informasi media. Pisahkan multiple pekerjaan dengan koma (,). Anda dapat mengkueri hingga 10 pekerjaan sekaligus.

Parameter respons

Parameter	Type	Contoh	Deskripsi
NonExistMediaInfoJobIds	Array of String	11ce1d184c0e4341e5b665e2a12****	ID pekerjaan analisis informasi media yang tidak ada. Jika semua pekerjaan yang ditentukan ada, respons tidak memuat parameter ini.
RequestId	String	46A04AA5-B119-41BB-B750-7C5327AC3E7A	ID dari permintaan tersebut.
MediaInfoJobList	Array of MediaInfoJob		Detail dari setiap pekerjaan analisis informasi media yang dikembalikan.
MediaInfoJob
CreationTime	String	2014-01-10T12:00:00Z	Waktu saat Pekerjaan dibuat.
State	String	Success	Status Pekerjaan. Nilai yang valid: Analyzing: Pekerjaan sedang dijalankan. Success: Pekerjaan berhasil. Fail: Pekerjaan gagal.
JobId	String	23ca1d184c0e4341e5b665e2a12****	ID Pekerjaan.
UserData	String	testid-001	Data kustom.
Code	String	InvalidParameter.JsonObjectFormatInvalid	Kode kesalahan yang dikembalikan saat Pekerjaan gagal.
Message	String	The parameter "*" does not conform to the JSON Object specification	Pesan error yang dikembalikan saat Pekerjaan gagal.
PipelineId	String	88c6ca184c0e432bbf5b665e2a15****	ID antrian MPS tempat pekerjaan ditambahkan.
Async	Boolean	true	Menunjukkan apakah Pekerjaan berada dalam mode asinkron.
Input	Object		Informasi mengenai input Pekerjaan.
Object	String	example.mp4	Nama objek Object Storage Service (OSS) yang digunakan sebagai file input.
Location	String	oss-cn-hangzhou	ID wilayah OSS.
Bucket	String	example-bucket	Nama Bucket OSS yang menyimpan objek tersebut.
MNSMessageResult	Object		Pesan yang dikirim oleh Message Service (MNS) untuk memberi tahu pengguna mengenai hasil Pekerjaan.
MessageId	String	123	ID dari pesan sukses yang dikembalikan ketika Pekerjaan berhasil. Parameter ini tidak dikembalikan jika Pekerjaan gagal.
ErrorMessage	String	The parameter \"Input\" does not conform to the JSON Object specification	Pesan error yang dikembalikan saat Pekerjaan gagal. Parameter ini tidak dikembalikan jika Pekerjaan berhasil.
ErrorCode	String	InvalidParameter.JsonObjectFormatInvalid	Kode kesalahan yang dikembalikan saat Pekerjaan gagal. Parameter ini tidak dikembalikan jika Pekerjaan berhasil.
Properti	Object		Informasi mengenai file input. Untuk informasi selengkapnya, lihat AliyunProperties.
Width	String	1280	Lebar video. Satuan: pixel.
Height	String	720	Tinggi video. Satuan: pixel.
Durasi	String	17.226000	Durasi.
Fps	String	25	Laju frame.
Bitrate	String	1630.045	Bitrate.
FileFormat	String	QuickTime/MOV	Format file.
Streams	Object		Informasi aliran.
VideoStreamList	Array of VideoStream		Informasi mengenai setiap aliran video.
VideoStream
Sar	String	1:1	Rasio aspek sampel (SAR).
Height	String	1080	Angka terakhir dalam resolusi video. Angka tersebut menunjukkan tinggi video.
CodecTagString	String	[0][0][0][0]	String tag dari format encoding.
NetworkCost	Object		Konsumsi lebar pita jaringan.
PreloadTime	String	8	Jumlah waktu preload.
AvgBitrate	String	300.34	Bitrate rata-rata.
CostBandwidth	String	10	Konsumsi bandwidth maksimum.
Width	String	1920	Angka pertama dalam resolusi video. Angka tersebut menunjukkan lebar video.
Index	String	1	Nomor urut aliran video. Nilai ini menunjukkan posisi aliran video tersebut di antara semua aliran video.
Timebase	String	1/1000	Pengatur waktu dasar.
AvgFPS	String	24000/1001	Laju frame rata-rata.
PixFmt	String	yuv420p	Format piksel.
Lang	String	eng	Bahasa.
CodecLongName	String	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10	Nama lengkap dari format encoding.
NumFrames	String	100	Jumlah total frame.
Rotate	String	180	Sudut rotasi video.
Bitrate	String	30541090	Bitrate.
HasBFrames	String	0	Menunjukkan apakah aliran video berisi frame dua arah (B-frames). Nilai 1 menunjukkan bahwa aliran video berisi B-frames. Nilai 0 menunjukkan bahwa aliran video tidak berisi B-frames.
Profile	String	High	Profil codec.
StartTime	String	0.042000	Waktu mulai.
Dar	String	16:9	Rasio aspek tampilan (DAR).
CodecName	String	h264	Nama pendek dari format encoding. Nilai yang valid: h264 h265 gif webp
Duration	String	100	Durasi.
Fps	String	25	Laju frame.
CodecTag	String	0x0000	Tag dari format encoding.
CodecTimeBase	String	1001/48000	Dasar waktu codec.
Level	String	41	Tingkat codec.
ColorRange	String	700	Kisaran warna.
ColorTransfer	String	R255 G83 B170	Saluran warna.
ColorPrimaries	String	700	Tingkat rekonstruksi warna.
AudioStreamList	Array of AudioStream		Informasi mengenai setiap aliran audio.
AudioStream
Timebase	String	1/1000	Pengatur waktu dasar.
Index	String	1	Nomor urut aliran audio. Nilai ini menunjukkan posisi aliran audio tersebut di antara semua aliran audio.
SampleFmt	String	fltp	Format pengambilan sampel.
ChannelLayout	String	5.1(side)	Jumlah saluran suara.
Lang	String	eng	Bahasa. Untuk informasi selengkapnya, lihat 21.20.1 Metadata dalam dokumentasi FFmpeg.
Samplerate	String	48000	Laju pengambilan sampel.
CodecLongName	String	DCA (DTS Coherent Acoustics)	Nama lengkap dari format encoding.
Channels	String	2	Tata letak output saluran suara.
NumFrames	String	123	Jumlah total frame.
Bitrate	String	1536000	Bitrate.
CodecTagString	String	[0][0][0][0]	String tag dari format encoding.
StartTime	String	0.042000	Waktu mulai.
CodecName	String	acc	Nama pendek dari format encoding. Nilai yang valid: acc mp3 mp4 ogg flac
Duration	String	123	Durasi.
CodecTag	String	0x0000	Tag dari format encoding.
CodecTimeBase	String	1/48000	Dasar waktu codec.
SubtitleStreamList	Array of SubtitleStream		Informasi mengenai setiap aliran subtitle.
SubtitleStream
Timebase	String	1/1000	Basis waktu.
Index	String	3	Nomor urut aliran subtitle. Nilai ini menunjukkan posisi aliran subtitle tersebut di antara semua aliran subtitle.
StartTime	String	0.000000	Waktu mulai.
CodecName	String	ass	Nama pendek dari format encoding. Nilai yang valid: srt ass
Lang	String	eng	Bahasa.
CodecLongName	String	ASS (Advanced SSA) subtitle	Nama lengkap dari format encoding.
Duration	String	1370.116000	Durasi. Satuan: detik.
CodecTag	String	0x0000	Tag dari 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.042000	Waktu mulai.
NumPrograms	String	2	Jumlah total aliran program.
Size	String	3509895	Ukuran file tersebut.
NumStreams	String	1	Jumlah total aliran media.
FormatLongName	String	QuickTime/MOV	Nama lengkap dari format kontainer.
Durasi	String	17.226000	Durasi total.
Laju Bit	String	1630.045	Bitrate total.
FormatName	String	mov	Nama pendek dari format kontainer.
FileSize	String	3509895	Ukuran file tersebut.

Parameter callback

Ketika status pekerjaan analisis informasi media berubah, MPS mengirim pesan ke antrian MNS yang ditentukan. Untuk informasi selengkapnya tentang cara menentukan antrian MNS untuk menerima callback, lihat topik UpdatePipeline. Pesan callback berupa string JSON yang berisi parameter yang dijelaskan dalam tabel berikut.


{
  "Type": "MediaInfo",
  "State": "Success",
  "JobId": "bb558c1cc25b45309aab5be44d19****",
  "UserData": "{\"key\":\"value\"}",
  "RequestId": "B52658D4-07AB-43CD-82B0-210958A6****"
}

Parameter	Tipe	Deskripsi
Type	String	Nilainya tetap MediaInfo, yang menunjukkan pekerjaan analisis informasi media.
JobId	String	ID unik pekerjaan.
State	String	Status saat ini dari pekerjaan. Nilainya sama dengan nilai parameter State yang dikembalikan dalam operasi QueryMediaInfoJobList.
UserData	String	Data pengguna yang ditentukan untuk pekerjaan dalam operasi SubmitMediaInfoJob.

Contoh

Permintaan Contoh

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryMediaInfoJobList
&MediaInfoJobIds=23ca1d184c0e4341e5b665e2a12****
&<Common request parameters>

Respons Sukses Contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<QueryMediaInfoJobListResponse>
    <NonExistMediaInfoJobIds>11ce1d184c0e4341e5b665e2a12****</NonExistMediaInfoJobIds>
    <RequestId>46A04AA5-B119-41BB-B750-7C5327AC3E7A</RequestId>
    <MediaInfoJobList>
        <CreationTime>2014-01-10T12:00:00Z</CreationTime>
        <State>Success</State>
        <JobId>23ca1d184c0e4341e5b665e2a12****</JobId>
        <UserData>testid-001</UserData>
        <PipelineId>88c6ca184c0e432bbf5b665e2a15****</PipelineId>
        <Async>true</Async>
        <Input>
            <Object>example.mp4</Object>
            <Location>oss-cn-hangzhou</Location>
            <Bucket>example-bucket</Bucket>
        </Input>
        <MNSMessageResult>
            <MessageId>123</MessageId>
        </MNSMessageResult>
        <Properties>
            <Width>1280</Width>
            <Height>720</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>[0][0][0][0]</CodecTagString>
                    <NetworkCost>
                        <PreloadTime>8</PreloadTime>
                        <AvgBitrate>300.34</AvgBitrate>
                        <CostBandwidth>10</CostBandwidth>
                    </NetworkCost>
                    <Width>1920</Width>
                    <Index>1</Index>
                    <Timebase>1/1000</Timebase>
                    <AvgFPS>24000/1001</AvgFPS>
                    <PixFmt>yuv420p</PixFmt>
                    <Lang>eng</Lang>
                    <CodecLongName>H.264/AVC/MPEG-4 AVC/MPEG-4 part 10</CodecLongName>
                    <NumFrames>100</NumFrames>
                    <Rotate>180</Rotate>
                    <Bitrate>30541090</Bitrate>
                    <HasBFrames>0</HasBFrames>
                    <Profile>High</Profile>
                    <StartTime>0.042000</StartTime>
                    <Dar>16:9</Dar>
                    <CodecName>h264</CodecName>
                    <Duration>100</Duration>
                    <Fps>25</Fps>
                    <CodecTag>0x0000</CodecTag>
                    <CodecTimeBase>1001/48000</CodecTimeBase>
                    <Level>41</Level>
                    <ColorRange>700</ColorRange>
                    <ColorTransfer>R255 G83 B170</ColorTransfer>
                    <ColorPrimaries>700</ColorPrimaries>
                </VideoStreamList>
                <AudioStreamList>
                    <Timebase>1/1000</Timebase>
                    <Index>1</Index>
                    <SampleFmt>fltp</SampleFmt>
                    <ChannelLayout>5.1(side)</ChannelLayout>
                    <Lang>eng</Lang>
                    <Samplerate>48000</Samplerate>
                    <CodecLongName>DCA (DTS Coherent Acoustics)</CodecLongName>
                    <Channels>2</Channels>
                    <NumFrames>123</NumFrames>
                    <Bitrate>1536000</Bitrate>
                    <CodecTagString>[0][0][0][0]</CodecTagString>
                    <StartTime>0.042000</StartTime>
                    <CodecName>acc</CodecName>
                    <Duration>123</Duration>
                    <CodecTag>0x0000</CodecTag>
                    <CodecTimeBase>1/48000</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.042000</StartTime>
                <NumPrograms>2</NumPrograms>
                <Size>3509895</Size>
                <NumStreams>1</NumStreams>
                <FormatLongName>QuickTime/MOV</FormatLongName>
                <Duration>17.226000</Duration>
                <Bitrate>1630.045</Bitrate>
                <FormatName>mov</FormatName>
            </Format>
            <FileSize>3509895</FileSize>
        </Properties>
    </MediaInfoJobList>
</QueryMediaInfoJobListResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
    "NonExistMediaInfoJobIds": [
        "11ce1d184c0e4341e5b665e2a12****"
    ],
    "RequestId": "46A04AA5-B119-41BB-B750-7C5327AC3E7A",
    "MediaInfoJobList": [
        {
            "CreationTime": "2014-01-10T12:00:00Z",
            "State": "Success",
            "JobId": "23ca1d184c0e4341e5b665e2a12****",
            "UserData": "testid-001",
            "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
            "Async": true,
            "Input": {
                "Object": "example.mp4",
                "Location": "oss-cn-hangzhou",
                "Bucket": "example-bucket"
            },
            "MNSMessageResult": {
                "MessageId": "123",
            },
            "Properties": {
                "Width": "1280",
                "Height": "720",
                "Duration": "17.226000",
                "Fps": "25",
                "Bitrate": "1630.045",
                "FileFormat": "QuickTime/MOV",
                "Streams": {
                    "VideoStreamList": [
                        {
                            "Sar": "1:1",
                            "Height": "1080",
                            "CodecTagString": "[0][0][0][0]",
                            "NetworkCost": {
                                "PreloadTime": "8",
                                "AvgBitrate": "300.34",
                                "CostBandwidth": "10"
                            },
                            "Width": "1920",
                            "Index": "1",
                            "Timebase": "1/1000",
                            "AvgFPS": "24000/1001",
                            "PixFmt": "yuv420p",
                            "Lang": "eng",
                            "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
                            "NumFrames": "100",
                            "Rotate": "180",
                            "Bitrate": "30541090",
                            "HasBFrames": "0",
                            "Profile": "High",
                            "StartTime": "0.042000",
                            "Dar": "16:9",
                            "CodecName": "h264",
                            "Duration": "100",
                            "Fps": "25",
                            "CodecTag": "0x0000",
                            "CodecTimeBase": "1001/48000",
                            "Level": "41",
                            "ColorRange": "700",
                            "ColorTransfer": "R255 G83 B170",
                            "ColorPrimaries": "700"
                        }
                    ],
                    "AudioStreamList": [
                        {
                            "Timebase": "1/1000",
                            "Index": "1",
                            "SampleFmt": "fltp",
                            "ChannelLayout": "5.1(side)",
                            "Lang": "eng",
                            "Samplerate": "48000",
                            "CodecLongName": "DCA (DTS Coherent Acoustics)",
                            "Channels": "2",
                            "NumFrames": "123",
                            "Bitrate": "1536000",
                            "CodecTagString": "[0][0][0][0]",
                            "StartTime": "0.042000",
                            "CodecName": "acc",
                            "Duration": "123",
                            "CodecTag": "0x0000",
                            "CodecTimeBase": "1/48000"
                        }
                    ],
                    "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.042000",
                    "NumPrograms": "2",
                    "Size": "3509895",
                    "NumStreams": "1",
                    "FormatLongName": "QuickTime/MOV",
                    "Duration": "17.226000",
                    "Bitrate": "1630.045",
                    "FormatName": "mov"
                },
                "FileSize": "3509895"
            }
        }
    ]
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi Error Center.