QueryMediaList - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Vous pouvez interroger jusqu'à 10 fichiers multimédias à la fois avec cette opération.

Limite QPS

Chaque compte peut appeler cette opération jusqu'à 100 fois par seconde. Si le nombre d'appels par seconde dépasse cette limite, un mécanisme de limitation du débit (throttling) est déclenché, ce qui peut affecter votre activité. Nous vous recommandons de prendre en compte cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez les Limites QPS .

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de 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

Parameter	Type	Required	Example	Description
Action	String	Yes	QueryMediaList	L'opération que vous souhaitez effectuer. Définissez la valeur sur QueryMediaList.
MediaIds	String	Yes	3e1cd21131a94525be55acf65888**,e26cfa29e784402388463f61dbec**	Les identifiants des fichiers multimédias. Pour obtenir l'identifiant 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 la vidéo souhaitée et cliquez sur Manage. L'identifiant de la vidéo s'affiche dans l'onglet Basics. Séparez plusieurs identifiants par des virgules (,). Vous pouvez interroger jusqu'à 10 fichiers multimédias à la fois.
IncludePlayList	Boolean	No	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	No	true	Indique si les informations de capture d'écran (snapshot) doivent être incluses dans le résultat renvoyé. Valeurs valides : true et false. Valeur par défaut : false.
IncludeMediaInfo	Boolean	No	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.
IncludeSummaryList	Boolean	No	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

