ApsaraVideo Live:Gravação

Como funciona

Durante a gravação, o sistema processa o stream ao vivo ingerido segmentando-o em arquivos Transport Stream (TS) e empacotando-os no formato de destino, como FLV, MP4 ou M3U8. Os arquivos finais são salvos no espaço de armazenamento especificado.

A gravação de transmissões ao vivo altera apenas o formato do contêiner de áudio e vídeo, sem modificar o conteúdo na camada de codificação. Se o stream de origem apresentar problemas, como artefatos de vídeo ou dessincronização entre áudio e vídeo, o arquivo gravado manterá essas falhas.

Formatos de codificação de áudio e vídeo

Como a gravação de transmissões ao vivo primeiro segmenta o stream em arquivos TS, o formato de codificação deve ser compatível com o contêiner TS. O ApsaraVideo Live suporta apenas os seguintes formatos de codificação:

• Codecs de vídeo: H.264 (AVC), H.265 (HEVC), MPEG-4

• Codecs de áudio: AAC, MP3

Caso o stream ao vivo contenha áudio ou vídeo codificados em outros formatos, poderão ocorrer problemas como falha na gravação, tela preta no arquivo gravado ou ausência de áudio.

Comparação dos métodos de armazenamento

A gravação de transmissões ao vivo oferece duas opções de armazenamento: ApsaraVideo VOD e OSS. Não é possível configure ambas as opções para o mesmo stream ao vivo. Escolha uma delas com base nos requisitos do seu negócio.

Gravação automática

O ApsaraVideo Live utiliza modelos de gravação para gerenciar as configurações. O sistema associa um modelo de gravação automática com base nos parâmetros DomainName, AppName e StreamName presentes na URL de ingestão.

Lógica de correspondência

• Correspondência exata: Especifique um AppName e um StreamName específicos no modelo de gravação. Essa configuração aplica o modelo apenas àquele stream ao vivo específico.

• Correspondência por curinga: Defina AppName como * no modelo para aplicá-lo a todos os aplicativos sob o domínio. Defina StreamName como * para aplicar o modelo a todos os streams ao vivo dentro do aplicativo.

• Limite de modelo com curinga: Quando tanto AppName quanto StreamName estiverem definidos como *, apenas um modelo de gravação com curinga é permitido por domínio. Se o envio falhar no console, verifique se já existe um modelo com curinga para esse domínio. Para alterar a configuração, edite o modelo existente em vez de crie um novo.

Confirmação por callback

Utilize a gravação sob demanda para decidir dinamicamente se um stream ao vivo deve ser gravado, com base nas regras do seu negócio.

Fluxo de trabalho:

1. Quando um stream ao vivo inicia, se o modelo de gravação correspondente estiver definido como "On-demand recording", o service de transmissão ao vivo envia uma solicitação HTTP para a URL de callback sob demanda pré-configurada, a fim de determinar se o stream deve ser gravado.

2. Sua aplicação recebe a solicitação e retorna um comando de gravação (permitir ou negar) com base na lógica de negócios atual.

3. O service de transmissão ao vivo inicia a tarefa de gravação conforme sua resposta.

Especifique previamente a URL de callback sob demanda para gravação de streams ao vivo nas configurações de callback de eventos. Para obter detalhes sobre configuração, parâmetros de solicitação e formato de resposta, consulte Live stream recording callbacks e On-demand recording callbacks.

Observação:

O service de gravação processa a resposta do callback para substituir as configurações do modelo:

• Interval: O valor de intervalo fornecido substitui o ciclo de gravação configurado no modelo.

• Format: O service calcula a interseção entre o formato solicitado e os formatos pré-configurados no modelo. Se não houver formatos comuns, o stream não será gravado.

• Callback frequency: Para um único stream ao vivo, o callback de gravação sob demanda envia a solicitação HTTP de confirmação apenas uma vez, no momento em que o stream começa a ser enviado. Essa solicitação não é reenviada mesmo que o formato de armazenamento seja M3U8 ou que o stream seja desconectado e reconectado durante a transmissão.

