UpdateWaterMarkTemplate - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Appelez cette opération pour mettre à jour les informations d'un modèle de filigrane à partir de son ID. Vous pouvez par exemple modifier le nom et la configuration du modèle.
Vous ne pouvez pas mettre à jour un modèle de filigrane s'il est utilisé par une tâche déjà soumise.

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 (throttling) est déclenché, 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 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	UpdateWaterMarkTemplate	Opération à effectuer. Définissez la valeur sur UpdateWaterMarkTemplate.
WaterMarkTemplateId	String	Oui	3780bd69b2b74540bc7b1096f564****	ID du modèle de filigrane à mettre à jour. Pour obtenir l'ID du modèle, connectez-vous à la console ApsaraVideo Media Processing (MPS) et choisissez Global Settings > Watermark Templates dans le volet de navigation de gauche.
Name	String	Oui	example-watermark-****	Nouveau nom du modèle de filigrane. La valeur peut contenir des lettres et des chiffres. Taille maximale : 128 octets.
Config	String	Oui	{"Width":"10","Height":"30","Dx":"10","Dy":"5","Type":"Image","Timeline":{"Start":"0","Duration":"10"}}	Configuration mise à jour du modèle de filigrane. La valeur est un objet JSON. Pour plus d'informations, consultez la rubrique Configuration du modèle de filigrane.

Paramètres de réponse

Paramètre	Type	Exemple	Description
WaterMarkTemplate	Object		Détails du modèle de filigrane.
Type	String	Image	Type de filigrane. Valeurs valides : Image : filigrane image. Text : filigrane texte. 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 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 aux bords suivants dans l'ordre : 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. Indique la position absolue. Unité : pixel. Decimal : ratio du décalage horizontal par rapport à la largeur de la vidéo de sortie. Le ratio varie en fonction de 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	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. Le ratio varie en fonction de 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	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. Le ratio varie en fonction de 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	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. Indique la position absolue. Unité : pixel. Decimal : ratio du décalage vertical par rapport à la hauteur de la vidéo de sortie. Le ratio varie en fonction de 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	Position du filigrane. Valeurs valides : TopRight : coin supérieur droit. TopLeft : coin supérieur gauche. BottomRight : coin inférieur droit. BottomLeft : coin inférieur gauche.
State	String	Normal	Statut du modèle de filigrane. Valeur par défaut : Normal.
Dx	String	10	Décalage horizontal. Unité : pixel.
Width	String	10	Largeur de l'image du filigrane. Unité : pixel.
Height	String	30	Hauteur de l'image du filigrane. Unité : pixel.
Timeline	Object		Chronologie du filigrane.
Start	String	0	Début de la plage temporelle pendant laquelle le filigrane est affiché. Unité : secondes. Valeur par défaut : 0.
Duration	String	10	Durée d'affichage du filigrane. Valeur par défaut : ToEND. Cette valeur par défaut indique que le filigrane est affiché jusqu'à la fin de la vidéo.
Name	String	example-watermark-****	Nom du modèle de filigrane.
Dy	String	5	Décalage vertical. Unité : pixel.
Id	String	3780bd69b2b74540bc7b1096f564****	ID du modèle de filigrane. Conservez cet ID pour les appels d'opérations ultérieurs.
RequestId	String	E558894E-40D9-57C6-B5CC-0F5CDF23614E	ID de la requête.

Exemples

Exemples de requêtes

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

Exemple de réponse correcte

XML format

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

<UpdateWaterMarkTemplateResponse>
    <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>10</Duration>
        </Timeline>
        <Name>example-watermark-****</Name>
        <Dy>5</Dy>
        <Id>3780bd69b2b74540bc7b1096f564****</Id>
    </WaterMarkTemplate>
    <RequestId>E558894E-40D9-57C6-B5CC-0F5CDF23614E</RequestId>
</UpdateWaterMarkTemplateResponse>

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" : "10"
    },
    "Name" : "example-watermark-****",
    "Dy" : "5",
    "Id" : "3780bd69b2b74540bc7b1096f564****"
  },
  "RequestId" : "E558894E-40D9-57C6-B5CC-0F5CDF23614E"
}

Codes d'erreur

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