Parameter	Type	Example	Description
NonExistMediaIds	Array of String	{"MediaId":[e26cfa29e784402388463f61dbec****]}	Les identifiants des fichiers multimédias introuvables. Ce paramètre n'est pas renvoyé lorsque tous les fichiers multimédias spécifiés existent.
MediaList	Array of Media		La liste des fichiers multimédias.
Media
CreationTime	String	2016-09-14T08:30:33Z	L'heure de création du fichier multimédia.
CateId	Long	1	L'identifiant de la catégorie à laquelle appartient le fichier multimédia.
Height	String	1080	La hauteur du fichier multimédia.
CensorState	String	Initiated	Le statut de modération du fichier multimédia. Valeurs valides : Initiated : Le fichier multimédia est téléversé mais n'a pas encore été modéré. Pass : Le fichier multimédia est téléversé et a passé la modération avec succès.
Tags	Array of String	tag1,tag2	Les tags du fichier multimédia.
PlayList	Array of Play		La liste de lecture.
Play
Encryption	String	0	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	1080	La hauteur.
Bitrate	String	2659.326	Le débit binaire du fichier multimédia.
File	Object		Le fichier de lecture.
State	String	Normal	Le statut du fichier. Valeurs valides : Normal : normal Deleted : supprimé
URL	String	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4	L'URL Object Storage Service (OSS) du fichier de sortie.
MediaWorkflowId	String	93ab850b4f6f44eab54b6e91d24d****	L'identifiant du workflow qui génère le fichier de lecture.
Width	String	760	La largeur du fichier multimédia.
Size	String	2647692	La taille du fichier multimédia.
Fps	String	25.0	La fréquence d'images du fichier multimédia.
Duration	String	7.965000	La durée du fichier multimédia.
ActivityName	String	example-activity-****	Le nom de l'activité du workflow.
Format	String	mp4	Le format d'encodage du fichier multimédia. Valeurs valides : mov, mp4, m4a, 3gp, 3g2 et mj2.
MediaWorkflowName	String	example-mediaworkflow-****	Le nom du workflow qui génère le fichier de lecture.
Bitrate	String	2659.326	Le débit binaire.
MediaId	String	3e1cd21131a94525be55acf65888****	L'identifiant du fichier multimédia.
File	Object		Les détails du fichier d'entrée.
State	String	Normal	Le statut du fichier d'entrée. Valeurs valides : Normal : normal Deleted : supprimé
URL	String	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4	L'URL OSS du fichier d'entrée.
SummaryList	Array of Summary		La liste des résumés vidéo.
Summary
Type	String	Video	Le type de résumé. Valeurs valides : Video : vidéo Gif : image animée
MediaWorkflowId	String	93ab850b4f6f44eab54b6e91d24d****	L'identifiant du workflow qui génère le résumé.
ActivityName	String	example-activity-****	Le nom de l'activité du workflow.
MediaWorkflowName	String	example-mediaworkflow-****	Le nom du workflow qui génère le résumé.
File	Object		Les informations relatives au fichier d'entrée.
State	String	Normal	Le statut du fichier. Valeurs valides : Normal : normal Deleted : supprimé
URL	String	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4	L'URL OSS du fichier d'entrée.
PublishState	String	Published	Le statut de publication du fichier multimédia. Valeurs valides : Initiated : Le fichier multimédia est dans son é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 multimédia a été supprimé.
MediaInfo	Object		Les informations multimédias.
Streams	Object		Les informations de flux.
VideoStreamList	Array of VideoStream		La liste des flux vidéo.
VideoStream
Sar	String	1:1	Le rapport d'aspect d'échantillonnage (SAR).
Height	String	1080	Le second nombre de la résolution vidéo. Ce nombre indique la hauteur de la vidéo.
CodecTagString	String	avc1	La chaîne de tag du format d'encodage.
NetworkCost	Object		La consommation de bande passante réseau.
PreloadTime	String	0.01	Le temps de préchargement.
AvgBitrate	String	2659.326	Le débit binaire moyen.
CostBandwidth	String	100	La bande passante maximale consommée.
Width	String	100	Le premier nombre de la résolution vidéo. Ce nombre indique la largeur de la vidéo.
Index	String	5	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/30000	La base de temps.
AvgFPS	String	29.97003	La fréquence d'images moyenne.
PixFmt	String	yuv420p	Le format de pixel.
Lang	String	und	La langue. Pour plus d'informations, consultez la documentation FFmpeg.
CodecLongName	String	QuickTime/MOV	Le nom complet du format d'encodage.
NumFrames	String	12	Le nombre total d'images.
Rotate	String	90	L'angle de rotation de la vidéo.
Bitrate	String	2659.326	Le débit binaire.
HasBFrames	String	2	Indique si le flux vidéo contient des images bidirectionnelles (images B). Une valeur de 1 signifie que le flux vidéo contient des images B. Une valeur de 2 signifie qu'il n'en contient pas.
Profile	String	High	Le profil du codec.
StartTime	String	0.000000	L'heure de début.
Dar	String	16:9	Le rapport d'aspect à l'affichage (DAR).
CodecName	String	mov	Le nom court du format d'encodage. Valeurs valides : mov, mp4, m4a, 3gp, 3g2 et mj2.
Duration	String	182.683000	La durée.
Fps	String	29.97003	La fréquence d'images.
CodecTag	String	0x31637661	Le tag du format d'encodage.
CodecTimeBase	String	1001/60000	La base de temps du codec.
Level	String	40	Le niveau du codec.
AudioStreamList	Array of AudioStream		La liste des flux audio.
AudioStream
Timebase	String	1/44100	La base de temps.
Index	String	1	Le numéro de séquence du flux audio. La valeur indique la position du flux audio parmi tous les flux audio.
SampleFmt	String	fltp	Le format d'échantillonnage.
ChannelLayout	String	stereo	La disposition des canaux audio en sortie.
Lang	String	und	La langue. Pour plus d'informations, consultez la documentation FFmpeg.
Samplerate	String	44100	La fréquence d'échantillonnage.
CodecLongName	String	AAC(Advanced Audio Coding)	Le nom complet du format d'encodage.
Channels	String	2	Le nombre de canaux audio.
NumFrames	String	100	Le nombre total d'images.
Bitrate	String	160.008	Le débit binaire.
CodecTagString	String	mp4a	La chaîne de tag du format d'encodage.
StartTime	String	0.000000	L'heure de début.
CodecName	String	mov	Le nom court du format d'encodage. Valeurs valides : H264, mov, aac, avc et mpeg.
Duration	String	182.591995	La durée.
CodecTag	String	0x6134706d	Le tag du format d'encodage.
CodecTimeBase	String	1/44100	La base de temps du codec.
SubtitleStreamList	Array of SubtitleStream		La liste des flux de sous-titres.
SubtitleStream
Index	String	3	Le 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	La langue. Pour plus d'informations, consultez la documentation FFmpeg.
Format	Object		Les informations de format.
StartTime	String	0.000000	L'heure de début.
NumPrograms	String	2	Le nombre total de flux de programme.
Size	String	2647692	La taille du fichier.
NumStreams	String	2	Le nombre total de flux multimédias.
FormatLongName	String	QuickTime/MOV	Le nom complet du format conteneur.
Duration	String	7.965000	La durée totale.
Bitrate	String	2659.326	Le débit binaire.
FormatName	String	mov	Le nom court du format conteneur. Valeurs valides : mov, mp4, m4a, 3gp, 3g2 et mj2.
Description	String	This is description ****	La description.
Size	String	2647692	La taille du fichier.
Width	String	1920	La largeur.
CoverURL	String	http://example-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example-**.png	L'URL OSS de la vignette.
SnapshotList	Array of Snapshot		La liste des captures d'écran (snapshots).
Snapshot
Type	String	Sequence	Le type de capture d'écran. Valeurs valides : Single Sequence
MediaWorkflowId	String	6cc3aa66d1cb4bb2adf14e726c0a****	L'identifiant du workflow qui génère la capture d'écran.
ActivityName	String	example-activity1-****	Le nom de l'activité du workflow qui génère la capture d'écran.
Count	String	5	Le 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-****	Le nom du workflow qui génère la capture d'écran.
File	Object		La capture d'écran.
State	String	Normal	Le statut du fichier. Valeurs valides : Normal : normal Deleted : supprimé
URL	String	http://example1-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example111-**.png	L'URL OSS de la capture d'écran.
RunIdList	Array of String	null	L'identifiant de l'instance.
Duration	String	7.965000	La durée.
Fps	String	25.0	La fréquence d'images.
Title	String	example-title-****	Le titre.
Format	String	mov	Le format d'encodage. Valeurs valides : mov, mp4, m4a, 3gp, 3g2 et mj2.
RequestId	String	283DC68C-146F-4489-A2A1-2F88F1472A56	L'identifiant de la requête.

