Add image and text watermarks to videos - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Uma marca d'água de vídeo adiciona informações de identificação, como logotipo da empresa, ícone de emissora de TV, apelido ou ID do usuário, a um vídeo para promover sua marca, proteger direitos autorais e aumentar o reconhecimento da marca. O ApsaraVideo VOD oferece suporte a três tipos de marcas d'água: imagem estática, imagem animada e texto. Escolha o tipo que melhor atenda às suas necessidades.

Como funciona

O recurso de marca d'água de vídeo no ApsaraVideo VOD opera por meio de transcodificação. Durante esse processo, imagens ou texto são gravados no fluxo de vídeo para gerar um novo arquivo de vídeo com marca d'água.

Casos de uso

Vídeos curtos

Vídeos curtos baixados ou compartilhados geralmente incluem uma marca d'água de imagem (logotipo do produto) e uma marca d'água de texto (ID do usuário) para proteção de direitos autorais.
Sites de áudio e vídeo

Sites de áudio e vídeo costumam adicionar logotipos aos vídeos para reivindicar a propriedade dos direitos autorais. Em programas de variedades, adesivos também são usados para tornar o conteúdo mais divertido ou aumentar a exposição de anúncios.

Tipos de marca d'água

Tipo	Formatos suportados	Descrição
Imagem	Imagem estática: PNG Imagem animada: GIF, APNG, MOV	No console do ApsaraVideo VOD, crie modelos de marca d'água para os formatos PNG e GIF. Pela API, é possível criar modelos para os formatos PNG, GIF, APNG e MOV. Para marcas d'água de imagem animada, as extensões de arquivo `gif`, `apng` e `mov` devem estar em minúsculas. Essa limitação não se aplica a imagens estáticas. Armazene a imagem da marca d'água no mesmo bucket de armazenamento do vídeo a ser marcado. Por exemplo, se um vídeo estiver em um bucket do ApsaraVideo VOD na região China (Shanghai), o arquivo da marca d'água também deverá estar no mesmo bucket. Não é possível usar marcas d'água entre regiões ou buckets diferentes. Para mais informações, consulte Gerenciamento de armazenamento. Defina a duração de exibição de uma marca d'água de imagem para mostrá-la durante todo o vídeo ou apenas por um período específico.
Texto	-	Configure propriedades de texto como fonte, tamanho da fonte, cor, transparência e efeitos de contorno.

Faturamento

A aplicação de marca d'água em vídeo utiliza transcodificação, o que gera taxas de transcodificação. Para mais informações, consulte Faturamento de transcodificação de mídia.

Como usar

Etapa 1: Criar um modelo de marca d'água

Para simplificar a aplicação de marcas d'água, o ApsaraVideo VOD fornece modelos específicos. Um modelo de marca d'água permite configurar parâmetros como posição, tamanho, fonte e cor do texto. Cada modelo possui um ID exclusivo.

Console

Faça login no console do ApsaraVideo VOD.
No painel de navegação à esquerda, escolha Configuration Management > Media Processing > Watermarks.

Clique em Create Watermark. Configure uma marca d'água de imagem ou texto conforme necessário.

Marca d'água de imagem

