As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como inserir metadados em um stream de vídeo

Os metadados cronometrados do Amazon Interactive Video Service (IVS) fornecem uma maneira de incorporar metadados em uma transmissão do Amazon IVS. Ele garante que todos os visualizadores recebam os metadados ao mesmo tempo no stream de vídeo, independentemente da latência ou da localização geográfica do stream.

O que são metadados cronometrados?

Metadados cronometrados são aqueles com carimbos de data/hora. Eles podem ser inseridos em um stream de forma programática, usando a API do IVS ou o SDK de Transmissão do IVS. Quando o Amazon IVS processa um stream, os metadados cronometrados são sincronizados com os quadros de áudio e vídeo. Durante a reprodução, todos os visualizadores do stream obtêm os metadados ao mesmo tempo em relação ao stream. O código de tempo serve como um ponto de sinalização, que pode ser usado para acionar uma ação com base nos dados, como o seguinte:

Os metadados cronometrados do Amazon IVS usam tags ID3 incorporadas nos segmentos de vídeo. Como resultado, eles estão disponíveis no vídeo gravado.

Configurar permissões do IAM

Pré-requisito: antes de prosseguir, você deve ter passado por Conceitos básicos do streaming de baixa latência do IVS (incluindo a criação de um usuário do IAM e a configuração de permissões).

Em seguida, você deve dar permissão ao usuário do IAM para usar metadados cronometrados. Siga estas etapas:

Inserir metadados cronometrados

Você pode inserir metadados cronometrados somente em um stream ativo em um canal especificado.

Usar a AWS CLI

Para testes, a maneira mais fácil de adicionar metadados cronometrados é com a AWS CLI. O uso da AWS CLI requer que você primeiro faça o download e configure a CLI em sua máquina. Você pode já ter feito isso quando você passou por Conceitos básicos do streaming de baixa latência do IVS; se não, faça isso agora. Para obter mais detalhes, consulte o Guia do usuário da Interface de Linhas de Comando da AWS.

Depois de ter a CLI:

Usando a API do Amazon IVS

Para inserir programaticamente metadados cronometrados, use o endpoint da API PutMetadata.

Veja um exemplo de solicitação HTTP:

POST /PutMetadata HTTP/1.1
{
    "channelArn": "my_channel",
    "metadata": "{\"question\": \"What does IVS stand for?\", \"correctIndex\": 0, \"answers\": [\"interactive video service\", \"interesting video service\", \"ingenious video service\"]}"
}

Usar o SDK de Transmissão do IVS

Você pode inserir metadados sincronizados inband usando o SDK de Transmissão do IVS. Isso pode ser útil para sincronizar os metadados com o conteúdo de áudio e vídeo.

Consumir metadados cronometrados

Use o Player do Amazon IVS para consumir metadados cronometrados incorporados em um stream de vídeo. Consulte SDK do Amazon IVS Player e o resto da documentação do Player.

Veja abaixo trechos de exemplo que imprimem quaisquer metadados recebidos no console usando o SDK do Player do Amazon IVS. Um evento é acionado sempre que a reprodução atinge um segmento com metadados incorporados. (O evento é TEXT_METADATA_CUE para Web, onCue() para Android, e player(_:didOutputCue:) para iOS.) Você pode usar esse evento para iniciar a funcionalidade em sua aplicação cliente, como atualizar um widget interativo. Este evento é acionado para conteúdo ao vivo e gravado.

SDK do Amazon IVS Player para Web:

const player = IVSPlayer.create();
player.addEventListener(IVSPlayer.PlayerEventType.TEXT_METADATA_CUE,
    function (cue) {
  console.log('Timed metadata: ', cue.text);
});

SDK do Amazon IVS Player para Android:

@Override
public void onCue(@NonNull Cue cue) {
  if(cue instanceof TextMetadataCue) {
    Log.i("Timed Metadata: ", ((TextMetadataCue)cue).text);
  }
}

SDK do Amazon IVS Player para iOS:

func player(_ player: IVSPlayer, didOutputCue cue: IVSCue) {
  if let textMetadataCue = cue as? IVSTextMetadataCue {
    print("Timed Metadata: \(textMetadataCue.text)")
  }
}

Observação: metadados cronometrados são compatíveis com iOS Safari e iOS Chrome no Player 1.3.0 e posteriores.

Amostra de demonstração: aplicação de teste

Exemplos de código de uma aplicação de teste interativo estão disponíveis no GitHub. Usamos JSON por meio de metadados cronometrados para preencher uma interface do usuário do teste para exibir perguntas e respostas. As respostas são selecionáveis e revelam se a seleção está correta.

Exibir metadados cronometrados

Se desejar, você pode visualizar os metadados cronometrados incorporados em sua transmissão ao vivo, no console:

Para obter mais informações

Consulte Como usar metadados cronometrados do Amazon Interactive Video Service, a primeira de uma série de blogs de duas partes sobre o uso de metadados cronometrados do Amazon IVS.