QueryWaterMarkTemplateList - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Cette opération permet d'interroger jusqu'à 10 modèles de filigrane à la fois.

Limite QPS

Vous pouvez appeler cette API jusqu'à 100 fois par seconde par compte. Si le nombre d'appels par seconde dépasse la limite, un mécanisme de limitation du débit (throttling) se déclenche et peut affecter votre activité. Tenez compte de cette limite lorsque vous appelez cette opération. Pour plus d'informations, consultez la section Limite QPS.

Débogage

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

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	QueryWaterMarkTemplateList	Opération à effectuer. Définissez la valeur sur QueryWaterMarkTemplateList.
WaterMarkTemplateIds	String	Oui	3780bd69b2b74540bc7b1096f564****	ID des modèles de filigrane à interroger. Pour obtenir ces ID, connectez-vous à la console ApsaraVideo Media Processing (MPS) et choisissez Global Settings > Watermark Templates dans le volet de navigation de gauche. Vous pouvez interroger jusqu'à 10 modèles de filigrane à la fois. Séparez les différents ID par des virgules (,).

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	17079AF5-6276-51A9-B755-D26594C93F3C	ID de la requête.
NonExistWids	Array of String	72dfa5e679ab4be9a3ed9974c736****	ID des modèles de filigrane introuvables. Ce paramètre n'est pas renvoyé si tous les modèles spécifiés existent.
WaterMarkTemplateList	Array of WaterMarkTemplate		Détails des modèles de filigrane.
WaterMarkTemplate
Type	String	Image	Type de filigrane. Valeurs possibles : Image Text Remarque Seuls les filigranes de type Image sont pris en charge.
RatioRefer	Object		Valeurs des paramètres Height, Width, Dx et Dy par rapport aux bords de référence. Si les valeurs de ces paramètres sont des décimales comprises entre 0 et 1, les calculs se basent successivement sur les bords suivants : Width : bord de largeur. Height : bord de hauteur. Long : bord long. Short : bord court.
Dx	String	0,51	Décalage horizontal du filigrane par rapport à l'image vidéo de sortie. Valeur par défaut : 0 (aucun décalage). La valeur peut être un entier ou un nombre décimal. Integer : décalage vertical (position absolue en pixels). Decimal : rapport entre le décalage horizontal et la largeur de la vidéo de sortie. Ce rapport varie selon la taille de la vidéo. Quatre décimales maximum sont prises en charge (par exemple 0,9999). Les décimales supplémentaires sont ignorées.
Width	String	0,36	Largeur de l'image du filigrane dans la vidéo de sortie. La valeur peut être un entier ou un nombre décimal. Integer : largeur de l'image du filigrane (position absolue en pixels). Decimal : rapport entre la largeur de l'image du filigrane et la largeur de la vidéo de sortie. Ce rapport varie selon la taille de la vidéo. Quatre décimales maximum sont prises en charge (par exemple 0,9999). Les décimales supplémentaires sont ignorées.
Height	String	0,33	Hauteur de l'image du filigrane dans la vidéo de sortie. La valeur peut être un entier ou un nombre décimal. Integer : hauteur de l'image du filigrane (position absolue en pixels). Decimal : rapport entre la hauteur de l'image du filigrane et la hauteur de la vidéo de sortie. Ce rapport varie selon la taille de la vidéo. Quatre décimales maximum sont prises en charge (par exemple 0,9999). Les décimales supplémentaires sont ignorées.
Dy	String	0,4	Décalage vertical du filigrane par rapport à l'image vidéo de sortie. Valeur par défaut : 0 (aucun décalage). La valeur peut être un entier ou un nombre décimal. Integer : décalage vertical (position absolue en pixels). Decimal : rapport entre le décalage vertical et la hauteur de la vidéo de sortie. Ce rapport varie selon la taille de la vidéo. Quatre décimales maximum sont prises en charge (par exemple 0,9999). Les décimales supplémentaires sont ignorées.
ReferPos	String	TopRight	Position du filigrane. Valeurs possibles : TopRight : coin supérieur droit. TopLeft : coin supérieur gauche. BottomRight : coin inférieur droit. BottomLeft : coin inférieur gauche.
State	String	Normal	État du modèle de filigrane. Valeurs possibles : Normal : Le modèle de filigrane est actif. Deleted : Le modèle de filigrane est supprimé.
Dx	String	100	Décalage horizontal. Unité : pixel.
Width	String	8	Largeur de l'image du filigrane. Unité : pixel.
Height	String	8	Hauteur de l'image du filigrane. Unité : pixel.
Timeline	Object		Chronologie du filigrane.
Start	String	0	Début de la plage de temps d'affichage du filigrane. Unité : secondes. Valeur par défaut : 0.
Duration	String	10	Durée d'affichage du filigrane. Valeur par défaut : ToEND (le filigrane reste affiché jusqu'à la fin de la vidéo).
Name	String	example-watermark	Nom du modèle de filigrane.
Dy	String	100	Décalage vertical. Unité : pixel.
Id	String	3780bd69b2b74540bc7b1096f564****	ID du modèle de filigrane.

Exemples

Exemple de requête

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=QueryWaterMarkTemplateList
&WaterMarkTemplateIds=3780bd69b2b74540bc7b1096f564****
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<QueryWaterMarkTemplateListResponse>
    <RequestId>17079AF5-6276-51A9-B755-D26594C93F3C</RequestId>
    <NonExistWids>72dfa5e679ab4be9a3ed9974c736****</NonExistWids>
    <WaterMarkTemplateList>
        <Type>Image</Type>
        <RatioRefer>
            <Dx>0.51</Dx>
            <Width>0.36</Width>
            <Height>0.33</Height>
            <Dy>0.4</Dy>
        </RatioRefer>
        <ReferPos>TopRight</ReferPos>
        <State>Normal</State>
        <Dx>100</Dx>
        <Width>8</Width>
        <Height>8</Height>
        <Timeline>
            <Start>0</Start>
            <Duration>10</Duration>
        </Timeline>
        <Name>example-watermark</Name>
        <Dy>100</Dy>
        <Id>3780bd69b2b74540bc7b1096f564****</Id>
    </WaterMarkTemplateList>
</QueryWaterMarkTemplateListResponse>

Format JSON

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

{
  "RequestId" : "17079AF5-6276-51A9-B755-D26594C93F3C",
  "NonExistWids" : [ "72dfa5e679ab4be9a3ed9974c736****" ],
  "WaterMarkTemplateList" : [ {
    "Type" : "Image",
    "RatioRefer" : {
      "Dx" : "0.51",
      "Width" : "0.36",
      "Height" : "0.33",
      "Dy" : "0.4"
    },
    "ReferPos" : "TopRight",
    "State" : "Normal",
    "Dx" : "100",
    "Width" : "8",
    "Height" : "8",
    "Timeline" : {
      "Start" : "0",
      "Duration" : "10"
    },
    "Name" : "example-watermark",
    "Dy" : "100",
    "Id" : "3780bd69b2b74540bc7b1096f564****"
  } ]
}

Codes d'erreur

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