Parâmetro	Descrição
Watermark Type	Selecione Image.
Image	Carregue uma imagem de marca d'água. Nota O console suporta apenas os formatos PNG e GIF. O tamanho da imagem não pode exceder 20 MB.
Watermark Name	Insira um nome para o modelo de marca d'água. Nota O nome pode conter caracteres chineses e ingleses, números, `#` e `-`.
Size (Width × Height)	Tamanho da imagem da marca d'água. Para mais informações, consulte Detalhes sobre os parâmetros de posição e tamanho da marca d'água. Número inteiro positivo em pixels. Valores válidos: [8, 4096]. Porcentagem das dimensões do vídeo. Unidade: %. Valores válidos: (0, 100). O valor pode ter até duas casas decimais. Nota Se você especificar apenas a largura ou a altura da imagem da marca d'água, a outra dimensão será dimensionada proporcionalmente com base na proporção original da imagem.
Position	Posição do ponto de referência da marca d'água em relação ao vídeo de saída. Valor padrão: Upper-right. Para mais informações, consulte Detalhes sobre os parâmetros de posição e tamanho da marca d'água. Valores válidos: Upper-left Lower-left Upper-right Lower-right
Horizontal Shift	Deslocamento horizontal da marca d'água no vídeo de saída. Para mais informações, consulte Detalhes sobre os parâmetros de posição e tamanho da marca d'água. Número inteiro positivo em pixels. Valores válidos: [8, 4096]. Porcentagem das dimensões do vídeo. Unidade: %. Valores válidos: (0, 100). O valor pode ter até duas casas decimais.
Vertical Shift	Deslocamento vertical da marca d'água no vídeo de saída. Para mais informações, consulte Detalhes sobre os parâmetros de posição e tamanho da marca d'água. Número inteiro positivo em pixels. Valores válidos: [8, 4096]. Porcentagem das dimensões do vídeo. Unidade: %. Valores válidos: (0, 100). O valor pode ter até duas casas decimais.
Timeline	As configurações de linha do tempo controlam o horário de início e a duração da marca d'água de imagem. Use várias configurações de marca d'água para criar efeitos dinâmicos. Nota Este parâmetro não é suportado para marcas d'água de texto.
Preview Screen Size (Width × Height)	Insira as dimensões do vídeo real para visualizar a posição e o efeito da marca d'água. Unidade: pixels.

Marca d'água de texto

Parâmetro	Descrição
Watermark Type	Selecione Text.
Watermark Content	Insira o texto desejado para a marca d'água.
Watermark Name	Insira um nome para o modelo de marca d'água. Nota O nome pode conter letras, dígitos, `#` e `-`.
Font	Fonte do texto da marca d'água. Valores válidos: SimSun WenQuanYi Zen Hei WenQuanYi Zen Hei Mono WenQuanYi Zen Hei Sharp Yuanti SC
Font Size	Tamanho da fonte do texto da marca d'água, em pixels.
Transparency	Transparência do texto da marca d'água. Um valor menor indica maior transparência. O valor pode ter até duas casas decimais. Valores válidos: (0, 1].
Font Color	Defina a cor do texto da marca d'água.
Stroke Width	Largura do contorno da fonte, em pixels. Valores válidos: (0, 4096].
Stroke Color	Defina a cor do contorno da fonte.
Vertical Shift	Deslocamento vertical do texto da marca d'água no vídeo de saída. Para mais informações, consulte Detalhes sobre os parâmetros de posição e tamanho da marca d'água. Número inteiro positivo em pixels. Valores válidos: [8, 4096].
Horizontal Shift	Deslocamento horizontal do texto da marca d'água no vídeo de saída. Para mais informações, consulte Detalhes sobre os parâmetros de posição e tamanho da marca d'água. Número inteiro positivo em pixels. Valores válidos: [8, 4096].
Preview Screen Size	Insira as dimensões do vídeo real para visualizar a posição e o efeito do texto da marca d'água. Unidade: pixels.

Clique em Save.

Após a criação, o modelo de marca d'água e seu ID ficam visíveis na página Watermarks.

API

Chame a operação AddWatermark para criar um modelo de marca d'água. O sistema retorna o ID do modelo após a criação.

Nota

Ao usar a API para criar um modelo de marca d'água de imagem, chame primeiro a operação CreateUploadAttachedMedia para carregar a imagem da marca d'água no ApsaraVideo VOD. Para mais informações sobre como carregar arquivos, consulte Carregar arquivos de mídia usando a API do ApsaraVideo VOD.

Posição e tamanho

Marcas d'água de imagem

Use os parâmetros ReferPos, Dx, Dy, Width e Height para controlar a posição e o tamanho da imagem no vídeo de saída.

