QueryMediaInfoJobList - - Centre de documentation Alibaba Cloud

Interroge un ou plusieurs jobs d'analyse des informations multimédias.

Notes d'utilisation

Vous pouvez appeler cette opération pour interroger jusqu'à 10 jobs d'analyse des informations multimédias en une seule fois.
Après le téléchargement d'un fichier multimédia, les informations associées ne sont accessibles qu'une fois le callback renvoyé, indiquant que l'analyse du fichier est terminée. Si vous ne recevez pas de callback après une longue période, ou si vous n'avez pas configuré les paramètres de callback et que les informations restent indisponibles longtemps après la soumission du job, il est possible que celui-ci ait échoué. Dans ce cas,soumettez un ticket

et fournissez votre ID de compte Alibaba Cloud, la région dans laquelle vous utilisez ApsaraVideo Media Processing (MPS) ainsi que l'ID de la vidéo pour faciliter le dépannage.

Limite QPS

Vous pouvez appeler cette API jusqu'à 100 fois par seconde par compte. Les requêtes dépassant cette limite sont rejetées, ce qui entraîne des interruptions de service. Nous vous recommandons de prendre en compte cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la section Limite QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Par commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. Celui-ci génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

L'opération que vous souhaitez effectuer. Définissez la valeur sur QueryMediaInfoJobList.

Les ID des jobs d'analyse des informations multimédias. Séparez plusieurs jobs par des virgules (,). Vous pouvez interroger jusqu'à 10 jobs en une seule fois.

Paramètres de réponse

Paramètre	Type	Exemple	Description
NonExistMediaInfoJobIds	Array of String	11ce1d184c0e4341e5b665e2a12****	Les ID des tâches d'analyse des informations multimédia qui n'existent pas. Si toutes les tâches spécifiées existent, la réponse ne contient pas ce paramètre.
RequestId	String	46A04AA5-B119-41BB-B750-7C5327AC3E7A	L'ID de la requête.
MediaInfoJobList	Array of MediaInfoJob		Les détails de chaque tâche d'analyse des informations multimédia renvoyée.
MediaInfoJob
CreationTime	String	2014-01-10T12:00:00Z	L'heure de création de la tâche.
State	String	Success	L'état de la tâche. Valeurs valides : Analyzing : La tâche est en cours d'exécution. Success : La tâche a réussi. Fail : La tâche a échoué.
JobId	String	23ca1d184c0e4341e5b665e2a12****	L'ID de la tâche.
UserData	String	testid-001	Les données personnalisées.
Code	String	InvalidParameter.JsonObjectFormatInvalid	Le code d'erreur renvoyé en cas d'échec de la tâche.
Message	String	The parameter "*" does not conform to the JSON Object specification	Le message d'erreur renvoyé en cas d'échec de la tâche.
PipelineId	String	88c6ca184c0e432bbf5b665e2a15****	L'ID de la file d'attente MPS à laquelle la tâche est ajoutée.
Async	Boolean	true	Indique si la tâche s'exécute en mode asynchrone.
Input	Object		Les informations relatives à l'entrée de la tâche.
Object	String	example.mp4	Le nom de l'objet Object Storage Service (OSS) utilisé comme fichier d'entrée.
Location	String	oss-cn-hangzhou	L'ID de la région OSS.
Bucket	String	example-bucket	Le nom du compartiment OSS qui stocke l'objet.
MNSMessageResult	Object		Le message envoyé par Message Service (MNS) pour notifier les utilisateurs du résultat de la tâche.
MessageId	String	123	L'ID du message de succès renvoyé lorsque la tâche réussit. Ce paramètre n'est pas renvoyé si la tâche échoue.
ErrorMessage	String	The parameter \"Input\" does not conform to the JSON Object specification	Le message d'erreur renvoyé lorsque la tâche échoue. Ce paramètre n'est pas renvoyé si la tâche réussit.
ErrorCode	String	InvalidParameter.JsonObjectFormatInvalid	Le code d'erreur renvoyé lorsque la tâche échoue. Ce paramètre n'est pas renvoyé si la tâche réussit.
Properties	Object		Les informations relatives au fichier d'entrée. Pour plus d'informations, consultez AliyunProperties.
Width	String	1280	La largeur de la vidéo. Unité : pixel.
Height	String	720	La hauteur de la vidéo. Unité : pixel.
Duration	String	17.226000	La durée.
Fps	String	25	La fréquence d'images.
Bitrate	String	1630.045	Le débit binaire.
FileFormat	String	QuickTime/MOV	Le format de fichier.
Streams	Object		Les informations relatives aux flux.
VideoStreamList	Array of VideoStream		Les informations relatives à chaque flux vidéo.
VideoStream
Sar	String	1:1	Le rapport d'aspect des échantillons (SAR).
Height	String	1080	Le second nombre de la résolution vidéo. Ce nombre indique la hauteur de la vidéo.
CodecTagString	String	[0][0][0][0]	La chaîne de tag du format d'encodage.
NetworkCost	Object		La consommation de bande passante réseau.
PreloadTime	String	8	Le temps de préchargement.
AvgBitrate	String	300.34	Le débit binaire moyen.
CostBandwidth	String	10	La consommation maximale de bande passante.
Width	String	1920	Le premier nombre de la résolution vidéo. Ce nombre indique la largeur de la vidéo.
Index	String	1	Le numéro de séquence du flux vidéo. La valeur indique la position du flux vidéo parmi tous les flux vidéo.
Timebase	String	1/1000	La base de temps.
AvgFPS	String	24000/1001	La fréquence d'images moyenne.
PixFmt	String	yuv420p	Le format de pixel.
Lang	String	eng	La langue.
CodecLongName	String	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10	Le nom complet du format d'encodage.
NumFrames	String	100	Le nombre total d'images.
Rotate	String	180	L'angle de rotation de la vidéo.
Bitrate	String	30541090	Le débit binaire.
HasBFrames	String	0	Indique si le flux vidéo contient des images bidirectionnelles (images B). Une valeur de 1 indique que le flux vidéo contient des images B. Une valeur de 0 indique que le flux vidéo ne contient pas d'images B.
Profile	String	High	Le profil du codec.
StartTime	String	0.042000	L'heure de début.
Dar	String	16:9	Le rapport d'aspect à l'affichage (DAR).
CodecName	String	h264	Le nom court du format d'encodage. Valeurs valides : h264 h265 gif webp
Duration	String	100	La durée.
Fps	String	25	La fréquence d'images.
CodecTag	String	0x0000	Le tag du format d'encodage.
CodecTimeBase	String	1001/48000	La base de temps du codec.
Level	String	41	Le niveau du codec.
ColorRange	String	700	La plage de couleurs.
ColorTransfer	String	R255 G83 B170	Le canal de couleur.
ColorPrimaries	String	700	Le niveau de reconstruction des couleurs.
AudioStreamList	Array of AudioStream		Les informations relatives à chaque flux audio.
AudioStream
Timebase	String	1/1000	La base de temps.
Index	String	1	Le numéro de séquence du flux audio. Cette valeur indique la position du flux audio parmi l'ensemble des flux audio.
SampleFmt	String	fltp	Le format d'échantillonnage.
ChannelLayout	String	5.1(side)	Le nombre de canaux audio.
Lang	String	eng	La langue. Pour plus d'informations, consultez la section 21.20.1 Metadata de la documentation FFmpeg.
Samplerate	String	48000	La fréquence d'échantillonnage.
CodecLongName	String	DCA (DTS Coherent Acoustics)	Le nom complet du format d'encodage.
Channels	String	2	La disposition de sortie des canaux audio.
NumFrames	String	123	Le nombre total d'images.
Bitrate	String	1536000	Le débit binaire.
CodecTagString	String	[0][0][0][0]	La chaîne de tag du format d'encodage.
StartTime	String	0.042000	L'heure de début.
CodecName	String	acc	Le nom court du format d'encodage. Valeurs valides : acc mp3 mp4 ogg flac
Duration	String	123	La durée.
CodecTag	String	0x0000	Le tag du format d'encodage.
CodecTimeBase	String	1/48000	La base de temps du codec.
SubtitleStreamList	Array of SubtitleStream		Les informations relatives à chaque flux de sous-titres.
SubtitleStream
Timebase	String	1/1000	La base de temps.
Index	String	3	Le numéro de séquence du flux de sous-titres. Cette valeur indique la position du flux de sous-titres parmi l'ensemble des flux de sous-titres.
StartTime	String	0.000000	L'heure de début.
CodecName	String	ass	Le nom court du format d'encodage. Valeurs valides : srt ass
Lang	String	eng	La langue.
CodecLongName	String	ASS (Advanced SSA) subtitle	Le nom complet du format d'encodage.
Duration	String	1370.116000	La durée. Unité : secondes.
CodecTag	String	0x0000	Le tag du format d'encodage.
CodecTimeBase	String	0/1	La base de temps du codec.
CodecTagString	String	[0][0][0][0]	La chaîne de tag du format d'encodage.
Format	Object		Les informations sur le format.
StartTime	String	0.042000	L'heure de début.
NumPrograms	String	2	Le nombre total de flux de programme.
Size	String	3509895	La taille du fichier.
NumStreams	String	1	Le nombre total de flux multimédias.
FormatLongName	String	QuickTime/MOV	Le nom complet du format conteneur.
Duration	String	17.226000	La durée totale.
Bitrate	String	1630.045	Le débit binaire total.
FormatName	String	mov	Le nom court du format conteneur.
FileSize	String	3509895	La taille du fichier.

Paramètres de rappel

Lorsque le statut d'une tâche d'analyse des informations multimédias change, MPS envoie un message à la file d'attente MNS spécifiée. Pour plus d'informations sur la configuration d'une file d'attente MNS pour recevoir les rappels, consultez la rubrique UpdatePipeline. Le message de rappel est une chaîne JSON contenant les paramètres décrits dans le tableau suivant.


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

Paramètre

Type

Description

Type

String

La valeur est fixée à MediaInfo, ce qui indique une tâche d'analyse des informations multimédias.

JobId

String

L'ID unique de la tâche.

State

String

Le statut actuel de la tâche. La valeur est identique à celle du paramètre State renvoyé par l'opération QueryMediaInfoJobList.

UserData

String

Les données utilisateur spécifiées pour la tâche lors de l'opération SubmitMediaInfoJob.

Exemples

Exemple de requête

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

Exemple de réponses réussies

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs.