QueryMediaListByURL - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Cette opération permet d'interroger jusqu'à 10 fichiers multimédias simultanément.
Avant d'appeler cette opération, utilisez l'opération AddMedia pour ajouter les fichiers multimédias.
Cette opération interroge uniquement les fichiers multimédias traités par un workflow. Pour obtenir des informations complètes sur un fichier multimédia nouvellement transféré vers OSS, appelez cette opération une fois le workflow correspondant terminé. Pour interroger des fichiers multimédias non traités par un workflow, appelez l'opération SubmitMediaInfoJob afin de soumettre une tâche d'analyse des métadonnées multimédias. Une fois la tâche terminée, consultez les informations relatives aux fichiers multimédias.

Limite QPS

Vous pouvez appeler cette API jusqu'à 100 fois par seconde et par compte. Si le nombre d'appels par seconde dépasse cette limite, un mécanisme de limitation du débit (throttling) se déclenche, ce qui peut affecter votre activité. Tenez compte de cette limite 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 la signature. Par souci de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer 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
Action	String	Oui	QueryMediaListByURL	Opération à exécuter. Définissez la valeur sur QueryMediaListByURL.
FileURLs	String	Oui	http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example.mp4	URL OSS des fichiers multimédias. Pour obtenir l'URL OSS d'un fichier multimédia, procédez comme suit dans la console ApsaraVideo Media Processing (MPS) : dans le volet de navigation de gauche, choisissez Media Management > Media List. Recherchez le fichier multimédia dont vous souhaitez afficher l'URL OSS, puis cliquez sur Manage dans la colonne Actions. L'URL OSS du fichier multimédia s'affiche dans l'onglet Obtain Encoding URL. Séparez plusieurs URL par des virgules (,). Vous pouvez interroger jusqu'à 10 fichiers multimédias à la fois. L'URL est conforme à la norme RFC 3986 et encodée en UTF-8, avec un encodage en pourcentage des caractères réservés. La taille de la valeur peut atteindre 3 200 octets. Pour plus d'informations, consultez la section Encodage d'URL. Seules les URL HTTP OSS sont prises en charge. Les URL Alibaba Cloud CDN et les URL HTTPS ne sont pas prises en charge.
IncludePlayList	Boolean	Non	true	Indique si les informations de lecture doivent être incluses dans le résultat renvoyé. Valeurs valides : true et false. Valeur par défaut : false.
IncludeSnapshotList	Boolean	Non	true	Indique si les informations de capture d'écran doivent être incluses dans le résultat renvoyé. Valeurs valides : true et false. Valeur par défaut : false.
IncludeMediaInfo	Boolean	Non	true	Indique si les informations multimédias doivent être incluses dans le résultat renvoyé. Valeurs valides : true et false. Valeur par défaut : false. Remarque Pour obtenir des informations détaillées sur les fichiers multimédias, définissez ce paramètre sur true.
IncludeSummaryList	Boolean	Non	true	Indique si les résumés doivent être inclus dans le résultat renvoyé. Valeurs valides : true et false. Valeur par défaut : false.

Paramètres de réponse

Paramètre	Type	Exemple	Description
MediaList	Array of Media		Liste des fichiers multimédias.
Media
CreationTime	String	2021-07-14T13:05:00Z	Date de création du fichier multimédia.
CateId	Long	123	ID de la catégorie à laquelle appartient le fichier multimédia.
Height	String	360	Hauteur du fichier multimédia interrogé.
CensorState	String	Initiated	Statut de modération du fichier multimédia. Valeurs valides : Initiated : le fichier multimédia est transféré mais n'a pas été modéré. Pass : le fichier multimédia est transféré et a passé la modération avec succès.
Tags	Array of String	tag1,tag2	Tags du fichier multimédia.
PlayList	Array of Play		Liste de lecture.
Play
Encryption	String	1	Indique si le fichier multimédia est chiffré. Valeurs valides : 0 : le fichier multimédia n'est pas chiffré. 1 : le fichier multimédia est chiffré.
Height	String	10	Hauteur du fichier multimédia.
Bitrate	String	25.067	Débit binaire du fichier multimédia.
File	Object		Fichier de lecture.
State	String	Normal	Statut du fichier multimédia. Valeurs valides : Normal : le fichier est normal. Deleted : le fichier est supprimé.
URL	String	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4l-test/in/1.mp4	URL OSS du fichier de lecture.
MediaWorkflowId	String	6cc3aa66d1cb4bb2adf14e726c0a****	ID du workflow qui génère le fichier de lecture.
Width	String	11	Largeur.
Size	String	100	Taille.
Fps	String	25.0	Fréquence d'images.
Duration	String	7.965000	Durée.
ActivityName	String	test name	Nom de l'activité de workflow.
Format	String	mov	Format d'encodage du fichier multimédia. Valeurs valides : mov, mp4, m4a, 3gp, 3g2 et mj2.
MediaWorkflowName	String	example-mediaworkflow-****	Nom du workflow qui génère le fichier de lecture.
Bitrate	String	593.192	Débit binaire.
MediaId	String	52d7e98b05e648199612290bb819****	ID du fichier multimédia.
File	Object		Détails du fichier d'entrée.
State	String	Normal	Statut du fichier multimédia. Valeurs valides : Normal : le fichier est normal. Deleted : le fichier est supprimé.
URL	String	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4	URL OSS du fichier d'entrée.
SummaryList	Array of Summary		Liste des résumés vidéo.
Summary
Type	String	Gif	Type de résumé. Valeurs valides : Video : vidéo Gif : image animée
MediaWorkflowId	String	93ab850b4f6f44eab54b6e91d24d****	ID du workflow qui génère le résumé.
ActivityName	String	example-activity-****	Nom de l'activité de workflow.
MediaWorkflowName	String	example-mediaworkflow-****	Nom du workflow qui génère le résumé.
File	Object		Informations sur le fichier d'entrée.
State	String	Normal	Statut du fichier multimédia. Valeurs valides : Normal : le fichier est normal. Deleted : le fichier est supprimé.
URL	String	http://example-bucket-****.o	URL OSS du fichier d'entrée.
PublishState	String	Published	Statut de publication du fichier multimédia. Valeurs valides : Initiated : le fichier multimédia est dans l'état initial. UnPublish : le fichier multimédia n'a pas été publié et l'autorisation de lecture sur l'objet OSS est définie sur Private. Published : le fichier multimédia a été publié et l'autorisation de lecture sur l'objet OSS est définie sur Default. Deleted : le fichier est supprimé.
MediaInfo	Object		Informations multimédias.
Streams	Object		Informations sur les flux.
VideoStreamList	Array of VideoStream		Liste des flux vidéo.
VideoStream
Sar	String	1:1	Ratio d'aspect de l'échantillon (SAR).
Height	String	360	Deuxième nombre de la résolution vidéo. Ce nombre indique la hauteur de la vidéo.
CodecTagString	String	avc1	Chaîne de tag du format d'encodage.
NetworkCost	Object		Consommation de bande passante réseau.
PreloadTime	String	0.01	Quantité de temps de préchargement.
AvgBitrate	String	2659.326	Débit binaire moyen du flux vidéo.
CostBandwidth	String	100	Bande passante maximale consommée.
Width	String	640	Premier nombre de la résolution vidéo. Ce nombre indique la largeur de la vidéo et ne peut pas être négatif.
Index	String	5	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/15360	Base de temps.
AvgFPS	String	15.0	Fréquence d'images moyenne.
PixFmt	String	yuv420p	Format de pixel du flux vidéo.
Lang	String	und	Langue. Pour plus d'informations, consultez la documentation FFmpeg.
CodecLongName	String	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10	Nom complet du format d'encodage.
NumFrames	String	12	Nombre total d'images.
Rotate	String	90	Angle de rotation de la vidéo.
Bitrate	String	512.701	Débit binaire.
HasBFrames	String	2	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 2 indique que le flux vidéo ne contient pas d'images B.
Profile	String	High	Profil du codec.
StartTime	String	0.046029	Heure de début.
Dar	String	16:9	Ratio d'aspect d'affichage (DAR) du flux vidéo.
CodecName	String	H264	Nom court du format d'encodage. Valeurs valides : H264, mov, aac, avc et mpeg.
Duration	String	79.200000	Durée.
Fps	String	15.0	Fréquence d'images.
CodecTag	String	0x31637661	Tag du format d'encodage.
CodecTimeBase	String	1/30	Base de temps du codec.
Level	String	31	Niveau du codec.
AudioStreamList	Array of AudioStream		Liste des flux audio.
AudioStream
Timebase	String	1/44100	Base de temps.
Index	String	1	Numéro de séquence du flux audio. La 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	und	Langue. Pour plus d'informations, consultez la définition de la langue FFmpeg.
Samplerate	String	44100	Taux d'échantillonnage.
CodecLongName	String	AAC (Advanced Audio Coding)	Nom complet du format d'encodage.
Channels	String	2	Nombre de canaux sonores.
NumFrames	String	100	Nombre total d'images.
Bitrate	String	76.356	Débit binaire.
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. Valeurs valides : H264, mov, aac, avc et mpeg.
Duration	String	79.203265	Durée du fichier multimédia.
CodecTag	String	0x6134706d	Tag du format d'encodage.
CodecTimeBase	String	1/44100	Base de temps du codec.
SubtitleStreamList	Array of SubtitleStream		Liste des flux de sous-titres.
SubtitleStream
Index	String	1	Numéro de séquence du flux de sous-titres. La valeur indique la position du flux de sous-titres parmi tous les flux de sous-titres.
Lang	String	und	Langue. Pour plus d'informations, consultez la définition de la langue FFmpeg.
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	5872904	Taille.
NumStreams	String	2	Nombre total de flux multimédias.
FormatLongName	String	QuickTime/MOV	Nom complet du format d'encodage.
Duration	String	79.204000	Durée.
Bitrate	String	593.192	Débit binaire.
FormatName	String	mov	Nom court du format de conteneur. Valeurs valides : mov, mp4, m4a, 3gp, 3g2 et mj2.
Description	String	This is description ****	Description.
Size	String	5872904	Taille du fichier.
Width	String	640	Largeur.
CoverURL	String	http://example-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example-**.png	URL OSS de la vignette.
SnapshotList	Array of Snapshot		Liste des captures d'écran.
Snapshot
Type	String	Single	Type de capture d'écran. Valeurs valides : Single : capture d'écran unique Sequence : captures d'écran en séquence
MediaWorkflowId	String	6cc3aa66d1cb4bb2adf14e726c0a****	ID du workflow qui génère la capture d'écran.
ActivityName	String	example-activity1-****	Nom de l'activité de workflow qui génère la capture d'écran.
Count	String	3	Nombre de captures d'écran. Ce paramètre n'est valide que lorsque la valeur du paramètre Type est Sequence.
MediaWorkflowName	String	example-workflow-****	Nom du workflow qui génère la capture d'écran.
File	Object		Capture d'écran.
State	String	Normal	Statut du fichier. Valeurs valides : Normal : le fichier est normal. Deleted : le fichier est supprimé.
URL	String	http://example1-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example111-**.png	URL OSS de la capture d'écran.
RunIdList	Array of String	9343bd0e7bb54ae19228529908e5****	ID des instances d'exécution de workflow multimédia.
Duration	String	79.204000	Durée.
Fps	String	15.0	Fréquence d'images.
Title	String	kled.mp4	Titre.
Format	String	mov	Format d'encodage. Valeurs valides : mov, mp4, m4a, 3gp, 3g2 et mj2.
NonExistFileURLs	Array of String	null	URL des fichiers multimédias qui n'existent pas. Ce paramètre n'est pas renvoyé si tous les fichiers multimédias spécifiés existent.
RequestId	String	1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42	ID de la requête.

Exemples

Exemple de requête

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=QueryMediaListByURL
&FileURLs=http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example.mp4
&IncludePlayList=true
&IncludeSnapshotList=true
&IncludeMediaInfo=true
&IncludeSummaryList=true
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<QueryMediaListByURLResponse>
    <MediaList>
        <CreationTime>2021-07-14T13:05:00Z</CreationTime>
        <CateId>123</CateId>
        <Height>360</Height>
        <CensorState>Initiated</CensorState>
        <Tags>tag1,tag2</Tags>
        <PlayList>
            <Encryption>1</Encryption>
            <Height>10</Height>
            <Bitrate>25.067</Bitrate>
            <File>
                <State>Normal</State>
                <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4l-test/in/1.mp4</URL>
            </File>
            <MediaWorkflowId>6cc3aa66d1cb4bb2adf14e726c0a****</MediaWorkflowId>
            <Width>11</Width>
            <Size>100</Size>
            <Fps>25.0</Fps>
            <Duration>7.965000</Duration>
            <ActivityName>test name</ActivityName>
            <Format>mov</Format>
            <MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
        </PlayList>
        <Bitrate>593.192</Bitrate>
        <MediaId>52d7e98b05e648199612290bb819****</MediaId>
        <File>
            <State>Normal</State>
            <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
        </File>
        <SummaryList>
            <Type>Gif</Type>
            <MediaWorkflowId>93ab850b4f6f44eab54b6e91d24d****</MediaWorkflowId>
            <ActivityName>example-activity-****</ActivityName>
            <MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
            <File>
                <State>Normal</State>
                <URL>http://example-bucket-****.o</URL>
            </File>
        </SummaryList>
        <PublishState>Published</PublishState>
        <MediaInfo>
            <Streams>
                <VideoStreamList>
                    <Sar>1:1</Sar>
                    <Height>360</Height>
                    <CodecTagString>avc1</CodecTagString>
                    <NetworkCost>
                        <PreloadTime>0.01</PreloadTime>
                        <AvgBitrate>2659.326</AvgBitrate>
                        <CostBandwidth>100</CostBandwidth>
                    </NetworkCost>
                    <Width>640</Width>
                    <Index>5</Index>
                    <Timebase>1/15360</Timebase>
                    <AvgFPS>15.0</AvgFPS>
                    <PixFmt>yuv420p</PixFmt>
                    <Lang>und</Lang>
                    <CodecLongName>H.264/AVC/MPEG-4 AVC/MPEG-4 part 10</CodecLongName>
                    <NumFrames>12</NumFrames>
                    <Rotate>90</Rotate>
                    <Bitrate>512.701</Bitrate>
                    <HasBFrames>2</HasBFrames>
                    <Profile>High</Profile>
                    <StartTime>0.046029</StartTime>
                    <Dar>16:9</Dar>
                    <CodecName>H264</CodecName>
                    <Duration>79.200000</Duration>
                    <Fps>15.0</Fps>
                    <CodecTag>0x31637661</CodecTag>
                    <CodecTimeBase>1/30</CodecTimeBase>
                    <Level>31</Level>
                </VideoStreamList>
                <AudioStreamList>
                    <Timebase>1/44100</Timebase>
                    <Index>1</Index>
                    <SampleFmt>fltp</SampleFmt>
                    <ChannelLayout>stereo</ChannelLayout>
                    <Lang>und</Lang>
                    <Samplerate>44100</Samplerate>
                    <CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
                    <Channels>2</Channels>
                    <NumFrames>100</NumFrames>
                    <Bitrate>76.356</Bitrate>
                    <CodecTagString>mp4a</CodecTagString>
                    <StartTime>0.000000</StartTime>
                    <CodecName>aac</CodecName>
                    <Duration>79.203265</Duration>
                    <CodecTag>0x6134706d</CodecTag>
                    <CodecTimeBase>1/44100</CodecTimeBase>
                </AudioStreamList>
                <SubtitleStreamList>
                    <Index>1</Index>
                    <Lang>und</Lang>
                </SubtitleStreamList>
            </Streams>
            <Format>
                <StartTime>0.000000</StartTime>
                <NumPrograms>0</NumPrograms>
                <Size>5872904</Size>
                <NumStreams>2</NumStreams>
                <FormatLongName>QuickTime/MOV</FormatLongName>
                <Duration>79.204000</Duration>
                <Bitrate>593.192</Bitrate>
                <FormatName>mov</FormatName>
            </Format>
        </MediaInfo>
        <Description>This is description ****</Description>
        <Size>5872904</Size>
        <Width>640</Width>
        <CoverURL>http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png</CoverURL>
        <SnapshotList>
            <Type>Single</Type>
            <MediaWorkflowId>6cc3aa66d1cb4bb2adf14e726c0a****</MediaWorkflowId>
            <ActivityName>example-activity1-****</ActivityName>
            <Count>3</Count>
            <MediaWorkflowName>example-workflow-****</MediaWorkflowName>
            <File>
                <State>Normal</State>
                <URL>http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png</URL>
            </File>
        </SnapshotList>
        <RunIdList>9343bd0e7bb54ae19228529908e5****</RunIdList>
        <Duration>79.204000</Duration>
        <Fps>15.0</Fps>
        <Title>kled.mp4</Title>
        <Format>mov</Format>
    </MediaList>
    <NonExistFileURLs>null</NonExistFileURLs>
    <RequestId>1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42</RequestId>
</QueryMediaListByURLResponse>

JSON format

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

{
  "MediaList" : [ {
    "CreationTime" : "2021-07-14T13:05:00Z",
    "CateId" : 123,
    "Height" : "360",
    "CensorState" : "Initiated",
    "Tags" : [ "tag1,tag2" ],
    "PlayList" : [ {
      "Encryption" : "1",
      "Height" : "10",
      "Bitrate" : "25.067",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4l-test/in/1.mp4"
      },
      "MediaWorkflowId" : "6cc3aa66d1cb4bb2adf14e726c0a****",
      "Width" : "11",
      "Size" : "100",
      "Fps" : "25.0",
      "Duration" : "7.965000",
      "ActivityName" : "test name",
      "Format" : "mov",
      "MediaWorkflowName" : "example-mediaworkflow-****"
    } ],
    "Bitrate" : "593.192",
    "MediaId" : "52d7e98b05e648199612290bb819****",
    "File" : {
      "State" : "Normal",
      "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
    },
    "SummaryList" : [ {
      "Type" : "Gif",
      "MediaWorkflowId" : "93ab850b4f6f44eab54b6e91d24d****",
      "ActivityName" : "example-activity-****",
      "MediaWorkflowName" : "example-mediaworkflow-****",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example-bucket-****.o"
      }
    } ],
    "PublishState" : "Published",
    "MediaInfo" : {
      "Streams" : {
        "VideoStreamList" : [ {
          "Sar" : "1:1",
          "Height" : "360",
          "CodecTagString" : "avc1",
          "NetworkCost" : {
            "PreloadTime" : "0.01",
            "AvgBitrate" : "2659.326",
            "CostBandwidth" : "100"
          },
          "Width" : "640",
          "Index" : "5",
          "Timebase" : "1/15360",
          "AvgFPS" : "15.0",
          "PixFmt" : "yuv420p",
          "Lang" : "und",
          "CodecLongName" : "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
          "NumFrames" : "12",
          "Rotate" : "90",
          "Bitrate" : "512.701",
          "HasBFrames" : "2",
          "Profile" : "High",
          "StartTime" : "0.046029",
          "Dar" : "16:9",
          "CodecName" : "H264",
          "Duration" : "79.200000",
          "Fps" : "15.0",
          "CodecTag" : "0x31637661",
          "CodecTimeBase" : "1/30",
          "Level" : "31"
        } ],
        "AudioStreamList" : [ {
          "Timebase" : "1/44100",
          "Index" : "1",
          "SampleFmt" : "fltp",
          "ChannelLayout" : "stereo",
          "Lang" : "und",
          "Samplerate" : "44100",
          "CodecLongName" : "AAC (Advanced Audio Coding)",
          "Channels" : "2",
          "NumFrames" : "100",
          "Bitrate" : "76.356",
          "CodecTagString" : "mp4a",
          "StartTime" : "0.000000",
          "CodecName" : "aac",
          "Duration" : "79.203265",
          "CodecTag" : "0x6134706d",
          "CodecTimeBase" : "1/44100"
        } ],
        "SubtitleStreamList" : [ {
          "Index" : "1",
          "Lang" : "und"
        } ]
      },
      "Format" : {
        "StartTime" : "0.000000",
        "NumPrograms" : "0",
        "Size" : "5872904",
        "NumStreams" : "2",
        "FormatLongName" : "QuickTime/MOV",
        "Duration" : "79.204000",
        "Bitrate" : "593.192",
        "FormatName" : "mov"
      }
    },
    "Description" : "This is description ****",
    "Size" : "5872904",
    "Width" : "640",
    "CoverURL" : "http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png",
    "SnapshotList" : [ {
      "Type" : "Single",
      "MediaWorkflowId" : "6cc3aa66d1cb4bb2adf14e726c0a****",
      "ActivityName" : "example-activity1-****",
      "Count" : "3",
      "MediaWorkflowName" : "example-workflow-****",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png"
      }
    } ],
    "RunIdList" : [ "9343bd0e7bb54ae19228529908e5****" ],
    "Duration" : "79.204000",
    "Fps" : "15.0",
    "Title" : "kled.mp4",
    "Format" : "mov"
  } ],
  "NonExistFileURLs" : [ "null" ],
  "RequestId" : "1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42"
}

Codes d'erreur

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