AddMedia - - Centre de documentation Alibaba Cloud

Remarques sur l'utilisation

Appelez cette opération pour traiter les vidéos téléchargées sur Object Storage Service (OSS) mais non encore traitées. Cela évite de devoir les télécharger à nouveau sur OSS. Si vous avez configuré des workflows multimédias, OSS notifie automatiquement MPS lorsqu'un fichier multimédia est téléchargé. MPS identifie alors le workflow actif correspondant en fonction du bucket et de l'objet OSS spécifiés. Par conséquent, dans la plupart des cas, il n'est pas nécessaire d'appeler manuellement l'opération AddMedia pour traiter le fichier multimédia.

Les informations multimédias sont extraites automatiquement uniquement si le workflow multimédia spécifié est à l'état actif. En l'absence de workflow spécifié ou si celui-ci n'est pas actif, aucune information multimédia n'est récupérée.

Limites de QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde. Tout dépassement de cette limite déclenche une limitation du débit (throttling), susceptible d'affecter votre activité. Tenez compte de cette contrainte lors de l'utilisation de cette opération. Pour plus d'informations, consultez Limites de QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Il génère dynamiquement des exemples de code adaptés aux différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	AddMedia	Nom de l'opération à effectuer. Définissez la valeur sur AddMedia.
FileURL	String	Oui	http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4	Chemin du fichier d'entrée. Consultez ce chemin dans la console MPS ou OSS. Pour plus de détails, reportez-vous à la section Règle de déclenchement et de correspondance d'un workflow de cette rubrique. La longueur maximale est de 3 200 octets. L'URL doit être conforme à la norme RFC 2396, encodée en UTF-8, avec les caractères réservés encodés en pourcentage.
Title	String	Non	mytest	Titre du fichier multimédia. La longueur maximale est de 128 octets. La valeur doit être encodée en UTF-8.
Description	String	Non	A test video	Description du fichier multimédia. La longueur maximale est de 1 024 octets. La valeur doit être encodée en UTF-8.
CoverURL	String	Non	http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png	Emplacement de stockage de la vignette associée au fichier multimédia. Pour obtenir l'URL, connectez-vous à la console MPS et accédez à Workflows > Media Buckets. Vous pouvez également vous connecter à la console OSS et cliquer sur My OSS Paths. La longueur maximale est de 3 200 octets. L'URL doit être conforme à la norme RFC 2396, encodée en UTF-8, avec les caractères réservés encodés en pourcentage.
Tags	String	Non	tag1,tag2	Tags à ajouter au fichier multimédia. Remarque Dans MPS, chaque tag associé à un fichier multimédia est indépendant. Recherchez tous les fichiers partageant les mêmes tags dans la bibliothèque multimédia (Media Library). Séparez les tags par des virgules (,). Un maximum de 16 tags peut être spécifié par fichier. Chaque tag ne doit pas dépasser 32 octets. La valeur doit être encodée en UTF-8.
MediaWorkflowId	String	Non	07da6c65da7f458997336e0de192****	ID du workflow multimédia à exécuter pour le fichier. Pour retrouver cet ID, connectez-vous à la console MPS ou appelez l'opération AddMediaWorkflow.
MediaWorkflowUserData	String	Non	test	Données personnalisées du workflow multimédia. La longueur maximale est de 1 024 octets. La valeur doit être encodée en UTF-8.
InputUnbind	Boolean	Non	false	Indique s'il faut vérifier que le workflow prend en charge le chemin d'entrée spécifié. Il est recommandé de définir ce paramètre sur true pour éviter les erreurs liées à des chemins invalides. Valeurs possibles : true : vérifie la compatibilité du workflow avec le chemin d'entrée. false : ne vérifie pas la compatibilité du workflow avec le chemin d'entrée.
CateId	Long	Non	123	ID de la catégorie à laquelle appartient le fichier multimédia. La valeur ne peut pas être négative.
OverrideParams	String	Non	{"subtitleTransNodeName":{"InputConfig":{"Format":"stl","InputFile":{"URL":"http://exampleBucket.oss-cn-hangzhou.aliyuncs.com/package/example/CENG.stl"}}}}	Paramètres de sous-titrage utilisés pour écraser les paramètres d'origine. Exemple 1 : Utilisez `{"WebVTTSubtitleOverrides",[{"RefActivityName":"subtitleNode","WebVTTSubtitleURL":"http://test.oss-cn-hangzhou.aliyuncs.com/example1.vtt"}]}` pour remplacer les paramètres de sous-titrage d'origine lors de l'emballage HTTP Live Streaming (HLS). Exemple 2 : Utilisez `{"subtitleTransNodeName":{"InputConfig":{"Format":"stl","InputFile":{"URL":"http://subtitleBucket.oss-cn-hangzhou.aliyuncs.com/package/example/CENG.stl"}}}}` pour remplacer les paramètres de sous-titrage d'origine lors de l'emballage Dynamic Adaptive Streaming over HTTP (DASH).