Exemples

Exemple de requête

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=AddMedia
&MediaIds=3e1cd21131a94525be55acf65888****,e26cfa29e784402388463f61dbec****
&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

<QueryMediaListResponse>
    <NonExistMediaIds>{"MediaId":[e26cfa29e784402388463f61dbec****]}</NonExistMediaIds>
    <MediaList>
        <CreationTime>2016-09-14T08:30:33Z</CreationTime>
        <CateId>1</CateId>
        <Height>1080</Height>
        <CensorState>Initiated</CensorState>
        <Tags>tag1,tag2</Tags>
        <PlayList>
            <Encryption>0</Encryption>
            <Height>1080</Height>
            <Bitrate>2659.326</Bitrate>
            <File>
                <State>Normal</State>
                <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
            </File>
            <MediaWorkflowId>93ab850b4f6f44eab54b6e91d24d****</MediaWorkflowId>
            <Width>760</Width>
            <Size>2647692</Size>
            <Fps>25.0</Fps>
            <Duration>7.965000</Duration>
            <ActivityName>example-activity-****</ActivityName>
            <Format>mp4</Format>
            <MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
        </PlayList>
        <Bitrate>2659.326</Bitrate>
        <MediaId>3e1cd21131a94525be55acf65888****</MediaId>
        <File>
            <State>Normal</State>
            <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
        </File>
        <SummaryList>
            <Type>Video</Type>
            <MediaWorkflowId>93ab850b4f6f44eab54b6e91d24d****</MediaWorkflowId>
            <ActivityName>example-activity-****</ActivityName>
            <MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
            <File>
                <State>Normal</State>
                <URL>http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
            </File>
        </SummaryList>
        <PublishState>Published</PublishState>
        <MediaInfo>
            <Streams>
                <VideoStreamList>
                    <Sar>1:1</Sar>
                    <Height>1080</Height>
                    <CodecTagString>avc1</CodecTagString>
                    <NetworkCost>
                        <PreloadTime>0.01</PreloadTime>
                        <AvgBitrate>2659.326</AvgBitrate>
                        <CostBandwidth>100</CostBandwidth>
                    </NetworkCost>
                    <Width>100</Width>
                    <Index>5</Index>
                    <Timebase>1/30000</Timebase>
                    <AvgFPS>29.97003</AvgFPS>
                    <PixFmt>yuv420p</PixFmt>
                    <Lang>und</Lang>
                    <CodecLongName>QuickTime/MOV</CodecLongName>
                    <NumFrames>12</NumFrames>
                    <Rotate>90</Rotate>
                    <Bitrate>2659.326</Bitrate>
                    <HasBFrames>2</HasBFrames>
                    <Profile>High</Profile>
                    <StartTime>0.000000</StartTime>
                    <Dar>16:9</Dar>
                    <CodecName>mov</CodecName>
                    <Duration>182.683000</Duration>
                    <Fps>29.97003</Fps>
                    <CodecTag>0x31637661</CodecTag>
                    <CodecTimeBase>1001/60000</CodecTimeBase>
                    <Level>40</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>160.008</Bitrate>
                    <CodecTagString>mp4a</CodecTagString>
                    <StartTime>0.000000</StartTime>
                    <CodecName>mov</CodecName>
                    <Duration>182.591995</Duration>
                    <CodecTag>0x6134706d</CodecTag>
                    <CodecTimeBase>1/44100</CodecTimeBase>
                </AudioStreamList>
                <SubtitleStreamList>
                    <Index>3</Index>
                    <Lang>und</Lang>
                </SubtitleStreamList>
            </Streams>
            <Format>
                <StartTime>0.000000</StartTime>
                <NumPrograms>2</NumPrograms>
                <Size>2647692</Size>
                <NumStreams>2</NumStreams>
                <FormatLongName>QuickTime/MOV</FormatLongName>
                <Duration>7.965000</Duration>
                <Bitrate>2659.326</Bitrate>
                <FormatName>mov</FormatName>
            </Format>
        </MediaInfo>
        <Description>This is descirption ****</Description>
        <Size>2647692</Size>
        <Width>1920</Width>
        <CoverURL>http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png</CoverURL>
        <SnapshotList>
            <Type>Sequence</Type>
            <MediaWorkflowId>6cc3aa66d1cb4bb2adf14e726c0a****</MediaWorkflowId>
            <ActivityName>example-activity1-****</ActivityName>
            <Count>5</Count>
            <MediaWorkflowName>example-workflow-****</MediaWorkflowName>
            <File>
                <State>Normal</State>
                <URL>http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png</URL>
            </File>
        </SnapshotList>
        <RunIdList>{"RunId":["47b42486019c4f688bf144c1a6ba****"]}</RunIdList>
        <Duration>7.965000</Duration>
        <Fps>25.0</Fps>
        <Title>example-title-****</Title>
        <Format>mov</Format>
    </MediaList>
    <RequestId>283DC68C-146F-4489-A2A1-2F88F1472A56</RequestId>
