AddWaterMarkTemplate - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Une fois le modèle de filigrane créé via cette opération, spécifiez ce modèle ainsi que la ressource de filigrane lors de la soumission d'une tâche de transcodage. Vous pourrez ainsi ajouter des informations de filigrane à la vidéo de sortie.

Limite de QPS

Vous pouvez appeler cette API jusqu'à 100 fois par seconde 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 section Limite de QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Par souci de simplicité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. Celui-ci génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	AddWaterMarkTemplate	L'opération à effectuer. Définissez la valeur sur AddWaterMarkTemplate.
Name	String	Yes	example-watermark-****	Le nom du modèle de filigrane. La valeur peut contenir des lettres et des chiffres, et sa taille maximale est de 128 octets.
Config	String	Yes	{"Width":"10","Height":"30","Dx":"10","Dy":"5","ReferPos":"TopRight","Type":"Image","Timeline":{"Start":"0","Duration":"10"}}	La configuration du modèle de filigrane. La valeur est un objet JSON. Pour plus d'informations, voir Modèles de filigrane. Remarque Si vous n'avez pas besoin d'une corrélation positive entre la taille du texte du filigrane et la résolution, vous pouvez activer l'adaptation pour le filigrane. Pour ce faire, ajoutez `['adaptive']=true` au paramètre de texte du filigrane.

Paramètres de réponse

Parameter	Type	Example	Description
WaterMarkTemplate	Object		Les détails du modèle de filigrane.
Type	String	Image	Le type de filigrane. Valeurs possibles : Image : filigrane image. Text : filigrane texte.
RatioRefer	Object		Les valeurs des paramètres Height, Width, Dx et Dy par rapport aux bords de référence. Si les valeurs des paramètres Height, Width, Dx et Dy sont des décimales comprises entre 0 et 1, elles sont calculées en se référant successivement aux bords suivants : Width : bord de largeur. Height : bord de hauteur. Long : grand côté. Short : petit côté.
Dx	String	0.51	Le décalage horizontal du filigrane par rapport à l'image vidéo de sortie. Valeur par défaut : 0. Cette valeur indique l'absence de décalage. La valeur peut être un entier ou un nombre décimal. Integer : décalage vertical. Indique la position absolue. Unité : pixel. Decimal : ratio du décalage horizontal par rapport à la largeur de la vidéo de sortie. Ce ratio varie selon la taille de la vidéo. Quatre décimales sont prises en charge (par exemple 0,9999). Les décimales supplémentaires sont ignorées.
Width	String	0.36	La 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. Indique la position absolue. Unité : pixel. Decimal : ratio de la largeur de l'image du filigrane par rapport à la largeur de la vidéo de sortie. Ce ratio varie selon la taille de la vidéo. Quatre décimales sont prises en charge (par exemple 0,9999). Les décimales supplémentaires sont ignorées.
Height	String	0.33	La 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. Indique la position absolue. Unité : pixel. Decimal : ratio de la hauteur de l'image du filigrane par rapport à la hauteur de la vidéo de sortie. Ce ratio varie selon la taille de la vidéo. Quatre décimales sont prises en charge (par exemple 0,9999). Les décimales supplémentaires sont ignorées.
Dy	String	0.28	Le décalage vertical du filigrane par rapport à l'image vidéo de sortie. Valeur par défaut : 0. Cette valeur indique l'absence de décalage. La valeur peut être un entier ou un nombre décimal. Integer : décalage vertical. Indique la position absolue. Unité : pixel. Decimal : ratio du décalage vertical par rapport à la hauteur de la vidéo de sortie. Ce ratio varie selon la taille de la vidéo. Quatre décimales sont prises en charge (par exemple 0,9999). Les décimales supplémentaires sont ignorées.
ReferPos	String	TopRight	La 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	L'état du modèle de filigrane. Valeurs possibles : Normal : le modèle de filigrane est normal. Deleted : le modèle de filigrane est supprimé.
Dx	String	10	Le décalage horizontal. Unité : pixel.
Width	String	10	La largeur de l'image du filigrane. Unité : pixel.
Height	String	30	La hauteur de l'image du filigrane. Unité : pixel.
Timeline	Object		La chronologie du filigrane.
Start	String	0	Le début de la plage temporelle pendant laquelle le filigrane est affiché. Unité : secondes. Valeur par défaut : 0.
Duration	String	ToEND	La durée d'affichage du filigrane. Valeur par défaut : ToEND. Cette valeur par défaut indique que le filigrane reste affiché jusqu'à la fin de la vidéo.
Name	String	example-watermark-****	Le nom du modèle de filigrane.
Dy	String	5	Le décalage vertical. Unité : pixel.
Id	String	3780bd69b2b74540bc7b1096f564****	L'ID du modèle de filigrane. Nous vous recommandons de conserver cet ID pour les appels d'opérations ultérieurs.
RequestId	String	54BB917F-DD35-4F32-BABA-E60E31B21W63	L'ID de la requête.

Exemples

Exemple de requête

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=AddWaterMarkTemplate
&Name=example-watermark-****
&Config={"Width":"10","Height":"30","Dx":"10","Dy":"5","ReferPos":"TopRight","Type":"Image","Timeline":{"Start":"0","Duration":"10"}}
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<AddWaterMarkTemplateResponse>
    <WaterMarkTemplate>
        <Type>Image</Type>
        <RatioRefer>
            <Dx>0.51</Dx>
            <Width>0.36</Width>
            <Height>0.33</Height>
            <Dy>0.28</Dy>
        </RatioRefer>
        <ReferPos>TopRight</ReferPos>
        <State>Normal</State>
        <Dx>10</Dx>
        <Width>10</Width>
        <Height>30</Height>
        <Timeline>
            <Start>0</Start>
            <Duration>ToEND</Duration>
        </Timeline>
        <Name>example-watermark-****</Name>
        <Dy>5</Dy>
        <Id>3780bd69b2b74540bc7b1096f564****</Id>
    </WaterMarkTemplate>
    <RequestId>54BB917F-DD35-4F32-BABA-E60E31B21W63</RequestId>
</AddWaterMarkTemplateResponse>

JSON format

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

{
  "WaterMarkTemplate" : {
    "Type" : "Image",
    "RatioRefer" : {
      "Dx" : "0.51",
      "Width" : "0.36",
      "Height" : "0.33",
      "Dy" : "0.28"
    },
    "ReferPos" : "TopRight",
    "State" : "Normal",
    "Dx" : "10",
    "Width" : "10",
    "Height" : "30",
    "Timeline" : {
      "Start" : "0",
      "Duration" : "ToEND"
    },
    "Name" : "example-watermark-****",
    "Dy" : "5",
    "Id" : "3780bd69b2b74540bc7b1096f564****"
  },
  "RequestId" : "54BB917F-DD35-4F32-BABA-E60E31B21W63"
}

Codes d'erreur

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