UpdateWaterMarkTemplate - : Central de Documentação do Alibaba Cloud

Observações de uso

Use esta operação para atualizar as informações de um modelo de marca d'água com base no ID do modelo. Por exemplo, modifique o nome e a configuração de um modelo existente.
Não é possível atualizar um modelo de marca d'água enquanto um job enviado estiver em uso.

Limite de QPS

Esta API permite até 100 chamadas por segundo por conta. Se a quantidade de solicitações ultrapassar esse valor, o sistema ativa o throttling, o que pode afetar seus serviços. Considere essa restrição ao invocar esta operação. Para mais detalhes, consulte Limite de QPS.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UpdateWaterMarkTemplate	A operação a ser executada. Defina o valor como UpdateWaterMarkTemplate.
WaterMarkTemplateId	String	Sim	3780bd69b2b74540bc7b1096f564****	O ID do modelo de marca d'água a ser atualizado. Para obter o ID, faça login no ApsaraVideo Media Processing (MPS) console e escolha Global Settings > Watermark Templates no painel de navegação à esquerda.
Name	String	Sim	example-watermark-****	O novo nome do modelo de marca d'água. O valor pode conter letras e dígitos e ter até 128 bytes.
Config	String	Sim	{"Width":"10","Height":"30","Dx":"10","Dy":"5","Type":"Image","Timeline":{"Start":"0","Duration":"10"}}	A configuração atualizada do modelo de marca d'água. O valor é um objeto JSON. Para mais informações, consulte Configuração do modelo de marca d'água.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
WaterMarkTemplate	Object		Os detalhes do modelo de marca d'água.
Type	String	Image	O tipo da marca d'água. Valores válidos: Image: marca d'água de imagem. Text: marca d'água de texto. Nota Somente marcas d'água do tipo Image são suportadas.
RatioRefer	Object		Os valores dos parâmetros Height, Width, Dx e Dy relativos às bordas de referência. Se esses parâmetros forem decimais entre 0 e 1, o cálculo usará as seguintes bordas em sequência: Width: borda de largura. Height: borda de altura. Long: borda longa. Short: borda curta.
Dx	String	0,51	O deslocamento horizontal da marca d'água em relação à imagem do vídeo de saída. Valor padrão: 0 (sem deslocamento). O valor pode ser inteiro ou decimal. Integer: deslocamento vertical em posição absoluta. Unidade: pixel. Decimal: razão entre o deslocamento horizontal e a largura do vídeo de saída. A razão varia conforme o tamanho do vídeo. Suporta quatro casas decimais (ex.: 0,9999). Casas adicionais são descartadas.
Width	String	0,36	A largura da imagem da marca d'água no vídeo de saída. O valor pode ser inteiro ou decimal. Integer: largura da imagem da marca d'água em posição absoluta. Unidade: pixel. Decimal: razão entre a largura da imagem da marca d'água e a largura do vídeo de saída. A razão varia conforme o tamanho do vídeo. Suporta quatro casas decimais (ex.: 0,9999). Casas adicionais são descartadas.
Height	String	0,33	A altura da imagem da marca d'água no vídeo de saída. O valor pode ser inteiro ou decimal. Integer: altura da imagem da marca d'água em posição absoluta. Unidade: pixel. Decimal: razão entre a altura da imagem da marca d'água e a altura do vídeo de saída. A razão varia conforme o tamanho do vídeo. Suporta quatro casas decimais (ex.: 0,9999). Casas adicionais são descartadas.
Dy	String	0,28	O deslocamento vertical da marca d'água em relação à imagem do vídeo de saída. Valor padrão: 0 (sem deslocamento). O valor pode ser inteiro ou decimal. Integer: deslocamento vertical em posição absoluta. Unidade: pixel. Decimal: razão entre o deslocamento vertical e a altura do vídeo de saída. A razão varia conforme o tamanho do vídeo. Suporta quatro casas decimais (ex.: 0,9999). Casas adicionais são descartadas.
ReferPos	String	TopRight	A posição da marca d'água. Valores válidos: TopRight: canto superior direito. TopLeft: canto superior esquerdo. BottomRight: canto inferior direito. BottomLeft: canto inferior esquerdo.
State	String	Normal	O status do modelo de marca d'água. Valor padrão: Normal.
Dx	String	10	O deslocamento horizontal. Unidade: pixel.
Width	String	10	A largura da imagem da marca d'água. Unidade: pixel.
Height	String	30	A altura da imagem da marca d'água. Unidade: pixel.
Timeline	Object		A linha do tempo da marca d'água.
Start	String	0	O início do intervalo de exibição da marca d'água. Unidade: segundos. Valor padrão: 0.
Duration	String	10	A duração de exibição da marca d'água. Valor padrão: ToEND (exibida até o fim do vídeo).
Name	String	example-watermark-****	O nome do modelo de marca d'água.
Dy	String	5	O deslocamento vertical. Unidade: pixel.
Id	String	3780bd69b2b74540bc7b1096f564****	O ID do modelo de marca d'água. Mantenha este ID para chamadas de operações subsequentes.
RequestId	String	E558894E-40D9-57C6-B5CC-0F5CDF23614E	O ID da solicitação.

Exemplos

Solicitações de exemplo

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>

Resposta de sucesso de exemplo

Formato XML

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>

Formato JSON

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"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Error Center.