Parâmetro da API	Parâmetro do console	Descrição
ReferPos	Position	Ponto de referência da marca d'água em relação ao vídeo de saída. Canto superior esquerdo: TopLeft Canto inferior esquerdo: BottomLeft Canto superior direito: TopRight Canto inferior direito: BottomRight
Dx	Horizontal Shift	Deslocamento horizontal da marca d'água no vídeo de saída. Valores válidos: Número inteiro positivo em pixels. Valores válidos: [8, 4096]. Decimal que representa uma porcentagem da largura do vídeo. Valores válidos: (0, 1).
Dy	Vertical Shift	Deslocamento vertical da marca d'água no vídeo de saída. Valores válidos: Número inteiro positivo em pixels. Valores válidos: [8, 4096]. Decimal que representa uma porcentagem da altura do vídeo. Valores válidos: (0, 1).
Width	Size (Width)	Largura da marca d'água no vídeo de saída. Valores válidos: Número inteiro positivo em pixels. Valores válidos: [8, 4096]. Decimal que representa uma porcentagem da largura do vídeo. Valores válidos: (0, 1).
Height	Size (Height)	Altura da marca d'água no vídeo de saída. Valores válidos: Número inteiro positivo em pixels. Valores válidos: [8, 4096]. Decimal que representa uma porcentagem da altura do vídeo. Valores válidos: (0, 1).
Timeline	Timeline	As configurações de linha do tempo controlam o horário de início e a duração da marca d'água de imagem. Use várias configurações de marca d'água para criar efeitos dinâmicos. Para mais informações, consulte Linha do tempo da marca d'água. Importante Este parâmetro não é suportado para marcas d'água de texto.

Diagrama

Para centralizar uma marca d'água, defina os parâmetros Dx e Dy como 0.5. Isso define o deslocamento como 50% da largura e altura do vídeo de saída. 图片水印位置

Marcas d'água de texto

A posição de uma marca d'água de texto é relativa ao canto superior esquerdo do vídeo de saída. Os parâmetros Top e Left definem o deslocamento. Esses parâmetros aceitam apenas valores em pixels e não suportam valores baseados em porcentagem.

Parâmetro da API	Parâmetro do console	Descrição
Top	Vertical Shift	Distância da borda superior do vídeo de saída até a marca d'água de texto. Unidade: pixels. Valores válidos: [8, 4096].
Left	Horizontal Shift	Distância da borda esquerda do vídeo de saída até a marca d'água de texto. Unidade: pixels. Valores válidos: [8, 4096].

Diagrama 文字水印

Métodos de cálculo

Para marcas d'água de imagem, especifique os parâmetros Dx, Dy, Width e Height como números inteiros positivos (pixels) ou decimais (porcentagens). Para marcas d'água de texto, os parâmetros Top e Left aceitam apenas números inteiros positivos.
- Números inteiros positivos: Valores em pixels. Valores válidos: [8, 4096].
  
  Importante
  Se os valores dos parâmetros excederem as dimensões do vídeo de saída, a marca d'água poderá ficar parcial ou totalmente oculta.
  
  Por exemplo, se a resolução do vídeo de saída for 640×360, a posição de referência for TopLeft, Dx for 4000 e Dy for 4000, a marca d'água não ficará visível no vídeo de saída. Isso também se aplica a marcas d'água de texto.
- Porcentagem: Valor relativo à largura ou altura da resolução do vídeo de saída. O valor deve ser um decimal no intervalo de (0, 1) com até quatro casas decimais.
  
  Importante
  Se a proporção do vídeo de saída for variável ou imprevisível, recomendamos definir os parâmetros de posição e tamanho da marca d'água usando porcentagens.
  
  Exemplo: 0.9999. Exemplo de cálculo: Width / Video Width = 0.1, Height / Video Height = 0.06, Dx / Video Width = 0.02 e Dy / Video Height = 0.03.
Valores padrão
- Se você omitir a largura e a altura, a largura da marca d'água será definida como 12% da largura do vídeo de saída, e a altura será dimensionada proporcionalmente com base na proporção da imagem original da marca d'água.
- Se você especificar apenas a largura ou a altura: O sistema usa a dimensão especificada e dimensiona a outra proporcionalmente com base na proporção da imagem original da marca d'água. Por exemplo, se você definir Width como 44 e a proporção original for 2:1, Height será 22.
- Se você especificar tanto a largura quanto a altura: As dimensões da marca d'água assumirão os valores especificados.
- Se você não especificar Dx e Dy, o valor padrão será 0.

Etapa 2: Criar e associar um grupo de modelos de transcodificação

A aplicação de marca d'água em vídeo ocorre por meio de transcodificação. As tarefas de transcodificação são iniciadas com base em grupos de modelos de transcodificação. É possível associar vários modelos de marca d'água a um único modelo de transcodificação.

Console

Faça login no console do ApsaraVideo VOD.
No painel de navegação à esquerda, escolha Configuration Management > Media Processing > Transcoding Template Groups.
Clique em Create Transcoding Template Group.
Defina um nome para o grupo de modelos de transcodificação.
Na seção Regular Transcoding Template ou Packaging Template, clique em Add Template, configure os parâmetros de transcodificação e ative a marca d'água.
- Watermark Template: Selecione um ou mais modelos de marca d'água criados na Etapa 1.
- Mantenha os outros parâmetros com seus valores padrão ou altere-os conforme as necessidades do seu negócio. Para mais informações sobre os parâmetros e sugestões de configuração, consulte Modelos de transcodificação.
Clique em Save para criar o grupo de modelos de transcodificação.

Após criar o grupo de modelos de transcodificação, visualize o grupo e seu ID na página Transcoding Template Groups.

API

Chame a API CreateTranscodeTemplateGroup para criar um grupo de modelos de transcodificação. No parâmetro TranscodeTemplateList, passe o ID do modelo de marca d'água no parâmetro WatermarkIds para associar o modelo.

Etapa 3 (Opcional): Criar e associar um fluxo de trabalho

Organize várias tarefas de processamento de mídia, como transcodificação, revisão de conteúdo e captura de snapshots, em um fluxo de trabalho. Ao acionar o fluxo de trabalho durante o carregamento ou processamento de mídia, o sistema processa automaticamente os arquivos de acordo com as tarefas definidas. Crie fluxos de trabalho exclusivamente no console. Para mais informações, consulte Fluxos de trabalho.

Console

Faça login no console do ApsaraVideo VOD.
No painel de navegação à esquerda, escolha Configuration Management > Media Processing > Workflows.
Clique em Add Workflow.
Insira um nome para o fluxo de trabalho.
Adicione ou edite nós na topologia do fluxo de trabalho.

Por exemplo, para adicionar um nó Transcode , no nó Start, clique em + e selecione Transcode . Clique no botão de edição do nó Transcode , personalize o Node Name conforme necessário e defina Transcoding Template Groups como o grupo de modelos de transcodificação criado na Etapa 2 e associado a um modelo de marca d'água.
Clique em OK para criar o fluxo de trabalho.

Após criar o fluxo de trabalho, visualize-o e seu ID na página Workflows.

Etapa 4 (Opcional): Configurar notificações de eventos

Recomendamos configurar notificações de eventos para o ApsaraVideo VOD antes de iniciar uma tarefa de transcodificação. Assim, você recebe mensagens de callback com o status e os resultados da tarefa. Para obter informações sobre como configurar notificações de eventos, consulte Notificações de eventos.

Os tipos de notificação de eventos relacionados à transcodificação são:

Etapa 5: Iniciar uma tarefa de marca d'água

Acione a transcodificação no ApsaraVideo VOD durante o carregamento ou processamento de mídia. Inicie a transcodificação usando um grupo de modelos de transcodificação ou um fluxo de trabalho que contenha um nó de transcodificação de mídia.

Console

Cenário 1: Acionar automaticamente uma tarefa de marca d'água durante o carregamento

Faça login no console do ApsaraVideo VOD.
No painel de navegação à esquerda, escolha Media Files > Audio/Video.
Clique em Upload Audio/Video, clique em Add Audio/Video, selecione parâmetros como método de carregamento e endereço de armazenamento e, em seguida, selecione Use Transcoding Template Group e especifique o grupo de modelos de transcodificação com marca d'água ativada criado na Etapa 2. Alternativamente, selecione Use Workflow e especifique o fluxo de trabalho com um nó de transcodificação com marca d'água ativada criado na Etapa 3.

Para mais informações sobre formatos suportados e descrições de parâmetros para carregamentos, consulte Carregar arquivos usando o console do ApsaraVideo VOD.
Adicione os vídeos a serem carregados e clique em Upload.

Após o carregamento, os vídeos são transcodificados automaticamente com base no grupo de modelos de transcodificação ou fluxo de trabalho especificado.

Cenário 2: Acionar manualmente uma tarefa de marca d'água para um vídeo carregado

Faça login no console do ApsaraVideo VOD.
No painel de navegação à esquerda, escolha Media Files > Audio/Video.
Na página Audio/Video, localize o vídeo para o qual deseja iniciar a transcodificação e clique em Processing na coluna Actions.
Selecione Use Transcoding Template Group e especifique o grupo de modelos de transcodificação com marca d'água ativada criado na Etapa 2. Alternativamente, selecione Use Workflow e especifique o fluxo de trabalho com um nó de transcodificação com marca d'água ativada criado na Etapa 3.
Clique em OK.

API

Cenário 1: Acionar automaticamente uma tarefa de marca d'água durante o carregamento

Nota

A operação CreateUploadVideo obtém apenas uma URL de carregamento, credenciais e informações básicas do ativo de mídia. Ela não carrega o arquivo em si; implemente a lógica de carregamento. Para um exemplo completo de como carregar um arquivo usando uma API, consulte Carregar arquivos de mídia usando a API do ApsaraVideo VOD.

Ao chamar a API Obter endereço e credenciais de carregamento de áudio/vídeo ou carregamento em lote e pull a partir de URL para carregar um arquivo de áudio/vídeo, defina o parâmetro TemplateGroupId como o ID do grupo de modelos de transcodificação com marcas d'água de imagem e texto ativadas criado na Etapa 2. Ou defina o parâmetro WorkflowId como o ID do fluxo de trabalho que contém um nó de transcodificação de mídia com marcas d'água de imagem e texto ativadas criado na Etapa 3. Após o carregamento do arquivo de áudio/vídeo, o sistema VOD transcodifica automaticamente o arquivo com base no grupo de modelos de transcodificação ou fluxo de trabalho especificado.

Cenário 2: Acionar manualmente uma tarefa de marca d'água para um vídeo carregado

Inicie a transcodificação usando um grupo de modelos de transcodificação: Chame a API Enviar uma tarefa de transcodificação de mídia e defina o parâmetro TemplateGroupId como o ID do grupo de modelos de transcodificação criado na Etapa 2 com marca d'água de imagem e texto ativada.
Para iniciar uma tarefa de transcodificação usando um fluxo de trabalho, chame a API Enviar uma tarefa de fluxo de trabalho VOD e defina o parâmetro WorkflowId como o ID do fluxo de trabalho da Etapa 3 que contém um nó de transcodificação de mídia com marcas d'água de imagem e texto ativadas.

Etapa 6: Visualizar os resultados

Receber notificações assíncronas

Se você configurou notificações de eventos, obtenha informações sobre a tarefa de marca d'água e transcodificação recebendo mensagens de callback para StreamTranscodeComplete ou TranscodeComplete.

Realizar consultas síncronas

Usar o console

Faça login no console do ApsaraVideo VOD.
No painel de navegação à esquerda, escolha Media Files > Audio/Video.
Na página Audio/Video, visualize o Status do vídeo alvo.

Se o Status do vídeo for Normal, a tarefa de marca d'água e transcodificação foi concluída com sucesso.
Clique em Manage na linha do vídeo para acessar a página de informações básicas.
Clique na aba Video URL. Nesta aba, visualize os fluxos transcodificados do vídeo e obtenha suas URLs de reprodução.

Usar a API

Verifique o status de execução e os resultados de uma tarefa de transcodificação consultando periodicamente o ID da tarefa. Use as seguintes operações:

Exemplos de uso

