Gravação automática no Amazon S3 - Amazon IVS

Gravação automática no Amazon S3

Você tem a opção de habilitar a gravação de um canal. Se o recurso de registro automático no S3 estiver ativado, todas as transmissões do canal serão gravadas e salvas em um bucket de armazenamento do Amazon S3 de sua propriedade. Posteriormente, a gravação fica disponível para reprodução sob demanda.

Configurar isso é uma opção avançada. Por padrão, a gravação é desabilitada quando um canal é criado.

Para configurar um canal para gravação, é necessário criar uma recording-configuration. Este é um recurso que especifica um local do Amazon S3 em que as transmissões gravadas para o canal são armazenadas. É possível criar e gerenciar configurações de gravação usando o console ou a CLI; os dois procedimentos são apresentados abaixo. Depois de criar a configuração de gravação, associe-a a um canal ao criar o canal (conforme descrito abaixo) ou posteriormente, atualizando um canal existente. (Na API, consulte CreateChannel e UpdateChannel.) Você pode associar vários canais à mesma configuração de gravação. É possível excluir uma configuração de gravação que não esteja mais associada a nenhum canal.

Lembre-se das seguintes restrições:

  • É necessário ser proprietário do bucket do S3. Ou seja, a conta que configura um canal a ser gravado deve ser proprietária do bucket do S3 onde as gravações serão armazenadas.

  • O canal, a configuração de gravação e o local do S3 devem estar na mesma região da AWS. Se você criar canais em outras regiões e quiser gravá-los, também deverá configurar as configurações de gravação e os buckets do S3 nessas regiões.

Para gravar em seu bucket do S3, é necessária autorização com suas credenciais da AWS. Para conceder ao IVS o acesso necessário, uma função vinculada a serviço (SLR) do AWS IAM é criada automaticamente quando a configuração de gravação é criada: o SLR é limitado para conceder permissão de gravação ao IVS somente no bucket específico.

Observe que problemas de rede entre o local de streaming e a AWS ou na AWS podem resultar em alguma perda de dados durante a gravação do seu stream. Em casos como este, o Amazon IVS prioriza o stream ao vivo em relação à gravação. Para obter redundância, grave de forma local por meio da sua ferramenta de streaming.

Para obter mais informações (inclusive como configurar o pós-processamento ou a reprodução de VOD em seus arquivos gravados), consulte Gravação automática do IVS no Amazon S3 | Streaming de baixa latência.

Como desabilitar a gravação

Para desabilitar a gravação do Amazon S3 em um canal existente:

  • No console: na página de detalhes do canal relevante, na seção referente à gravação e armazenamento de streams, selecione Disabled (Desabilitado) e, em seguida, Save Channel (Salvar canal). Isso suspende a associação da configuração de gravação do canal; os streams nesse canal não serão mais gravados.

  • Na CLI: execute o comando update-channel e o submeta no ARN de configuração de gravação como uma string vazia:

    aws ivs update-channel --arn "arn:aws:ivs:us-west-2:123456789012:channel/abcdABCDefgh" --recording-configuration-arn ""

    Isso retorna um objeto de canal com uma string vazia para recordingConfigurationArn, indicando que a gravação está desabilitada.