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

Observações de uso

Esta operação permite consultar até 10 modelos de marca d'água simultaneamente.

Limite de QPS

O limite desta API é de 100 chamadas por segundo por conta. Se a quantidade de solicitações por segundo ultrapassar esse valor, o sistema ativa o throttling, o que pode impactar seus serviços. Recomendamos observar esse limite ao executar 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	QueryWaterMarkTemplateList	A operação a ser executada. Defina o valor como QueryWaterMarkTemplateList.
WaterMarkTemplateIds	String	Sim	3780bd69b2b74540bc7b1096f564****	Os IDs dos modelos de marca d'água a serem consultados. Para obter os IDs, faça login no ApsaraVideo Media Processing (MPS) console e escolha Global Settings > Watermark Templates no painel de navegação à esquerda. É possível consultar até 10 modelos de marca d'água por vez. Separe vários IDs com vírgulas (,).

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	17079AF5-6276-51A9-B755-D26594C93F3C	O ID da solicitação.
NonExistWids	Array of String	72dfa5e679ab4be9a3ed9974c736****	Os IDs dos modelos de marca d'água inexistentes. Este parâmetro não é retornado se todos os modelos especificados forem encontrados.
WaterMarkTemplateList	Array of WaterMarkTemplate		Os detalhes dos modelos de marca d'água.
WaterMarkTemplate
Type	String	Image	O tipo da marca d'água. Valores válidos: Image e Text. 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 valores forem decimais entre 0 e 1, o cálculo considera as seguintes bordas em sequência: Width: a borda da largura. Height: a borda da altura. Long: a borda longa. Short: a 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 um número inteiro ou decimal. Integer: o deslocamento vertical. Indica a posição absoluta. Unidade: pixel. Decimal: a 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 suportadas quatro casas decimais, como 0,9999. Casas decimais 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 um número inteiro ou decimal. Integer: a largura da imagem da marca d'água. Indica a posição absoluta. Unidade: pixel. Decimal: a proporção da largura da imagem da marca d'água em relação à largura do vídeo de saída. A proporção varia conforme o tamanho do vídeo. São suportadas quatro casas decimais, como 0,9999. Casas decimais 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 um número inteiro ou decimal. Integer: a altura da imagem da marca d'água. Indica a posição absoluta. Unidade: pixel. Decimal: a proporção da altura da imagem da marca d'água em relação à altura do vídeo de saída. A proporção varia conforme o tamanho do vídeo. São suportadas quatro casas decimais, como 0,9999. Casas decimais adicionais são descartadas.
Dy	String	0,4	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 um número inteiro ou decimal. Integer: o deslocamento vertical. Indica a posição absoluta. Unidade: pixel. Decimal: a 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. São suportadas quatro casas decimais, como 0,9999. Casas decimais adicionais são descartadas.
ReferPos	String	TopRight	A posição da marca d'água. Valores válidos: TopRight: o canto superior direito. TopLeft: o canto superior esquerdo. BottomRight: o canto inferior direito. BottomLeft: o canto inferior esquerdo.
State	String	Normal	O 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	O deslocamento horizontal. Unidade: pixel.
Width	String	8	A largura da imagem da marca d'água. Unidade: pixel.
Height	String	8	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 tempo durante o qual a marca d'água é exibida. Unidade: segundos. Valor padrão: 0.
Duration	String	10	A duração de exibição da marca d'água. Valor padrão: ToEND. O valor padrão indica que a marca d'água é exibida até o fim do vídeo.
Name	String	example-watermark	O nome do modelo de marca d'água.
Dy	String	100	O deslocamento vertical. Unidade: pixel.
Id	String	3780bd69b2b74540bc7b1096f564****	O ID do modelo de marca d'água.

Exemplos

Exemplos de solicitações

http(s)://mts.cn-shanghai.aliyuncs.com/?Action=QueryWaterMarkTemplateList
&WaterMarkTemplateIds=3780bd69b2b74540bc7b1096f564****
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

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

<QueryWaterMarkTemplateListResponse>
    <RequestId>17079AF5-6276-51A9-B755-D26594C93F3C</RequestId>
    <NonExistWids>72dfa5e679ab4be9a3ed9974c736****</NonExistWids>
    <WaterMarkTemplateList>
        <Type>Image</Type>
        <RatioRefer>
            <Dx>0.51</Dx>
            <Width>0.36</Width>
            <Height>0.33</Height>
            <Dy>0.4</Dy>
        </RatioRefer>
        <ReferPos>TopRight</ReferPos>
        <State>Normal</State>
        <Dx>100</Dx>
        <Width>8</Width>
        <Height>8</Height>
        <Timeline>
            <Start>0</Start>
            <Duration>10</Duration>
        </Timeline>
        <Name>example-watermark</Name>
        <Dy>100</Dy>
        <Id>3780bd69b2b74540bc7b1096f564****</Id>
    </WaterMarkTemplateList>
</QueryWaterMarkTemplateListResponse>

Formato JSON

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

{
  "RequestId" : "17079AF5-6276-51A9-B755-D26594C93F3C",
  "NonExistWids" : [ "72dfa5e679ab4be9a3ed9974c736****" ],
  "WaterMarkTemplateList" : [ {
    "Type" : "Image",
    "RatioRefer" : {
      "Dx" : "0.51",
      "Width" : "0.36",
      "Height" : "0.33",
      "Dy" : "0.4"
    },
    "ReferPos" : "TopRight",
    "State" : "Normal",
    "Dx" : "100",
    "Width" : "8",
    "Height" : "8",
    "Timeline" : {
      "Start" : "0",
      "Duration" : "10"
    },
    "Name" : "example-watermark",
    "Dy" : "100",
    "Id" : "3780bd69b2b74540bc7b1096f564****"
  } ]
}

Códigos de erro

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