</QueryMediaListResponse>

JSON format

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

{
  "NonExistMediaIds" : [ "{\"MediaId\":[e26cfa29e784402388463f61dbec****]}" ],
  "MediaList" : [ {
    "CreationTime" : "2016-09-14T08:30:33Z",
    "CateId" : 1,
    "Height" : "1080",
    "CensorState" : "Initiated",
    "Tags" : [ "tag1,tag2" ],
    "PlayList" : [ {
      "Encryption" : "0",
      "Height" : "1080",
      "Bitrate" : "2659.326",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
      },
      "MediaWorkflowId" : "93ab850b4f6f44eab54b6e91d24d****",
      "Width" : "760",
      "Size" : "2647692",
      "Fps" : "25.0",
      "Duration" : "7.965000",
      "ActivityName" : "example-activity-****",
      "Format" : "mp4",
      "MediaWorkflowName" : "example-mediaworkflow-****"
    } ],
    "Bitrate" : "2659.326",
    "MediaId" : "3e1cd21131a94525be55acf65888****",
    "File" : {
      "State" : "Normal",
      "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
    },
    "SummaryList" : [ {
      "Type" : "Video",
      "MediaWorkflowId" : "93ab850b4f6f44eab54b6e91d24d****",
      "ActivityName" : "example-activity-****",
      "MediaWorkflowName" : "example-mediaworkflow-****",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
      }
    } ],
    "PublishState" : "Published",
    "MediaInfo" : {
      "Streams" : {
        "VideoStreamList" : [ {
          "Sar" : "1:1",
          "Height" : "1080",
          "CodecTagString" : "avc1",
          "NetworkCost" : {
            "PreloadTime" : "0.01",
            "AvgBitrate" : "2659.326",
            "CostBandwidth" : "100"
          },
          "Width" : "100",
          "Index" : "5",
          "Timebase" : "1/30000",
          "AvgFPS" : "29.97003",
          "PixFmt" : "yuv420p",
          "Lang" : "und",
          "CodecLongName" : "QuickTime/MOV",
          "NumFrames" : "12",
          "Rotate" : "90",
          "Bitrate" : "2659.326",
          "HasBFrames" : "2",
          "Profile" : "High",
          "StartTime" : "0.000000",
          "Dar" : "16:9",
          "CodecName" : "mov",
          "Duration" : "182.683000",
          "Fps" : "29.97003",
          "CodecTag" : "0x31637661",
          "CodecTimeBase" : "1001/60000",
          "Level" : "40"
        } ],
        "AudioStreamList" : [ {
          "Timebase" : "1/44100",
          "Index" : "1",
          "SampleFmt" : "fltp",
          "ChannelLayout" : "stereo",
          "Lang" : "und",
          "Samplerate" : "44100",
          "CodecLongName" : "AAC(Advanced Audio Coding)",
          "Channels" : "2",
          "NumFrames" : "100",
          "Bitrate" : "160.008",
          "CodecTagString" : "mp4a",
          "StartTime" : "0.000000",
          "CodecName" : "mov",
          "Duration" : "182.591995",
          "CodecTag" : "0x6134706d",
          "CodecTimeBase" : "1/44100"
        } ],
        "SubtitleStreamList" : [ {
          "Index" : "3",
          "Lang" : "und"
        } ]
      },
      "Format" : {
        "StartTime" : "0.000000",
        "NumPrograms" : "2",
        "Size" : "2647692",
        "NumStreams" : "2",
        "FormatLongName" : "QuickTime/MOV",
        "Duration" : "7.965000",
        "Bitrate" : "2659.326",
        "FormatName" : "mov"
      }
    },
    "Description" : "This is descirption ****",
    "Size" : "2647692",
    "Width" : "1920",
    "CoverURL" : "http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png",
    "SnapshotList" : [ {
      "Type" : "Sequence",
      "MediaWorkflowId" : "6cc3aa66d1cb4bb2adf14e726c0a****",
      "ActivityName" : "example-activity1-****",
      "Count" : "5",
      "MediaWorkflowName" : "example-workflow-****",
      "File" : {
        "State" : "Normal",
        "URL" : "http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png"
      }
    } ],
    "RunIdList" : [ "{\"RunId\":[\"47b42486019c4f688bf144c1a6ba****\"]}" ],
    "Duration" : "7.965000",
    "Fps" : "25.0",
    "Title" : "example-title-****",
    "Format" : "mov"
  } ],
  "RequestId" : "283DC68C-146F-4489-A2A1-2F88F1472A56"
}

Codes d'erreur

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