Acionamento por parâmetro de ingestão

Quando o método de acionamento estiver definido como "Ingest parameter settings", controle a ativação da gravação para o stream atual utilizando o parâmetro record_config na URL de ingestão.

• Formato do parâmetro: record_config={"NeedRecord": <true/false>}

• Descrição do parâmetro: true: Ativa a gravação. false: Desativa a gravação.

• Nota: Codifique o parâmetro para URL durante a construção da URL.

• Limitações: Este modo de acionamento suporta apenas o controle da gravação do stream bruto. Streams transcodificados não podem ser gravados através deste método. Para gravar streams transcodificados, selecione outro modo de acionamento, como Automatic, Callback Confirmation ou Manual.

Suponha que a URL de ingestão do stream seja: rtmp://push.example.com/live/stream1

Para ativar a gravação via parâmetros, construa a URL da seguinte forma: rtmp://push.example.com/live/stream1?record_config=%7B%22NeedRecord%22%3Atrue%7D&auth_key=xxx

Gravação manual

Para ter controle total sobre o processo de gravação com base na lógica do seu negócio, utilize a gravação manual.

Neste cenário, chame a API RealTimeRecordCommand para iniciar manualmente a gravação de um stream ao vivo específico.

Essa API também permite interromper uma gravação. Chame essa interface para forçar a parada da tarefa de gravação atual, independentemente de ter sido iniciada automaticamente, sob demanda ou manualmente.

Consulte a documentação da API RealTimeRecordCommand e utilize o parâmetro command para executar a operação start ou stop.

Pré-requisitos

Ative o service ApsaraVideo VOD e configure um storage bucket. O bucket deve estar na mesma região do centro de transmissão ao vivo do domínio que você deseja configure.

Configuração

O ApsaraVideo Live utiliza modelos de gravação para gerenciar as configurações. Crie um modelo de gravação para armazenar os arquivos no ApsaraVideo VOD através do console ou de uma API.

// Parameter settings for API request
AddLiveRecordVodConfigRequest.RecordFormat recordFormat0 = AddLiveRecordVodConfigRequest.RecordFormat.builder()
        .format("m3u8")
        .sliceDuration(30)
        .autoCompose("ON")
        .videoProcess("origin,compose")
        .processMethod("transcode")
        .processTemplateId("e2d796d3bb5fd8049d32bff62f94****")
        .tags("sports")
        .build();

AddLiveRecordVodConfigRequest addLiveRecordVodConfigRequest = AddLiveRecordVodConfigRequest.builder()
        .regionId("<Your RegionID>")
        .domainName("<Your DomainName>")
        .appName("live")
        .streamName("stream1")
        .cycleDuration(3600)
        .spaceId("app-1000000")
        .storageLocation("<Your StorageLocation>")
        .onDemand(0)
        .recordContent("raw,transcode")
        .delayTime(180)
        .recordFormat(java.util.Arrays.asList(recordFormat0))
        .transcodeTemplates(java.util.Arrays.asList("sd"))
        // Request-level configuration rewrite, can set Http request parameters, etc.
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

Gerenciar gravações

Visualize as gravações armazenadas no ApsaraVideo VOD pelo console do ApsaraVideo Live e gerencie-as utilizando o service ApsaraVideo VOD.

1. Faça login no console do ApsaraVideo Live.

2. No painel de navegação à esquerda, selecione Feature Management > Recording. Clique na aba Recording Management.

3. Selecione o domínio de streaming configurado.

4. Clique na aba VOD.

   Filtre os registros de gravação por intervalo de datas, AppName e StreamName.

5. Para visualize e gerenciar arquivos de gravação específicos, clique em Manage in the VOD Console na coluna Actions, ou faça login no console do ApsaraVideo VOD e selecione Media Library > Audio/Video.

Pré-requisitos

1. Ative o service OSS e crie um storage bucket. O bucket do OSS deve estar na mesma região do centro de transmissão ao vivo do domínio que você deseja configure.

2. Configure as permissões para que o ApsaraVideo Live possa gravar no OSS. Geralmente, essa autorização ocorre automaticamente ao ativar o service. Caso tenha excluído a permissão acidentalmente, clique em Authorize Access to Cloud Resources para concedê-la novamente.

Configuração

O ApsaraVideo Live utiliza modelos de gravação para gerenciar as configurações. Crie um modelo de gravação para armazenar os arquivos no OSS através do console ou de uma API.

Após configure o modelo, reinicie o stream de ingestão para que as alterações tenham efeito. Para garantir que um stream seja gravado desde o início, crie o modelo antes que o stream comece.

// Parameter settings for API request
AddLiveAppRecordConfigRequest.TranscodeRecordFormat transcodeRecordFormat0 = AddLiveAppRecordConfigRequest.TranscodeRecordFormat.builder()
        .sliceDuration(30)
        .sliceOssObjectPrefix("transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{UnixTimestamp}_{Sequence}")
        .ossObjectPrefix("transcodeRecord/{AppName}/{StreamName}_{TranscodeTemplateID}/{EscapedStartTime}_{EscapedEndTime}")
        .cycleDuration(900)
        .format("m3u8")
        .build();

AddLiveAppRecordConfigRequest.RecordFormat recordFormat0 = AddLiveAppRecordConfigRequest.RecordFormat.builder()
        .sliceDuration(30)
        .format("m3u8")
        .cycleDuration(900)
        .sliceOssObjectPrefix("record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}")
        .ossObjectPrefix("record/{AppName}/{StreamName}/{Sequence}_{EscapedStartTime}_{EscapedEndTime}")
        .build();

AddLiveAppRecordConfigRequest addLiveAppRecordConfigRequest = AddLiveAppRecordConfigRequest.builder()
        .domainName("<Your DomainName>")
        .appName("live")
        .ossEndpoint("<Your OssEndpoint>")
        .ossBucket("<Your OssBucket>")
        .streamName("stream1")
        .onDemand(0)
        .delayTime(180)
        .recordFormat(java.util.Arrays.asList(recordFormat0))
        .transcodeRecordFormat(java.util.Arrays.asList(transcodeRecordFormat0))
        .transcodeTemplates(java.util.Arrays.asList("sd"))
        // Request-level configuration rewrite, can set Http request parameters, etc.
        // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
        .build();

Gerenciar gravações

Configure um domínio CDN

Para acelerar a distribuição dos seus vídeos gravados, configure um domínio CDN. O CDN distribui os vídeos para vários nós, permitindo que os usuários acessem o conteúdo a partir do nó mais próximo em vez da origem no OSS. Isso melhora a velocidade de acesso e reduz custos de rede. Para operações específicas, consulte Accelerate access to OSS by using Alibaba Cloud CDN.

Geração e disponibilidade de gravações

Mecanismo de geração

O arquivo de gravação não é gerado imediatamente após a desconexão de um stream. O sistema aguarda a duração de emenda para streams interrompidos (o padrão é 180 segundos). Se o stream for retomado dentro desse período, a gravação é anexada ao arquivo existente. Caso contrário, o sistema considera que o stream terminou e gera o arquivo de gravação.

Ajuste essa duração conforme necessário, mas recomendamos manter a configuração padrão. Uma duração menor pode resultar em numerosos arquivos pequenos devido a flutuações de rede, enquanto uma duração maior implica uma espera mais longa pelo arquivo após o término do stream.

Geração imediata

Para gerar o arquivo de gravação imediatamente após o término de um stream, sem o atraso de emenda, configure um callback de evento para o stream de ingestão (consulte Event callbacks). Ao receber a notificação de desconexão do stream, chame a API RealTimeRecordCommand para cancele o atraso de emenda.

realTimeRecordCommandRequest.setCommand("cancel_delay");

Visualizando gravações em andamento