Règle de déclenchement et de correspondance d'un workflow

MPS vérifie si l'URL du fichier d'entrée contient l'URL à laquelle le workflow est lié. Si c'est le cas, le workflow correspond au fichier et s'exécute. Sinon, il n'y a pas de correspondance et le workflow ne s'exécute pas. Exemple : L'URL du fichier d'entrée est http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv.


  1. If the URL to which the workflow is bound is http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/, the workflow matches the input file.
  2. If the URL to which the workflow is bound is http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/, the workflow matches the input file.
  3. If the URL to which the workflow is bound is http://bucket.oss-cn-hangzhou.aliyuncs.com/A/, the workflow matches the input file.
  4. If the URL to which the workflow is bound is http://bucket.oss-cn-hangzhou.aliyuncs.com/, the workflow matches the input file.
  5. If the URL to which the workflow is bound is http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.flv, the workflow matches the input file.
  6. If the URL to which the workflow is bound is http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/CC/, the workflow does not match the input file.
  7. If the URL to which the workflow is bound is http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B2/, the workflow does not match the input file.
  8. If the URL to which the workflow is bound is http://bucket.oss-cn-hangzhou.aliyuncs.com/A2/B/C/, the workflow does not match the input file.

Remarque

Lors de la création d'un workflow multimédia, évitez de configurer l'URL d'entrée d'un workflow comme préfixe de l'URL d'entrée d'un autre. Sinon, le téléchargement d'un seul fichier multimédia déclenchera deux instances d'exécution de workflow. Par exemple, si l'URL d'entrée d'un premier workflow est « test » et celle d'un second est « test1 », les deux workflows seront déclenchés lors du téléchargement d'un fichier dans « test1 ».

Correspondance des extensions de nom de fichier

Seuls les fichiers multimédias peuvent déclencher des workflows. MPS détermine le déclenchement en vérifiant l'extension du nom de fichier. Un workflow correspond à un fichier sans extension (aucun point séparateur dans le nom) ou dont l'extension figure dans le tableau ci-dessous.

Remarque

La qualité des snapshots et du transcodage des fichiers .swf n'est pas garantie.

Type	Extension de nom de fichier
Vidéo	3gp, asf, avi, dat, dv, flv, f4v, gif, m2t, m3u8, m4v, mj2, mjpeg, mkv, mov, mp4, mpe, mpg, mpeg, mts, ogg, qt, rm, rmvb, swf, ts, vob, wmv, webm
Audio	aac, ac3, acm, amr, ape, caf, flac, m4a, mp3, ra, wav, wma, aiff

Message de workflow multimédia

Les workflows multimédias utilisent Alibaba Cloud Message Service (MNS) pour envoyer des messages aux utilisateurs du service MPS. Un message est émis lorsque l'activité Start ou Report est terminée. Pour recevoir ce message, vous devez configurer le nom de la file d'attente ou de la notification sur l'activité Start. Le message généré par le workflow est stocké dans cette file d'attente ou cette notification. Utilisez le SDK MNS pour récupérer le message. Le tableau suivant décrit les spécifications du message.

