Gravações RTC
Antes da gravação
Seção intitulada “Antes da gravação”Certifique-se de que a gravação esteja incluída no RTC do espaço de trabalho plano. Informe os participantes e obtenha qualquer consentimento necessário para o seu caso de uso. Seu aplicativo deve fornecer seu próprio indicador visível de gravação e processo de obtenção de consentimento.
Os participantes já devem estar publicando as faixas que você deseja capturar quando a gravação começar. A versão atual captura essas faixas selecionadas; ela não adiciona automaticamente novos participantes ou faixas que comecem a ser publicadas posteriormente. Uma sessão silenciosa ou vazia não é um teste de gravação útil.
Grave no console
Seção intitulada “Grave no console”- Entre em uma sala aberta e publique o áudio/vídeo pretendido.
- Selecione Inicie a gravação nos controles de chamada.
- Abrir Gravações para inspecionar a tarefa. Use Atualizar para atualizar o status.
- Selecione Interromper na gravação ativa ao concluir, ou encerre a sala.
- Aguarde até que a tarefa seja
ready, em seguida, utilize os botões de download da faixa.
Sair da sua própria chamada não é o mesmo que interromper explicitamente a gravação ou encerrar a sala. Para integrações, utilize o gravação API. Para converter o áudio de uma gravação em texto, consulte transcrição.
Ciclo de vida
Seção intitulada “Ciclo de vida”| Status | Significado |
|---|---|
queued | A solicitação inicial foi aceita |
recording | A captura está ativa ou iniciando |
processing | A captura foi encerrada e a saída está sendo finalizada |
ready | Os arquivos das faixas estão disponíveis para download autorizado |
failed | A captura ou o processamento não foram concluídos com sucesso |
Apenas uma tarefa na fila, em gravação ou em processamento pode existir para uma sala por vez. Não trate um 202 uma resposta de início ou uma solicitação de parada bem-sucedida como conclusão. Utilize a lista de gravações ou o recording.ready evento.
Saída e restrições atuais
Seção intitulada “Saída e restrições atuais”A saída é faixas MKV individuais, e não um único vídeo composto da reunião. Cada faixa identifica seu tipo de mídia, fonte, participante, tamanho e ID da faixa. O suporte à reprodução varia; utilize um reprodutor compatível ou seu próprio fluxo de trabalho de processamento de mídia quando precisar de outro formato ou de um layout combinado.
A versão atual da gravação limita a captura a uma hora e aproximadamente 1 GiB por faixa. Ela não captura automaticamente faixas que entram posteriormente.
Excluir, reter ou entregar gravações
Seção intitulada “Excluir, reter ou entregar gravações”Excluir uma gravação com DELETE /v1/recordings/{recordingId}: é enviada para a Lixeira, excluída automaticamente após 30 dias, e você pode restaurá-la até lá com
POST /v1/recordings/{recordingId}/restore. Uma gravação na Lixeira ainda conta para o seu limite de armazenamento de gravações. Para removê-la definitivamente mais cedo, exclua-a da Lixeira com POST /v1/recordings/{recordingId}/purge: a RTC responde 202
(status: "deleting"), a exclusão será concluída em breve e recording.purged
são disponibilizadas a seguir.
CHAMPREP mantêm as gravações pelo período de retenção do seu plano; quando este termina, a gravação é enviada para a Lixeira da mesma forma. Nos planos que incluem esse recurso, o RTC também copia cada gravação concluída para o seu próprio bucket, e essas cópias nunca são excluídas pelo RTC. Consulte excluir uma gravação e utilize seu próprio armazenamento.
Faça o download com segurança
Seção intitulada “Faça o download com segurança”Seu backend utiliza uma chave com recordings:read para solicitar a URL de download de uma faixa selecionada. A API APIverifica o acesso da gravação e da chave ao projeto. Em seguida, retorna uma URL do domínio RTC que expira após cinco minutos.
Qualquer pessoa que possua essa URL temporária poderá utilizá-la enquanto ela permanecer válida. Não é necessário um login separado no navegador. Forneça-a apenas a um usuário que seu aplicativo tenha autorizado, ou transmita o arquivo por meio de seu próprio back-end autenticado, caso precise que cada download esteja vinculado à sessão do seu aplicativo.
- Não coloque URLs de download em páginas públicas, análises, logs ou mensagens compartilhadas.
- Recupere a URL exatamente como foi retornada, em vez de construir um caminho de objeto.
- Caso expire, solicite uma nova após verificar o acesso novamente.
- A revogação da APIchave emissora invalida suas autorizações de download pendentes.
- O download de uma cópia autorizada não torna essa cópia salva revogável.
Utilização webhooks para notificar seu aplicativo de que o processamento está concluído sem solicitar repetidamente autorizações de download.