QueryMediaInfoJobList - : Central de Documentação do Alibaba Cloud

Observações de uso

Esta operação permite consultar até 10 jobs de análise de informações de mídia por vez.
Após o upload de um arquivo de mídia, as informações só ficam disponíveis depois que um callback confirma a conclusão da análise. Caso você não receba um callback por um longo período, ou se não tiver configurado callbacks e não conseguir recuperar as informações muito tempo após enviar o job de análise, o job pode ter falhado. Nesse caso,abra um ticket

e informe o ID da sua conta Alibaba Cloud, a região onde você utiliza o ApsaraVideo Media Processing (MPS) e o ID do vídeo para solução de problemas.

Limite de QPS

O limite desta API é de 100 chamadas por segundo por conta. Requisições acima desse limite são descartadas, o que pode causar interrupções no serviço. Recomendamos considerar essa restrição ao utilizar esta operação. Para mais detalhes, consulte Limite de QPS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior comodidade, recomendamos executar esta operação diretamente no OpenAPI Explorer, que também gera dinamicamente exemplos de código para diferentes SDKs.

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	QueryMediaInfoJobList	A operação a ser executada. Defina o valor como QueryMediaInfoJobList.
MediaInfoJobIds	String	Sim	23ca1d184c0e4341e5b665e2a12****	Os IDs dos jobs de análise de informações de mídia. Separe múltiplos IDs com vírgulas (,). É possível consultar até 10 jobs simultaneamente.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
NonExistMediaInfoJobIds	Array of String	11ce1d184c0e4341e5b665e2a12****	IDs dos jobs de análise de informações de mídia inexistentes. Se todos os jobs especificados existirem, a resposta não incluirá este parâmetro.
RequestId	String	46A04AA5-B119-41BB-B750-7C5327AC3E7A	ID da requisição.
MediaInfoJobList	Array of MediaInfoJob		Detalhes de cada job de análise de informações de mídia retornado.
MediaInfoJob
CreationTime	String	2014-01-10T12:00:00Z	Horário de criação do job.
State	String	Success	Status do job. Valores válidos: Analyzing: O job está em execução. Success: O job foi concluído com sucesso. Fail: O job falhou.
JobId	String	23ca1d184c0e4341e5b665e2a12****	ID do job.
UserData	String	testid-001	Dados personalizados.
Code	String	InvalidParameter.JsonObjectFormatInvalid	Código de erro retornado quando o job falha.
Message	String	The parameter "*" does not conform to the JSON Object specification	Mensagem de erro retornada quando o job falha.
PipelineId	String	88c6ca184c0e432bbf5b665e2a15****	ID da fila do MPS à qual o job foi adicionado.
Async	Boolean	true	Indica se o job opera em modo assíncrono.
Input	Object		Informações sobre a entrada do job.
Object	String	example.mp4	Nome do objeto do Object Storage Service (OSS) usado como arquivo de entrada.
Location	String	oss-cn-hangzhou	ID da região do OSS.
Bucket	String	example-bucket	Nome do bucket do OSS que armazena o objeto.
MNSMessageResult	Object		Mensagem enviada pelo Message Service (MNS) para notificar os usuários sobre o resultado do job.
MessageId	String	123	ID da mensagem de sucesso retornada quando o job é concluído com êxito. Este parâmetro não é retornado em caso de falha.
ErrorMessage	String	The parameter \"Input\" does not conform to the JSON Object specification	Mensagem de erro retornada quando o job falha. Este parâmetro não é retornado em caso de sucesso.
ErrorCode	String	InvalidParameter.JsonObjectFormatInvalid	Código de erro retornado quando o job falha. Este parâmetro não é retornado em caso de sucesso.
Properties	Object		Informações sobre o arquivo de entrada. Para mais detalhes, consulte AliyunProperties.
Width	String	1280	Largura do vídeo. Unidade: pixel.
Height	String	720	Altura do vídeo. Unidade: pixel.
Duration	String	17.226000	Duração.
Fps	String	25	Taxa de quadros.
Bitrate	String	1630.045	Taxa de bits.
FileFormat	String	QuickTime/MOV	Formato do arquivo.
Streams	Object		Informações dos streams.
VideoStreamList	Array of VideoStream		Informações de cada stream de vídeo.
VideoStream
Sar	String	1:1	Proporção de aspecto da amostra (SAR).
Height	String	1080	Segundo número na resolução do vídeo, representando a altura.
CodecTagString	String	[0][0][0][0]	String de tag do formato de codificação.
NetworkCost	Object		Consumo de largura de banda de rede.
PreloadTime	String	8	Tempo de pré-carregamento.
AvgBitrate	String	300.34	Taxa de bits média.
CostBandwidth	String	10	Consumo máximo de largura de banda.
Width	String	1920	Primeiro número na resolução do vídeo, representando a largura.
Index	String	1	Número sequencial do stream de vídeo, indicando sua posição entre todos os streams de vídeo.
Timebase	String	1/1000	Base de tempo.
AvgFPS	String	24000/1001	Taxa média de quadros.
PixFmt	String	yuv420p	Formato de pixel.
Lang	String	eng	Idioma.
CodecLongName	String	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10	Nome completo do formato de codificação.
NumFrames	String	100	Número total de quadros.
Rotate	String	180	Ângulo de rotação do vídeo.
Bitrate	String	30541090	Taxa de bits.
HasBFrames	String	0	Indica se o stream de vídeo contém quadros bidirecionais (B-frames). O valor 1 indica presença de B-frames; 0 indica ausência.
Profile	String	High	Perfil do codec.
StartTime	String	0.042000	Tempo inicial.
Dar	String	16:9	Proporção de aspecto de exibição (DAR).
CodecName	String	h264	Nome curto do formato de codificação. Valores válidos: h264 h265 gif webp
Duration	String	100	Duração.
Fps	String	25	Taxa de quadros.
CodecTag	String	0x0000	Tag do formato de codificação.
CodecTimeBase	String	1001/48000	Base de tempo do codec.
Level	String	41	Nível do codec.
ColorRange	String	700	Faixa de cores.
ColorTransfer	String	R255 G83 B170	Canal de cor.
ColorPrimaries	String	700	Nível de reconstrução de cores.
AudioStreamList	Array of AudioStream		Informações de cada stream de áudio.
AudioStream
Timebase	String	1/1000	Base de tempo.
Index	String	1	Número sequencial do stream de áudio, indicando sua posição entre todos os streams de áudio.
SampleFmt	String	fltp	Formato de amostragem.
ChannelLayout	String	5.1(side)	Número de canais de som.
Lang	String	eng	Idioma. Para mais informações, consulte 21.20.1 Metadata na documentação do FFmpeg.
Samplerate	String	48000	Taxa de amostragem.
CodecLongName	String	DCA (DTS Coherent Acoustics)	Nome completo do formato de codificação.
Channels	String	2	Layout de saída dos canais de som.
NumFrames	String	123	Número total de quadros.
Bitrate	String	1536000	Taxa de bits.
CodecTagString	String	[0][0][0][0]	String de tag do formato de codificação.
StartTime	String	0.042000	Tempo inicial.
CodecName	String	acc	Nome curto do formato de codificação. Valores válidos: acc mp3 mp4 ogg flac
Duration	String	123	Duração.
CodecTag	String	0x0000	Tag do formato de codificação.
CodecTimeBase	String	1/48000	Base de tempo do codec.
SubtitleStreamList	Array of SubtitleStream		Informações de cada stream de legenda.
SubtitleStream
Timebase	String	1/1000	Base de tempo.
Index	String	3	Número sequencial do stream de legenda, indicando sua posição entre todos os streams de legenda.
StartTime	String	0.000000	Tempo inicial.
CodecName	String	ass	Nome curto do formato de codificação. Valores válidos: srt ass
Lang	String	eng	Idioma.
CodecLongName	String	ASS (Advanced SSA) subtitle	Nome completo do formato de codificação.
Duration	String	1370.116000	Duração. Unidade: segundos.
CodecTag	String	0x0000	Tag do formato de codificação.
CodecTimeBase	String	0/1	Base de tempo do codec.
CodecTagString	String	[0][0][0][0]	String de tag do formato de codificação.
Format	Object		Informações do formato.
StartTime	String	0.042000	Tempo inicial.
NumPrograms	String	2	Número total de streams de programa.
Size	String	3509895	Tamanho do arquivo.
NumStreams	String	1	Número total de streams de mídia.
FormatLongName	String	QuickTime/MOV	Nome completo do formato de contêiner.
Duration	String	17.226000	Duração total.
Bitrate	String	1630.045	Taxa de bits total.
FormatName	String	mov	Nome curto do formato de contêiner.
FileSize	String	3509895	Tamanho do arquivo.

Parâmetros de callback

Quando o status do job de análise de informações de mídia muda, o MPS envia uma mensagem para a fila MNS especificada. Para saber como configurar uma fila MNS para receber callbacks, consulte o tópico UpdatePipeline. A mensagem de callback é uma string json contendo os parâmetros descritos na tabela a seguir.


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

Parâmetro	Tipo	Descrição
Type	String	Valor fixo MediaInfo, indicando um job de análise de informações de mídia.
JobId	String	ID exclusivo do job.
State	String	Status atual do job. O valor corresponde ao parâmetro State retornado na operação QueryMediaInfoJobList.
UserData	String	Dados do usuário especificados para o job na operação SubmitMediaInfoJob.

Exemplos

Exemplo de requisição

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

Exemplos de respostas de sucesso

Formato XML

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>

Formato JSON

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"
            }
        }
    ]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros.