SubmitMediaInfoJob - - Centre de documentation Alibaba Cloud

Description

Lorsque vous appelez l'opération SubmitMediaInfoJob, ApsaraVideo Media Processing (MPS) analyse le fichier multimédia d'entrée et génère les résultats de l'analyse. Appelez l'opération QueryMediaInfoJobList pour consulter ces résultats.

Remarque

Nous vous recommandons de soumettre une tâche d'analyse des informations multimédias uniquement après avoir confirmé que le fichier a bien été téléchargé vers Object Storage Service (OSS). Configurez des callbacks de téléchargement pour être notifié de l'état du transfert des fichiers.

Limite QPS

Vous pouvez appeler cette opération jusqu'à 50 fois par seconde par compte. Les requêtes dépassant cette limite sont rejetées, ce qui entraîne des interruptions de service. Tenez compte de cette limitation lors de l'appel à cette opération. Pour plus d'informations, consultez la rubrique Limite QPS.

Débogage

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

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	SubmitMediaInfoJob	Opération à effectuer. Définissez la valeur sur SubmitMediaInfoJob.
Input	String	Yes	{"Bucket":"example-bucket","Location":"example-location","Object":"example%2Fexample.flv"}	Informations relatives au fichier multimédia d'entrée. La valeur est une chaîne JSON. Accordez à MPS les autorisations d'accès au bucket OSS contenant le fichier multimédia d'entrée. Pour ce faire, connectez-vous à la MPS console, puis choisissez Workflows > Media Buckets dans le volet de navigation de gauche et cliquez sur Add Bucket. Ensuite, encodez l'objet sous forme d'URL. Par exemple, `{"Bucket":"example-bucket","Location":"example-location","Object":"example%2Fexample.flv"}` indique le fichier `example-bucket.example-location.aliyuncs.com/example/example.flv`. Remarque Le bucket OSS doit se trouver dans la région où vous utilisez MPS.
UserData	String	No	testid-001	Données personnalisées. Ces données peuvent contenir des lettres, des chiffres et des traits d'union (-), et leur longueur ne doit pas dépasser 1 024 octets. Elles ne doivent pas commencer par un trait d'union (-).
PipelineId	String	No	88c6ca184c0e432bbf5b665e2a15****	ID de la file d'attente MPS à laquelle la tâche d'analyse est soumise. Pour afficher l'ID de la file d'attente MPS, connectez-vous à la MPS console et choisissez Global Settings > Pipelines dans le volet de navigation de gauche.
Async	Boolean	No	true	Indique si le mode asynchrone est activé pour la tâche. Nous vous recommandons de définir ce paramètre sur true. Valeurs valides : true : active le mode asynchrone. false : n'active pas le mode asynchrone.

Paramètres de réponse

Parameter	Type	Example	Description
MediaInfoJob	Object		Détails de la tâche d'analyse des informations multimédias.
CreationTime	String	2014-01-10T12:00:00Z	Date et heure de création de la tâche.
State	String	Analyzing	Statut de la tâche. Valeurs valides : Success : la tâche a abouti. Fail : la tâche a échoué. Analyzing : la tâche est en cours d'exécution.
JobId	String	23ca1d184c0e4341e5b665e2a12****	ID de la tâche.
UserData	String	testid-001	Données personnalisées.
Code	String	InvalidParameter.JsonObjectFormatInvalid	Code d'erreur renvoyé en cas d'échec de la tâche.
Message	String	The parameter "*" does not conform to the JSON Object specification	Message d'erreur renvoyé en cas d'échec de la tâche.
PipelineId	String	88c6ca184c0e432bbf5b665e2a15****	ID de la file d'attente MPS à laquelle la tâche d'analyse est soumise.
Async	Boolean	true	Indique si la tâche est exécutée en mode asynchrone.
Input	Object		Informations relatives au fichier multimédia d'entrée.
Object	String	example.flv	Nom de l'objet OSS utilisé comme fichier multimédia d'entrée.
Location	String	example-location	Région du bucket OSS dans lequel le fichier multimédia d'entrée est stocké.
Bucket	String	example-bucket	Nom du bucket OSS dans lequel le fichier multimédia d'entrée est stocké.
MNSMessageResult	Object		Détails du message envoyé à Message Service (MNS) pour notifier les utilisateurs du résultat de la tâche.
MessageId	String	16f01ad6175e4230ac42bb5182cd****	ID du message renvoyé en cas de succès de la tâche. Ce paramètre n'est pas renvoyé en cas d'échec.
ErrorMessage	String	InvalidParameter.JsonObjectFormatInvalid	Message d'erreur renvoyé en cas d'échec de la tâche. Ce paramètre n'est pas renvoyé en cas de succès.
ErrorCode	String	The parameter \"Input\" does not conform to the JSON Object specification	Code d'erreur renvoyé en cas d'échec de la tâche. Ce paramètre n'est pas renvoyé en cas de succès.
Properties	Object		Propriétés du fichier multimédia d'entrée.
Width	String	1920	Largeur de la vidéo. Unité : pixels.
Height	String	1080	Hauteur de la vidéo. Unité : pixels.
Duration	String	17.226000	Durée totale du fichier multimédia d'entrée. Unité : secondes.
Fps	String	25	Fréquence d'images.
Bitrate	String	1630.045	Débit binaire. Unité : Kbit/s.
FileFormat	String	QuickTime/MOV	Format du fichier multimédia d'entrée.
Streams	Object		Flux multimédias contenus dans le fichier multimédia d'entrée.
VideoStreamList	Array of VideoStream		Flux vidéo. Un fichier multimédia peut contenir jusqu'à quatre flux vidéo.
VideoStream
Sar	String	1:1	Ratio d'aspect d'échantillonnage (SAR).
Height	String	1080	Hauteur de la vidéo. Unité : pixels.
CodecTagString	String	avc1	Chaîne de tag du format d'encodage.
NetworkCost	Object		Bande passante réseau consommée.
PreloadTime	String	8	Temps de préchargement de la vidéo.
AvgBitrate	String	300.34	Débit binaire moyen. Unité : Kbit/s.
CostBandwidth	String	10	Bande passante maximale consommée.
Width	String	1920	Largeur de la vidéo. Unité : pixels.
Index	String	1	Numéro de séquence du flux vidéo. Cette valeur indique la position du flux vidéo parmi tous les flux vidéo. Le numéro de séquence du premier flux vidéo à lire peut être spécifié dans certains lecteurs. Valeur par défaut : 1.
Timebase	String	1/24000	Base de temps.
AvgFPS	String	23.976025	Fréquence d'images moyenne.
PixFmt	String	yuv420p	Format de pixel.
Lang	String	eng	Langue.
CodecLongName	String	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10	Nom complet du format d'encodage.
NumFrames	String	100	Nombre total d'images.
Rotate	String	90	Angle de rotation de la vidéo.
Bitrate	String	1496.46	Débit binaire. Unité : Kbit/s.
HasBFrames	String	0	Indique si le flux vidéo contient des images bidirectionnelles (B-frames). Une valeur de 1 signifie que le flux contient des B-frames. Une valeur de 0 signifie qu'il n'en contient pas.
Profile	String	High	Profil du codec.
StartTime	String	0.042000	Heure de début.
Dar	String	16:9	Ratio d'aspect d'affichage (DAR). Le DAR représente la relation proportionnelle entre la largeur et la hauteur d'une vidéo. Cette valeur permet de déterminer si la vidéo est en mode portrait ou paysage.
CodecName	String	h264	Nom court du format d'encodage. Valeurs valides : h264 h265 gif webp
Duration	String	17.225542	Durée. Unité : secondes.
Fps	String	25	Fréquence d'images.
CodecTag	String	0x31637661	Tag du format d'encodage.
CodecTimeBase	String	1001/48000	Base de temps du codec.
Level	String	41	Niveau du codec.
ColorRange	String	700	Plage de couleurs.
ColorTransfer	String	R255 G83 B170	Canal de couleur.
ColorPrimaries	String	700	Niveau de reconstruction des couleurs.
AudioStreamList	Array of AudioStream		Flux audio. Un fichier multimédia peut contenir jusqu'à quatre flux audio.
AudioStream
Timebase	String	1/44100	Base de temps.
Index	String	1	Numéro de séquence du flux audio. Cette valeur indique la position du flux audio parmi tous les flux audio.
SampleFmt	String	fltp	Format d'échantillonnage.
ChannelLayout	String	stereo	Disposition de sortie des canaux sonores.
Lang	String	eng	Langue.
Samplerate	String	44100	Fréquence d'échantillonnage. Unité : Hz.
CodecLongName	String	AAC (Advanced Audio Coding)	Nom complet du format d'encodage.
Channels	String	2	Nombre de canaux sonores.
NumFrames	String	123	Nombre total d'images.
Bitrate	String	128.806	Débit binaire. Unité : Kbit/s.
CodecTagString	String	mp4a	Chaîne de tag du format d'encodage.
StartTime	String	0.000000	Heure de début.
CodecName	String	aac	Nom court du format d'encodage. Valeur par défaut : acc. Valeurs valides : acc mp3 mp4 ogg flac
Duration	String	17.159546	Durée. Unité : secondes.
CodecTag	String	0x6134706d	Tag du format d'encodage.
CodecTimeBase	String	1/44100	Base de temps du codec.
SubtitleStreamList	Array of SubtitleStream		Flux de sous-titres. Un fichier multimédia peut contenir jusqu'à quatre flux de sous-titres.
SubtitleStream
Timebase	String	1/1000	Base de temps.
Index	String	3	Numéro de séquence du flux de sous-titres. Cette valeur indique la position du flux de sous-titres parmi tous les flux de sous-titres.
StartTime	String	0.000000	Heure de début.
CodecName	String	ass	Nom court du format d'encodage. Valeurs valides : srt ass
Lang	String	eng	Langue.
CodecLongName	String	ASS (Advanced SSA) subtitle	Nom complet du format d'encodage.
Duration	String	1370.116000	Durée. Unité : secondes.
CodecTag	String	0x0000	Tag du format d'encodage.
CodecTimeBase	String	0/1	Base de temps du codec.
CodecTagString	String	[0][0][0][0]	Chaîne de tag du format d'encodage.
Format	Object		Informations sur le format.
StartTime	String	0.000000	Heure de début.
NumPrograms	String	0	Nombre total de flux de programmes.
Size	String	3509895	Taille du fichier. Unité : octets.
NumStreams	String	2	Nombre total de flux multimédias.
FormatLongName	String	QuickTime/MOV	Nom complet du format conteneur.
Duration	String	17.226000	Durée totale du fichier multimédia d'entrée. Unité : secondes.
Bitrate	String	1630.045	Débit binaire total. Unité : Kbit/s.
FormatName	String	mov	Nom court du format conteneur. Pour plus d'informations sur les paramètres, consultez les Détails des paramètres.
FileSize	String	3509895	Taille du fichier. Unité : octets.
RequestId	String	62D9BE16-B7D5-550C-A482-7A0F60E09877	ID de la requête. Remarque Si une erreur de requête se produit, vérifiez la validité du fichier multimédia d'entrée. Si le fichier est valide mais que le problème persiste, pour contacter le service client Alibaba Cloud.

Exemples

Exemple de requête

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>

Exemple de réponse réussie

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.