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

Observações de uso

Após criar um modelo de marca d'água com esta operação, especifique o modelo e o recurso de marca d'água ao enviar um trabalho de transcodificação. Assim, você adiciona informações de marca d'água ao vídeo de saída.

Limite de QPS

Você pode chamar esta API até 100 vezes por segundo por conta. Se a quantidade de chamadas por segundo exceder o limite, o sistema acionará o throttling, o que pode afetar seus negócios. Recomendamos observar esse limite ao chamar esta operação. Para mais informações, 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	AddWaterMarkTemplate	A operação a ser executada. Defina o valor como AddWaterMarkTemplate.
Name	String	Sim	example-watermark-****	Nome do modelo de marca d'água. O valor pode conter letras e dígitos, com tamanho máximo de 128 bytes.
Config	String	Sim	{"Width":"10","Height":"30","Dx":"10","Dy":"5","ReferPos":"TopRight","Type":"Image","Timeline":{"Start":"0","Duration":"10"}}	Configuração do modelo de marca d'água. O valor é um objeto JSON. Para mais informações, consulte Modelos de marca d'água. Nota Se não for necessária uma correlação positiva entre o tamanho do texto na marca d'água e a resolução, ative a adaptação para a marca d'água. Para isso, adicione `['adaptive']=true` ao parâmetro de texto da marca d'água.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
WaterMarkTemplate	Object		Detalhes do modelo de marca d'água.
Type	String	Image	Tipo da marca d'água. Valores válidos: Image: marca d'água de imagem. Text: marca d'água de texto.
RatioRefer	Object		Valores dos parâmetros Height, Width, Dx e Dy relativos às bordas de referência. Se os valores desses parâmetros forem decimais entre 0 e 1, o cálculo considera as seguintes bordas, nesta ordem: Width: borda da largura. Height: borda da altura. Long: borda longa. Short: borda curta.
Dx	String	0.51	Deslocamento horizontal da marca d'água em relação à imagem do vídeo de saída. Valor padrão: 0, que indica ausência de deslocamento. O valor pode ser um número inteiro ou decimal. Inteiro: deslocamento vertical indicando posição absoluta. Unidade: pixel. Decimal: razão entre o deslocamento horizontal e a largura do vídeo de saída. Essa proporção varia conforme o tamanho do vídeo. São suportadas até quatro casas decimais (ex.: 0.9999); casas adicionais são descartadas.
Width	String	0.36	Largura da imagem da marca d'água no vídeo de saída. O valor pode ser inteiro ou decimal. Inteiro: largura da imagem da marca d'água indicando posição absoluta. Unidade: pixel. Decimal: razão entre a largura da marca d'água e a largura do vídeo de saída. A proporção varia conforme o tamanho do vídeo. Suporta até quatro casas decimais (ex.: 0.9999); casas adicionais são descartadas.
Height	String	0.33	Altura da imagem da marca d'água no vídeo de saída. O valor pode ser inteiro ou decimal. Inteiro: altura da imagem da marca d'água indicando posição absoluta. Unidade: pixel. Decimal: razão entre a altura da marca d'água e a altura do vídeo de saída. A proporção varia conforme o tamanho do vídeo. Suporta até quatro casas decimais (ex.: 0.9999); casas adicionais são descartadas.
Dy	String	0.28	Deslocamento vertical da marca d'água em relação à imagem do vídeo de saída. Valor padrão: 0, indicando ausência de deslocamento. O valor pode ser inteiro ou decimal. Inteiro: deslocamento vertical indicando posição absoluta. Unidade: pixel. Decimal: razão entre o deslocamento vertical e a altura do vídeo de saída. A proporção varia conforme o tamanho do vídeo. Suporta até quatro casas decimais (ex.: 0.9999); casas adicionais são descartadas.
ReferPos	String	TopRight	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	Status do modelo de marca d'água. Valores válidos: Normal: o modelo de marca d'água está normal. Deleted: o modelo de marca d'água foi excluído.
Dx	String	10	Deslocamento horizontal. Unidade: pixel.
Width	String	10	Largura da imagem da marca d'água. Unidade: pixel.
Height	String	30	Altura da imagem da marca d'água. Unidade: pixel.
Timeline	Object		Linha do tempo da marca d'água.
Start	String	0	Início do intervalo de tempo durante o qual a marca d'água é exibida. Unidade: segundos. Valor padrão: 0.
Duration	String	ToEND	Duração de exibição da marca d'água. Valor padrão: ToEND, indicando que a marca d'água permanece visível até o fim do vídeo.
Name	String	example-watermark-****	Nome do modelo de marca d'água.
Dy	String	5	Deslocamento vertical. Unidade: pixel.
Id	String	3780bd69b2b74540bc7b1096f564****	ID do modelo de marca d'água. Recomendamos guardar este ID para chamadas de operações subsequentes.
RequestId	String	54BB917F-DD35-4F32-BABA-E60E31B21W63	ID da solicitação.

Exemplos

Solicitações de exemplo

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>

Resposta de sucesso de exemplo

Formato XML

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>

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" : "ToEND"
    },
    "Name" : "example-watermark-****",
    "Dy" : "5",
    "Id" : "3780bd69b2b74540bc7b1096f564****"
  },
  "RequestId" : "54BB917F-DD35-4F32-BABA-E60E31B21W63"
}

Códigos de erro

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