Create dynamic images from video - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Introdução

Uma imagem dinâmica cria a sensação de movimento ao exibir rapidamente uma série de imagens estáticas. Os formatos mais comuns na web são GIF e, em menor escala, WebP. A criação de uma animação de quadros envolve extrair um segmento específico de um vídeo e gerar um arquivo de imagem dinâmica.

O ApsaraVideo VOD oferece suporte aos formatos GIF e WebP para animações de quadros. A tabela a seguir compara esses dois formatos.

Formato	Recursos
GIF	Oferece alta compatibilidade e uso frequente na decoração de páginas da web.
WebP	Apresenta tamanho de arquivo muito menor que o GIF, mas alguns navegadores não oferecem suporte, incluindo Internet Explorer, iOS Safari 3.2 a 13,7 e KaiOS Browser.

Casos de uso

Compartilhamento em redes sociais: crie GIFs a partir dos melhores momentos do vídeo para compartilhamento rápido ou use uma animação de quadros como resumo atraente para incentivar os usuários a assistirem ao vídeo completo.
Promoção de marketing: utilize imagens dinâmicas com destaques do vídeo em anúncios para despertar o interesse do usuário, melhorar as taxas de cliques e aumentar a conversão. Em sites de e-commerce, essas imagens podem destacar recursos do product ou demonstrar seu funcionamento.
Reportagens e entretenimento: editores de notícias costumam capturar momentos-chave de eventos como imagens dinâmicas para apresentar informações importantes de forma concisa. Trailers de filmes ou destaques de programas também podem ser lançados como imagens dinâmicas para visualização rápida.
Demonstrações educacionais: em cursos on-line, professores podem usar imagens dinâmicas para explicar conceitos ou etapas complexas, ajudando os alunos a compreender e memorizar o conteúdo com mais eficiência.

Faturamento

A animação de quadros é cobrada como transcodificação de mídia, com custos baseados na resolução e na duração. Para mais informações, consulte Faturamento de transcodificação de mídia.

Observações de uso

A geração da animação de quadros pode falhar se o arquivo de mídia contiver apenas áudio sem fluxo de vídeo, se o arquivo source estiver corrompido ou se os metadados do contêiner forem inválidos.
A criação da animação de quadros é um processo assíncrono. Verifique o status do trabalho por meio do callback DynamicImageComplete.
O tempo necessário para criar uma animação de quadros depende do tamanho do arquivo, da duração do arquivo e da duração da animação.

Pré-requisitos

O ApsaraVideo VOD deve estar ativado. Para mais informações, consulte Ativar o ApsaraVideo VOD.
O usuário ram ou a função ram utilizada deve ter as permissões correspondentes para acessar o ApsaraVideo VOD. Recomendamos o uso de um usuário ram ou função ram para realizar operações, aumentando a segurança da sua conta e dos seus recursos. Para mais informações, consulte Criar e conceder permissões a um usuário RAM.

Etapa 1: Criar um modelo de animação de quadros

Os modelos de animação de quadros simplificam o envio de trabalhos, pois permitem pré-configurar parâmetros e referenciar um ID de modelo em vez de informá-los individualmente a cada execução.

Console

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

Clique em Create Frame Animation Template. Na página Add Frame Animation Template, configure os parâmetros do modelo.

Parâmetro	Descrição
Nome do modelo	Nome do modelo de animação de quadros. Deve ter entre 4 e 64 caracteres e pode conter letras maiúsculas, minúsculas, dígitos, hifens (-) e sublinhados (_).
Formato de saída	Formato da imagem dinâmica de saída. Valores válidos: gif e webp.
Taxa de quadros	Taxa de quadros da imagem dinâmica. Número inteiro no intervalo (0, 60].
Tamanho (largura × altura)	Largura e altura da imagem dinâmica, em pixels. Nota Se você não especificar largura e altura, a imagem dinâmica terá as mesmas dimensões do vídeo source. Se você especificar apenas a largura ou a altura, o ApsaraVideo VOD ajustará automaticamente a outra dimensão para manter a proporção original do vídeo.
Modo de corte	Método usado para definir o intervalo de tempo do vídeo a ser capturado. Opções suportadas: By Duration ou Trim from Beginning and End.
Hora de início	Hora inicial para captura da animação. O valor deve estar entre 0,000 e 86.399,999, inclusive. Unidade: segundos.
Duração	Duração da animação a ser capturada, a partir da Hora de Início. O valor deve estar entre 0,000 e 86.399,999, inclusive. Unidade: segundos. Nota Este parâmetro é obrigatório quando By Duration estiver definido como By Duration.
Cortar do final	Duração a ser cortada do final do vídeo. O valor deve estar entre 0,000 e 86.399,999, inclusive. Unidade: segundos. Nota Este parâmetro é obrigatório quando Trim from Beginning and End estiver definido como Trim from Beginning and End.
Definir como capa padrão	Ao ativar este recurso, a animação de quadros gerada é definida automaticamente como a imagem de capa do vídeo.

Clique em Save para concluir a configuração do modelo.

Após a criação, o modelo aparece na lista Frame animation templates. A lista exibe informações como Template name, ID, Output format, frame rate, size (width × height), trim mode e Set as default cover. Na coluna Actions, você pode Edit ou Delete o modelo. Clique em Add frame animation template para criar um novo.

API

Chame a operação AddVodTemplate, defina o parâmetro TemplateType como DynamicImage e personalize outros parâmetros para criar um modelo de animação de quadros.

Após a criação do modelo, o sistema retorna um ID de modelo no campo VodTemplateId.

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

Antes de iniciar um trabalho de animação de quadros, configure uma notificação de evento para DynamicImageComplete a fim de receber o status do trabalho e a URL da animação de quadros gerada após a conclusão da tarefa.

Para mais informações, consulte Configurar callbacks.

Etapa 3: Iniciar um trabalho de animação de quadros

Console

Crie um workflow que inclua um nó de Frame Animation Template.

É necessário usar um workflow para iniciar um trabalho de animação de quadros no console do ApsaraVideo VOD. Crie um workflow que inclua uma tarefa de animação de quadros adicionando um nó de Frame Animation Template e definindo o modelo de animação de quadros como aquele criado na Etapa 1. Para mais informações sobre como criar um workflow, consulte Gerenciar workflows.
Inicie o trabalho de animação de quadros.
- Cenário 1: criar uma animação de quadros durante o upload de um vídeo
  1. No console do ApsaraVideo VOD, escolha Media Files > Audio/Video no painel de navegação à esquerda.
  2. Clique em Upload Media.
  3. Configure o método de upload e o local de armazenamento, adicione seu vídeo, selecione Use Workflow e, em seguida, selecione o workflow que contém o trabalho de animação de quadros.
  4. Clique em Upload.
- Cenário 2: criar uma animação de quadros após o upload do vídeo
  1. No console do ApsaraVideo VOD, escolha Media Files > Audio/Video no painel de navegação à esquerda.
  2. Na página Audio/Video, localize o vídeo desejado e clique em Processing na coluna Actions.
  3. Defina Processing Type como Use Workflow e selecione o workflow que contém o trabalho de animação de quadros na lista suspensa Workflow.
  4. Clique em OK.

API

Cenário 1: criar uma animação de quadros durante o upload de um vídeo
1. Crie um workflow que contenha um nó de Frame Animation Template.
  
  Adicione um nó de Frame Animation Template ao workflow e defina o modelo de animação de quadros como aquele criado na Etapa 1. Para mais informações sobre como criar um workflow, consulte Gerenciar workflows.
2. Ao chamar uma operação de API de upload de mídia, defina o parâmetro WorkflowId como o ID do workflow recém-criado. Configure outros parâmetros conforme necessário para concluir o upload. As operações de API relevantes incluem:
  - CreateUploadVideo
  - UploadMediaByURL
Cenário 2: criar uma animação de quadros após o upload do vídeo

Chame a operação SubmitDynamicImageJob. Defina o parâmetro DynamicImageTemplateId como o ID do modelo criado na Etapa 1 e configure outros parâmetros conforme necessário para iniciar um trabalho de animação de quadros para um vídeo específico.

Etapa 4: Obter informações da animação de quadros

(Recomendado) Se você configurou notificações de eventos, receberá um callback DynamicImageComplete com as informações da animação.
Após a conclusão do trabalho de animação de quadros, chame a operação ListDynamicImage para recuperar os detalhes da animação gerada.

Nota

Se você definiu a animação de quadros como capa, chame a operação GetVideoInfo para obter a URL da animação de capa.