Esta seção descreve como configurar marcas d'água para casos de uso comuns, utilizando os recursos do ApsaraVideo VOD para definir múltiplas marcas d'água e substituir dinamicamente o conteúdo da marca d'água pela API.

Marcas d'água de texto dinâmicas

Cenário

Em aplicativos de vídeos curtos, quando os usuários baixam ou compartilham o vídeo de outro usuário, ele geralmente inclui o logotipo da plataforma de vídeos curtos e o ID ou apelido do criador original.

Resultado esperado

Adiciona-se uma marca d'água de imagem e uma marca d'água de texto. O conteúdo da marca d'água de texto difere para cada usuário.

文字水印特效

Procedimento

Crie dois modelos de marca d'água: um modelo de marca d'água de imagem com o logotipo da plataforma de vídeos curtos como imagem da marca d'água e um modelo de marca d'água de texto com o ID ou apelido do criador original como texto da marca d'água. Para mais informações, consulte Etapa 1: Criar um modelo de marca d'água.
Crie um grupo de modelos de transcodificação e associe os dois modelos de marca d'água criados na etapa anterior. Para mais informações, consulte Etapa 2: Criar e associar um grupo de modelos de transcodificação.
Substitua o conteúdo de texto de um modelo de marca d'água chamando a API Submit Media Transcoding Job e passando o WatermarkId e Content no parâmetro OverrideParams.
- Exemplo de passagem de parâmetros para OverrideParams: {"Watermarks":[{"WatermarkId":"The template ID of the image watermark"},{"WatermarkId":"The template ID of the text watermark","Content":"The text content of the watermark"}]}
- Projete a lógica de acionamento para tarefas de transcodificação com base nos requisitos do seu negócio. Por exemplo, acione a transcodificação quando um usuário carregar um vídeo e substitua automaticamente o conteúdo da marca d'água de texto pelo ID ou apelido do criador original.

Marcas d'água de imagem dinâmicas

Cenário

Um site de vídeos obtém os direitos autorais principais de um filme ou programa de TV e depois sublicencia para outros sites de vídeos. Nesse cenário, os vídeos distribuídos em cada site devem exibir o logotipo da marca desse site.

Resultado esperado

Usa-se uma marca d'água de imagem diferente para cada site de vídeos.

Procedimento

Chame a operação CreateUploadAttachedMedia para carregar as imagens da marca d'água (os logotipos da marca de cada site de vídeos) no ApsaraVideo VOD. Para mais informações sobre como carregar arquivos, consulte Carregar arquivos de mídia usando a API do ApsaraVideo VOD.
Crie um modelo de marca d'água de imagem e defina o logotipo da marca do site de vídeos como a imagem da marca d'água. Para mais informações, consulte Etapa 1: Criar um modelo de marca d'água.
Crie um grupo de modelos de transcodificação e associe o modelo de marca d'água de imagem criado na etapa anterior. Para mais informações, consulte Etapa 2: Criar e associar um grupo de modelos de transcodificação.
Para substituir a imagem de um modelo de marca d'água, chame a API Submit Media Transcoding Jobs e passe o WatermarkId e FileUrl no parâmetro OverrideParams.
- Exemplo de parâmetro OverrideParams: {"Watermarks":{"WatermarkId":"Replace with the ID of the image watermark template","FileUrl":"Replace with the URL of the replacement watermark image"}}
- Projete a lógica de acionamento para tarefas de transcodificação com base nos requisitos do seu negócio. Por exemplo, acione a transcodificação quando um vídeo for carregado.

Perguntas frequentes

Erro "Invalid image URL" ao adicionar marcas d'água

Se você configurou um nome de domínio acelerado no ApsaraVideo VOD, configure um certificado SSL para o nome de domínio. Para mais informações, consulte Ativar aceleração segura HTTPS.

Documentos relacionados

Para exibir o apelido ou ID de um usuário em tempo real durante a reprodução como forma de dissuasão contra infrações, use o recurso de letreiro do SDK do ApsaraVideo Player. Para mais informações, consulte Componentes oficiais.