ApsaraVideo Live screenshot feature - ApsaraVideo Live: Central de Documentação do Alibaba Cloud

O recurso Snapshots permite capturar imagens em tempo real durante a reprodução de uma transmissão ao vivo. Este tópico descreve detalhadamente o recurso de Snapshots de vídeo.

Pré-requisitos

O recurso Snapshots exige o armazenamento dos arquivos de snapshot em um bucket. Portanto, ative o service OSS e tenha pelo menos um bucket disponível para esses arquivos. Para mais informações, consulte Activate OSS Service e Create a Bucket.

Importante

O bucket deve estar na mesma região do centro de transmissão ao vivo do domínio de ingestão. Não há suporte para snapshots entre regiões.

Regras de snapshot

Configure o recurso Snapshots no nível de AppName da ingestão de fluxo. Defina regras de snapshot para todas as ingestões de fluxo associadas a um AppName específico.

Nota
Se você definir o AppName como um asterisco (*), a regra de snapshot será aplicada a todas as ingestões de fluxo sob o domínio de ingestão.
Ao configurar o recurso Snapshots, defina dois tipos de captura: snapshots com sobrescrita e snapshots em tempo real.
- No modo de sobrescrita, cada novo snapshot substitui o arquivo anterior.
- No modo em tempo real, os arquivos anteriores são preservados e cada nova captura é salva como um arquivo incremental.
- Atualmente, o recurso Snapshots gera imagens apenas no formato JPG.
  
  Nota
  Selecione ambos os modos ou pelo menos um deles.

Configuração e gerenciamento de snapshots

Nota

Um modelo de snapshot recém-configurado não se aplica a transmissões ao vivo em andamento. Reinicie a ingestão do fluxo para que as alterações entrem em vigor.

Configuração de snapshots

Configure o recurso de Snapshots de vídeo das seguintes formas:

Configurar snapshots no console

Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, selecione Feature Management > Snapshots. Na página Snapshots, clique em Snapshot Settings.
Selecione o domínio de ingestão a ser configurado.
Clique em Add.

Configure o modelo de snapshot.

A tabela a seguir descreve os parâmetros do modelo de snapshot.

Parâmetro	Descrição
Application Name	Nome da aplicação. Esta configuração só entra em vigor se o Application Name inserido corresponder ao Application Name usado na ingestão da transmissão ao vivo. Para configurar snapshots no nível do domínio, insira um asterisco (*).
Snapshot Interval	Intervalo entre as capturas de snapshot. Unidade: segundos. Valores válidos: 5 a 3600.
Storage Location	Local no OSS onde os arquivos de snapshot serão armazenados. O bucket do OSS deve estar na mesma região do centro de transmissão ao vivo do domínio de ingestão. Não há suporte para snapshots entre regiões.
Storage Mode	Dois modos de armazenamento estão disponíveis. Selecione um ou ambos. Overwrite: Os snapshots são capturados no intervalo especificado. Cada novo snapshot substitui o anterior. New: As capturas ocorrem no intervalo definido. Os novos snapshots são armazenados sequencialmente em ordem N+1, onde N ≥ 0. Nota Se ambos os modos forem selecionados, os snapshots serão gerados e armazenados das duas maneiras simultaneamente.

Nota

Após concluir a configuração, as capturas serão realizadas e armazenadas para todos os Application Name configurados neste domínio, seguindo o modelo definido.

As alterações nas configurações de snapshot entram em vigor após a próxima ingestão de fluxo.

Clique em OK.

Configurar snapshots via API

Chame a operação AddLiveAppSnapshotConfig para configurar o recurso de snapshot.

Gerenciamento de arquivos de snapshot

Visualização de snapshots

Visualize os arquivos de snapshot das seguintes formas:

Visualizar arquivos de snapshot no console

Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, selecione Feature Management > Snapshots. Na página Snapshots, selecione Snapshot Management.
Selecione o domínio e o intervalo de tempo da consulta. Em seguida, insira ou selecione o AppName e o StreamName.
Clique em Search para visualizar os snapshots dentro do intervalo de tempo selecionado. Caso não consiga visualizá-los, verifique se as permissões do bucket OSS estão definidas como public-read. Para mais informações, consulte Configure OSS bucket ACLs.

Na aba Snapshot Management, filtre snapshots por data, AppName e StreamName.
Passe o mouse sobre uma imagem para vê-la em tamanho maior ou copie a URL do snapshot.

Visualizar arquivos de snapshot via API

Chame a operação DescribeLiveStreamSnapshotInfo para visualizar os arquivos de snapshot.

Visualizar arquivos de snapshot no OSS

Durante a configuração do recurso de snapshot, você especificou o caminho de armazenamento no OSS. Para visualizar os arquivos diretamente no OSS, consulte List objects.

Exclusão de snapshots

O ApsaraVideo Live armazena apenas os metadados dos arquivos de snapshot, como AppName, StreamName e caminho de armazenamento no OSS. Os arquivos reais residem no OSS. Para excluir os arquivos no OSS simultaneamente à remoção dos registros correspondentes no ApsaraVideo Live, crie a função de service AliyunMTSVideoLifecycleRole e conceda as permissões necessárias usando a política de sistema AliyunMTSVideoLifecycleRolePolicy.

Procedimento de autorização

Antes de excluir snapshots ou gravações no console do ApsaraVideo Live, conceda as permissões necessárias. Siga estas etapas para criar e autorizar uma função do Resource Access Management (RAM) no console RAM e, em seguida, retorne ao console do ApsaraVideo Live para excluir os arquivos.

Criar uma função de service

Faça login no console RAM como administrador RAM.
No painel de navegação à esquerda, escolha Identities > Roles.
Na página Roles, clique em Create Role.
Na página Create Role, selecione Alibaba Cloud Service para Trusted Entity Type e clique em OK.

Nota
Na lista suspensa Trusted Service, selecione Media Processing.
Na caixa de diálogo Create Role, insira "AliyunMTSVideoLifecycleRole" em Role Name e clique em OK. O nome da função pode ter até 64 caracteres e conter letras, dígitos, hifens (-) e pontos (.).
Após a criação da função, na página Basic Information, clique em Permissions.
Clique em Input and Attach e configure os seguintes parâmetros:
- Tipo de permissão: Política de Sistema
- Nome da política: AliyunMTSVideoLifecycleRolePolicy
Após configurar os parâmetros, clique em OK.

Excluir arquivos de snapshot no console

Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, selecione Feature Management> Snapshots. Na página Snapshots, selecione Snapshot Management.
Selecione o domínio e o intervalo de tempo da consulta. Em seguida, insira ou selecione o AppName e o StreamName.
Passe o mouse sobre uma imagem e clique em Batch Delete para remover um único snapshot.

Para excluir vários snapshots, marque as caixas de seleção correspondentes e clique em Batch Delete. É possível excluir até 200 snapshots por vez.

Excluir arquivos de snapshot via API

Chame a operação DeleteSnapshotFiles para excluir arquivos de snapshot. Essa ação também remove os arquivos armazenados no OSS.

Configure um callback de evento para enviar informações de snapshot, incluindo carimbos de data/hora, ao seu sistema de negócios. Isso permite excluir os arquivos correspondentes com base em uma política personalizada, como limpezas periódicas. Para mais informações, consulte o guia de desenvolvimento event callback.

Documentos relacionados

Para aprender a usar o SDK Java, consulte Java SDK User Guide.

Para obter uma lista de APIs relacionadas, veja Live stream snapshot APIs.