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

Observações de uso

Use esta operação para consultar modelos de marca d'água em um estado específico. Se você não especificar o estado, o sistema consultará todos os modelos de marca d'água por padrão.

Limite de QPS

Você pode chamar esta operação de API até 100 vezes por segundo por conta. Se o número de chamadas por segundo exceder o limite, o throttling será acionado e seus negócios poderão ser afetados. 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	SearchWaterMarkTemplate	A operação a ser executada. Defina o valor como SearchWaterMarkTemplate.
PageSize	Long	Não	10	Número de entradas a retornar em cada página. Máximo de 100 entradas por página. Valor padrão: 10.
PageNumber	Long	Não	1	Número da página a retornar. Valor padrão: 1.
State	String	Não	Normal	Status dos modelos de marca d'água a consultar. Valores válidos: All: consulta todos os modelos de marca d'água. Este é o valor padrão. normal: consulta modelos de marca d'água normais. Deleted: consulta modelos de marca d'água excluídos.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
TotalCount	Long	1	Número total de entradas retornadas.
PageSize	Long	10	Número de entradas retornadas em cada página.
RequestId	String	FC029D04-8F47-57FF-A759-23383C15617D	ID da solicitação.
PageNumber	Long	1	Número da página retornada.
WaterMarkTemplateList	Array of WaterMarkTemplate		Detalhes dos modelos de marca d'água.
WaterMarkTemplate
Type	String	Image	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		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 considerará 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 inteiro ou decimal. Inteiro: deslocamento vertical absoluto. Unidade: pixel. Decimal: proporção do deslocamento horizontal em relação à largura do vídeo de saída. A proporção varia conforme o tamanho do vídeo. São aceitas 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 absoluta da imagem da marca d'água. 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 as dimensões 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 absoluta da imagem da marca d'água. 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.2	Deslocamento vertical 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 inteiro ou decimal. Inteiro: deslocamento vertical absoluto. Unidade: pixel. Decimal: proporção do deslocamento vertical em relação à 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	100	Deslocamento horizontal. Unidade: pixel.
Width	String	8	Largura da imagem da marca d'água. Unidade: pixel.
Height	String	8	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 em que a marca d'água é exibida. Unidade: segundos. Valor padrão: 0.
Duration	String	ToEND	Duração da exibição da marca d'água. Valor padrão: ToEND, que indica 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	100	Deslocamento vertical. Unidade: pixel.
Id	String	88c6ca184c0e4578645b665e2a12****	ID do modelo de marca d'água.

Exemplos

Exemplos de solicitações

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=SearchWaterMarkTemplate
&PageSize=10
&PageNumber=1
&State=Normal
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

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

<SearchWaterMarkTemplateResponse>
    <TotalCount>1</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>FC029D04-8F47-57FF-A759-23383C15617D</RequestId>
    <PageNumber>1</PageNumber>
    <WaterMarkTemplateList>
        <Type>Image</Type>
        <RatioRefer>
            <Dx>0.51</Dx>
            <Width>0.36</Width>
            <Height>0.33</Height>
            <Dy>0.2</Dy>
        </RatioRefer>
        <ReferPos>TopRight</ReferPos>
        <State>Normal</State>
        <Dx>100</Dx>
        <Width>8</Width>
        <Height>8</Height>
        <Timeline>
            <Start>0</Start>
            <Duration>ToEND</Duration>
        </Timeline>
        <Name>example-watermark</Name>
        <Dy>100</Dy>
        <Id>88c6ca184c0e4578645b665e2a12****</Id>
    </WaterMarkTemplateList>
</SearchWaterMarkTemplateResponse>

Formato JSON

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

{
  "TotalCount" : 1,
  "PageSize" : 10,
  "RequestId" : "FC029D04-8F47-57FF-A759-23383C15617D",
  "PageNumber" : 1,
  "WaterMarkTemplateList" : [ {
    "Type" : "Image",
    "RatioRefer" : {
      "Dx" : "0.51",
      "Width" : "0.36",
      "Height" : "0.33",
      "Dy" : "0.2"
    },
    "ReferPos" : "TopRight",
    "State" : "Normal",
    "Dx" : "100",
    "Width" : "8",
    "Height" : "8",
    "Timeline" : {
      "Start" : "0",
      "Duration" : "ToEND"
    },
    "Name" : "example-watermark",
    "Dy" : "100",
    "Id" : "88c6ca184c0e4578645b665e2a12****"
  } ]
}

Códigos de erro

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