Paramètre	Type	Description
RunId	String	ID de l'instance d'exécution du workflow.
Name	String	Nom de l'activité.
Type	String	Type de l'activité. Valeurs possibles : Report et Start.
State	String	État de l'activité. Valeurs possibles : Fail et Success.
Code	String	Code d'erreur renvoyé en cas d'échec de l'activité. Ce code spécifique est retourné si l'état de l'activité est Fail.
Message	String	Message d'erreur renvoyé en cas d'échec de l'activité. Ce détail est retourné si l'état de l'activité est Fail.
MediaWorkflowExecution	MediaWorkflowExecution	Informations détaillées sur l'instance d'exécution du workflow.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	05F8B913-E9F3-4A6F-9922-48CADA0FFAAD	ID de la requête.
Media	Object		Informations détaillées sur le fichier multimédia.
CreationTime	String	2016-09-20T03:02:40Z	Date de création du fichier multimédia.
CateId	Long	1	ID de la catégorie à laquelle appartient le fichier multimédia.
Height	String	1280	Hauteur du fichier multimédia.
CensorState	String	Initiated	État de modération de la vidéo. Valeurs possibles : Initiated : Le fichier multimédia est téléchargé mais n'a pas encore été modéré. Pass : Le fichier multimédia est téléchargé et a passé la modération avec succès.
Tags	Array of String	tag,tag2	Tags associés au fichier multimédia.
Bitrate	String	1148.77	Débit binaire du fichier multimédia.
MediaId	String	3e6149d5a8c944c09b1a8d2dc3e4****	ID du fichier multimédia.
File	Object		Informations relatives au fichier d'entrée.
State	String	Normal	État du fichier d'entrée. La valeur par défaut est Normal.
URL	String	http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4	URL du fichier d'entrée.
PublishState	String	Published	État de publication du fichier multimédia. Valeurs possibles : Initiated : Le fichier multimédia est à l'état initial. UnPublish : Le fichier multimédia n'est pas publié et l'autorisation de lecture sur l'objet OSS est définie sur Private. Published : Le fichier multimédia est publié et l'autorisation de lecture sur l'objet OSS est définie sur Default.
Description	String	A test video	Description du fichier multimédia. La longueur ne doit pas dépasser 1 024 octets.
Width	String	1280	Largeur du fichier multimédia.
Size	String	379860	Taille du fichier multimédia.
CoverURL	String	http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png	Emplacement de stockage de la vignette multimédia.
RunIdList	Array of String	null	IDs des instances d'exécution de workflow exécutées, séparés par des virgules (,).
Duration	String	2.645333	Durée du fichier multimédia.
Fps	String	25.0	Fréquence d'images du fichier multimédia.
Title	String	mytest.mp4	Titre du fichier multimédia. La longueur ne doit pas dépasser 128 octets.
Format	String	mp4	Format du fichier multimédia. Valeurs possibles : mov, mp4, m4a, 3gp, 3g2 et mj2.

Exemples

Exemple de requête

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=AddMedia
&FileURL=http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4
&Title=mytest
&Description=A test video
&CoverURL=http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png
&Tags=tag1,tag2
&MediaWorkflowId=07da6c65da7f458997336e0de192****
&MediaWorkflowUserData=test
&InputUnbind=false
&CateId=123
&OverrideParams={"subtitleTransNodeName":{"InputConfig":{"Format":"stl","InputFile":{"URL":"http://exampleBucket.oss-cn-hangzhou.aliyuncs.com/package/example/CENG.stl"}}}}
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<AddMediaResponse>
    <RequestId>05F8B913-E9F3-4A6F-9922-48CADA0FFAAD</RequestId>
    <Media>
        <CreationTime>2016-09-20T03:02:40Z</CreationTime>
        <CateId>1</CateId>
        <Height>1280</Height>
        <CensorState>Initiated</CensorState>
        <Tags>tag,tag2</Tags>
        <Bitrate>1148.77</Bitrate>
        <MediaId>3e6149d5a8c944c09b1a8d2dc3e4****</MediaId>
        <File>
            <State>Normal</State>
            <URL>http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4</URL>
        </File>
        <PublishState>Published</PublishState>
        <Description>A test video</Description>
        <Width>1280</Width>
        <Size>379860</Size>
        <CoverURL>http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png</CoverURL>
        <RunIdList>{"RunId":["cbad98d35629470fa05ff393d347****"]}</RunIdList>
        <Duration>2.645333</Duration>
        <Fps>25.0</Fps>
        <Title>mytest.mp4</Title>
        <Format>mp4</Format>
    </Media>
</AddMediaResponse>

Format JSON

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

{
  "RequestId" : "05F8B913-E9F3-4A6F-9922-48CADA0FFAAD",
  "Media" : {
    "CreationTime" : "2016-09-20T03:02:40Z",
    "CateId" : 1,
    "Height" : "1280",
    "CensorState" : "Initiated",
    "Tags" : [ "tag,tag2" ],
    "Bitrate" : "1148.77",
    "MediaId" : "3e6149d5a8c944c09b1a8d2dc3e4****",
    "File" : {
      "State" : "Normal",
      "URL" : "http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.mp4"
    },
    "PublishState" : "Published",
    "Description" : "A test video",
    "Width" : "1280",
    "Size" : "379860",
    "CoverURL" : "http://bucket.oss-cn-hangzhou.aliyuncs.com/example/1.png",
    "RunIdList" : [ "{\"RunId\":[\"cbad98d35629470fa05ff393d347****\"]}" ],
    "Duration" : "2.645333",
    "Fps" : "25.0",
    "Title" : "mytest.mp4",
    "Format" : "mp4"
  }
}

Codes d'erreur

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