Como adicionar um modelo de snapshot - ApsaraVideo VOD: Central de Documentação do Alibaba Cloud

Comparação dos métodos de snapshot

Os métodos de snapshot incluem Normal Snapshot, WebVTT e Image Sprite. Para obter mais informações, consulte Snapshots de vídeo.

Método de snapshot	Cenários	Vantagens e desvantagens
Normal Snapshot	Miniaturas de vídeo, moderação de conteúdo e compartilhamento de destaques.	Vantagens: Alta flexibilidade. Ideal para cenários que exigem imagens individuais. Desvantagens: A geração de muitos snapshots cria grande volume de arquivos e requisições HTTP, o que pode afetar o desempenho de carregamento.
WebVTT	Exibição de miniaturas ao passar o mouse sobre a barra de progresso de players web ou H5.	Vantagens: Compatível com visualizações de miniatura nas barras de progresso de players web e H5. Desvantagens: Finalidade específica. Não serve como imagem independente.
Sprite	Cenários que exigem visualizações de miniatura em clientes móveis ou players com altos requisitos de desempenho de carregamento.	Vantagens: Reduz o número de requisições HTTP. Otimiza o desempenho de carregamento no frontend. Recomendado para cenários móveis. Desvantagens: Configuração relativamente complexa. As miniaturas individuais dentro do sprite não podem ser referenciadas diretamente.

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

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

Importante

Não é possível alterar o método de snapshot (Normal Snapshot, WebVTT ou Sprite) após a criação do modelo. Confirme sua seleção antes de salvar.

Os parâmetros a seguir se aplicam a todos os métodos de snapshot.

Parâmetro	Descrição
Template Name	Nome personalizado do modelo para identificação e referência em fluxos de trabalho.
Start Time	Momento em que o processo de snapshot começa (HH:MM:SS).
Number of Snapshots	Quantidade de snapshots a gerar.
Snapshot Interval	Intervalo de tempo entre os snapshots. Se definido como 0 ou deixado em branco, os snapshots serão distribuídos uniformemente ao longo da duração do vídeo.
Dimensions (Width × Height)	Largura e altura do snapshot em pixels. Nota Sem definição de largura e altura, as dimensões do snapshot serão iguais às do vídeo de entrada. Ao definir apenas a largura ou a altura, a outra dimensão será ajustada proporcionalmente à taxa de proporção do vídeo para evitar distorção.
Frame Type	Tipo de quadro a capturar. As opções incluem quadros-chave e quadros regulares. Nota Ao selecionar quadros-chave, apenas eles serão capturados. Caso não exista um quadro-chave no momento especificado, o sistema selecionará o mais próximo. A captura de quadros-chave é mais rápida que a de quadros regulares.

Parâmetro	Descrição
Generate a large image	Define se as miniaturas necessárias para o WebVTT devem ser combinadas em uma única imagem grande para armazenamento.

Parâmetro	Descrição
Layout (Rows × Columns)	Largura e altura das miniaturas individuais dentro do sprite. Nota Se não for definido, as dimensões da miniatura corresponderão às de um snapshot normal. Se apenas uma dimensão for definida, a outra será dimensionada proporcionalmente.
Row Spacing	Espaçamento vertical entre as linhas de miniaturas no sprite, em pixels.
Column Spacing	Espaçamento horizontal entre as colunas de miniaturas no sprite, em pixels.
Background Color	Cor de fundo do sprite.
Keep Individual Images	Define se as imagens individuais que compõem o sprite devem ser mantidas após a geração.

Depois de criar um modelo de snapshot, adicione-o a um fluxo de trabalho para utilizá-lo durante o upload ou processamento de mídia.

Anexe o modelo a um fluxo de trabalho.

Faça login no console do ApsaraVideo VOD. No painel de navegação à esquerda, escolha Configuration Management > Media Processing > Workflows. Adicione ou edite um fluxo de trabalho. Insira um nó Snapshots no fluxo de trabalho. No painel de configuração do nó à direita, selecione o modelo de snapshot criado.
Acione o fluxo de trabalho.

Após anexar o modelo, acione o fluxo de trabalho de uma das seguintes maneiras:
1. Acionamento automático: Ao fazer upload de um arquivo de áudio ou vídeo, especifique este fluxo de trabalho. A execução ocorrerá automaticamente após o upload do arquivo. Para obter mais informações, consulte Upload de arquivos no console do ApsaraVideo VOD.
2. Acionamento manual: Na página Media Files > Audio/Video, selecione o ativo de mídia desejado, clique em Processing, selecione Use Workflow e especifique este fluxo de trabalho.
3. Acionamento por API: Chame a operação SubmitWorkflowJobs para especificar este fluxo de trabalho.
Recupere os resultados do snapshot.

Recupere os resultados do snapshot por meio de uma notificação de evento SnapshotComplete. Quando um snapshot é capturado, o sistema envia um callback para a URL configurada. O corpo da mensagem contém uma lista com os dados do snapshot.

O recurso de snapshot do ApsaraVideo VOD é gratuito.

Siga as etapas abaixo para solucionar o problema:

Confirme se o status do vídeo de entrada é Normal e se o arquivo de vídeo não está corrompido.
Verifique se os parâmetros do modelo de snapshot são válidos. Por exemplo, o horário de início não deve exceder a duração do vídeo.
Certifique-se de que os callbacks de notificação de eventos estejam configurados corretamente. Para obter mais informações, consulte Notificações de eventos.

Chame a operação SubmitSnapshotJob para iniciar um job de snapshot independentemente.