Se a duração de um stream não tiver excedido o ciclo de gravação, o arquivo geralmente é gerado após o término do stream. Para acesse o arquivo de gravação atual antes do fim do stream, chame a API RealTimeRecordCommand para atualizar a gravação. Esse comando encerra forçadamente o processo de gravação atual, gera o arquivo imediatamente e inicia automaticamente uma nova gravação.

realTimeRecordCommandRequest.setCommand("restart");

Se a gravação do seu stream estiver configurada com múltiplos formatos de armazenamento, esta operação atualizará todos eles.

Impacto de anomalias do stream na gravação

O sistema lida com anomalias do stream de maneiras diferentes, dependendo da gravidade:

• Stream padrão (atende aos requisitos de codificação com taxa de quadros e timestamp estáveis): As gravações são geradas com sucesso em 100% dos casos.

• Stream com problemas menores (flutuações ocasionais na taxa de quadros ou saltos de timestamp): O sistema lida automaticamente com esses problemas para garantir compatibilidade.

• Stream com problemas graves (ausência prolongada de quadros de vídeo, timestamps desordenados ou falta de keyframes): Não é possível garantir o sucesso da gravação.

Solução de problemas de arquivos de gravação

Se os arquivos de gravação não forem gerados ou contiverem conteúdo inesperado, verifique os seguintes pontos:

• Configuração de gravação não entra em vigor — Os modelos de gravação aplicam-se apenas a novos streams enviados após a conclusão da configuração. Se um stream já estava sendo transmitido quando o modelo foi criado, desconecte e reenvie o stream para que o modelo tenha efeito.

• Stream transcodificado não é gravado — Verifique se o método de acionamento da transcodificação está definido como "push-triggered". Se estiver definido como "pull-triggered", o stream transcodificado será gerado apenas quando um visualizador solicitar ativamente o stream. Sem uma solicitação ativa, o stream transcodificado não existe e, portanto, não pode ser gravado.

• Segmentos duplicados na reprodução — Isso geralmente ocorre quando um stream se desconecta e reconecta dentro da duração de emenda. Os segmentos sobrepostos são incluídos na gravação. É necessária edição de pós-produção para remover as partes duplicadas.

• Tela preta com áudio em alta resolução — Verifique o seguinte no lado do push: se a fonte de compartilhamento de tela está sendo capturada corretamente, se as configurações do codificador correspondem à resolução alvo e se o player suporta o formato de codificação. Esse problema geralmente é causado pela configuração do lado do push, e não pelo service de gravação.

• Sem registros de callback do OSS — Verifique se o destino de armazenamento está definido como OSS. O ApsaraVideo VOD utiliza eventos de callback diferentes do OSS. Se a gravação estiver armazenada no ApsaraVideo VOD, verifique os eventos de callback do ApsaraVideo VOD.

• Nome do arquivo de gravação não corresponde ao esperado — Ao armazenar gravações no ApsaraVideo VOD, o nome do arquivo de gravação assume como padrão o StreamName e não suporta personalização. Se precisar de nomes de arquivos personalizados, utilize o armazenamento OSS e configure a convenção de nomenclatura no modelo de gravação.

Como obtenho o VideoId de um arquivo de gravação armazenado no ApsaraVideo VOD e quais são as limitações de autenticação de callback?

• Obtendo o VideoId: O callback de gravação de transmissão ao vivo não inclui o VideoId. Para obter o VideoId, configure uma notificação de callback de evento no lado do ApsaraVideo VOD. O callback do VOD inclui informações completas do ativo de mídia, incluindo o VideoId. Se você já configurou um callback de evento do VOD, não é necessário configure também um callback de gravação de transmissão ao vivo.

• Limitação de autenticação de callback: A autenticação de callback de conclusão de gravação (que depende dos parâmetros ALI-LIVE-TIMESTAMP e ALI-LIVE-SIGNATURE) atualmente não é suportada quando a gravação é armazenada no ApsaraVideo VOD. Se o console mostrar a opção de autenticação como indisponível ou falhar ao salve, trata-se de uma limitação conhecida ou um problema de exibição, e o callback do lado do VOD deve ser considerado a fonte autoritativa.