Para usar o ApsaraVideo Real-time Communication, crie um aplicativo que suporte recursos como chamadas, bate-papo e reuniões.
Criar um aplicativo do ApsaraVideo Real-time Communication
Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, clique em .
Clique em Create Application.
Selecione Billing Method como Pay-by-duration ou Monthly 95th Percentile.
Insira um Instance Name personalizado, aceite os Terms of Service e clique em Purchase.
-
Após a exibição da mensagem de sucesso, atualize a página ApsaraVideo Real-time Communication > Applications para visualizar o aplicativo de co-streaming criado.
NotaA criação do aplicativo é gratuita. A cobrança ocorre no modelo de pagamento conforme o uso, com base no consumo real de recursos cloud. Para mais informações, consulte Preços do ApsaraVideo Real-time Communication.
Configurar ingestão de stream por bypass
Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, clique em . Selecione o aplicativo desejado e clique em Manage.
-
Clique em Stream Relay. Configure o Stream Relay de uma das seguintes formas:
-
Mode 1: Relay of Specified Streams
Chame a operação CreateLiveMixJob (New) para configurar o Stream Relay em tempo real (com mixagem de streams) de um canal específico para o ApsaraVideo Live ou uma plataforma de terceiros. Essa opção exige um pequeno desenvolvimento no lado do servidor.
-
Mode 2: Global Stream Relay to ApsaraVideo Live
Ao ativar a ingestão de stream por bypass, os fluxos de áudio e vídeo são enviados ao servidor de origem do centro de live da Alibaba Cloud. Em seguida, use o nome de domínio de reprodução para configurar recursos como transcodificação, gravação e snapshots, ou faça o pull da stream ao vivo para visualização.
Ative a chave do Stream Relay.
-
Configure os parâmetros de ingestão.
Parâmetro
Opções de configuração
Descrição
Stream Relay
On ou Off
Ao ativar a ingestão de stream única, todos os fluxos de áudio e vídeo são enviados ao ApsaraVideo Live por padrão. Ainda é possível atualizar o layout de mixagem de streams usando o kit de desenvolvimento de software (SDK) ou operações de API no servidor.
Streaming Domain
Exemplo: play.example.com
Domínio de streaming para os fluxos ingeridos no ApsaraVideo Live. Use este nome de domínio para reproduzir streams ao vivo e configurar funcionalidades como transcodificação e gravação.
Nota-
Caso não possua um domínio de streaming, acesse o console de Domain Names para adicionar um.
-
Domínios de streaming não suportam Real-Time Streaming (RTS) com latência entre 400 ms e 600 ms. O uso de RTS causa falha na ingestão.
AppName
Até 255 caracteres. Suporta dígitos, letras maiúsculas e minúsculas, hifens (-), sublinhados (_) e sinais de igual (=).
O valor padrão é "live". Personalize este valor conforme necessário.
O AppName presente na URL de streaming após a ingestão. Para mais informações, consulte Gerar URLs de streaming.
NotaPara associar modelos de transcodificação, gravação ou snapshot à stream ingerida, defina este AppName como idêntico ao AppName definido no modelo para que a configuração tenha efeito.
SEI Insertion
-
Inserir SEI em intervalos regulares: insere quadros de Supplemental Enhancement Information (SEI) em um intervalo especificado. Defina o intervalo entre 1000 ms e 5000 ms.
-
Inserir SEI em I-frames: insere dados SEI nos I-frames do fluxo de vídeo.
A Supplemental Enhancement Information (SEI) insere informações básicas do usuário, como IDs de usuário (UIDs) e parâmetros de layout de mixagem, diretamente na stream via SEI do sistema. Por exemplo, em cenários de co-streaming, quando o layout de mixagem muda, o aplicativo do espectador pode analisar as informações de layout do SEI em tempo real para ajustar a interface interativa. Para mais detalhes, consulte Formato da Supplemental Enhancement Information (SEI).
NotaSe você não tiver um domínio de streaming no console Domain Names, adicione um primeiro. Para mais informações, consulte Adicionar um nome de domínio.
-
-
Formato da Supplemental Enhancement Information (SEI)
|
Tipo de dado |
Nome do parâmetro |
Valor |
|
Informações do fluxo de vídeo |
stream |
Informações do streamer: uid: o ID de usuário do streamer. |
|
Informações de layout da área da janela do streamer. Observe os seguintes parâmetros:
|
Por exemplo, se um layout de mixagem for aplicado a dois usuários com UIDs 111 e 222, a mensagem SEI terá o seguinte formato:
{"stream":[{"uid":"111","paneid":0,"zorder":1,"x":0,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":1,"vad":119},{"uid":"222","paneid":1,"zorder":1,"x":0.5018382,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":60,"vad":123}]}
Eventos de callback
O ApsaraVideo Real-time Communication oferece eventos de callback para canais, usuários, ingestão de stream por bypass e mixagem de streams. Configure esses eventos diretamente no console.
Introdução aos callbacks
Os eventos de callback permitem que seu servidor de negócios receba alterações de status em tempo real referentes a canais, usuários, ingestão por bypass e mixagem de streams:
Callbacks de canal: eventos como criação ou encerramento de um canal.
Callbacks de usuário: eventos como entrada ou saída de um usuário do canal, troca de função, início ou parada de ingestão ou pull de stream.
Callbacks de bypass e mixagem: eventos relacionados ao Stream Relay.
Para mais informações sobre callbacks de canal e usuário, consulte Assinar callbacks de mensagens de canal. Para detalhes sobre callbacks de bypass e mixagem, consulte Assinar eventos de mixagem e ingestão de streams.
Criar uma tarefa de callback
Callbacks de canal e usuário
Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, clique em .
Localize o aplicativo para o qual deseja criar a tarefa de callback e clique em Manage para acessar a página de gerenciamento do aplicativo.
No painel de navegação à esquerda, escolha Callbacks > Channel and User Callbacks e clique em Create Task.
-
Defina os parâmetros de callback conforme descrito na tabela abaixo:
Parâmetro
Descrição
Callback URL
Endereço do seu servidor de negócios destinado a receber mensagens de callback. Os protocolos HTTP e HTTPS são suportados. Recomendamos o uso de HTTPS.
Event Scope
Os eventos de callback incluem User events e Channel events.
-
Eventos de usuário abrangem:
-
Entrada no canal
-
Início de compartilhamento de tela
-
Saída
-
Parada de ingestão de vídeo
-
Troca de função
-
Parada de ingestão de áudio
-
Início de ingestão de vídeo
-
Parada de compartilhamento de tela
-
Início de ingestão de áudio
-
-
Eventos de canal abrangem:
-
Canal iniciado
-
Canal encerrado
-
Specified Channel
Opcional. Se nenhum canal for especificado, os callbacks serão gerados para eventos de todos os canais por padrão. Ao definir um canal específico, os callbacks serão acionados apenas para eventos nesse canal.
Specified User
Opcional. Aplica-se exclusivamente a eventos de usuário. Se você especificar um ID de usuário, também deverá informar um ID de canal. Insira até 20 IDs de usuário, separados por vírgulas (,).
-
Clique em OK para criar a tarefa.
Callbacks de bypass e mixagem de streams
Faça login no console do ApsaraVideo Live.
No painel de navegação à esquerda, clique em .
Localize o aplicativo para o qual deseja criar a tarefa de callback e clique em Manage.
No painel de navegação à esquerda, escolha Callbacks > Mixed-stream Relay Callbacks e clique em Configure.
-
Defina os parâmetros de callback conforme a tabela a seguir:
Parâmetro
Descrição
Webhook address
Endereço do seu servidor de negócios para recebimento de mensagens de callback. Suporta HTTP e HTTPS. Recomendamos o uso de HTTPS.
Channel scope
Opcional. Especifique os canais (ChannelIDs) dos quais deseja receber callbacks. Limite de até 20 canais, separados por vírgulas (,). Cada ID pode conter letras maiúsculas, minúsculas, dígitos, sublinhados (_) e hifens (-), com comprimento máximo de 64 caracteres. Se deixado em branco, os callbacks de todos os canais serão recebidos por padrão.
Editar e excluir registros de callback
Callbacks de canal e usuário
Após criar uma tarefa de callback de canal e usuário, atualize-a ou exclua-a.
Acesse a página Channel and User Callbacks e localize a tarefa que deseja atualizar ou excluir.
Na coluna Actions, clique em Edit para modificar a tarefa ou em Delete para removê-la.
Callbacks de bypass e mixagem de streams
Após configurar os callbacks de bypass e mixagem, altere ou remova essas definições.
Quando a tarefa de callback de relay e mixagem estiver configurada, o status exibirá Configured. Gerencie a tarefa pelas ações Modify Configuration, Delete e Callback Example. A página também mostra a URL de callback configurada e o escopo do canal (como All Channels).
Visualizar registros de callback
Quando uma tarefa de callback se torna ativa, visualize os detalhes dos eventos nos registros de callback.
Esses registros mantêm dados de sucesso ou falha dos últimos 7 dias. Filtre os registros por período (Today, Last 3 Days, Last 7 Days, Custom) e por Callback ID. Os registros incluem os seguintes campos:
Callback ID
Callback Time
Callback Content
Callback URL
Request Result
Clique na aba Callback Records para filtrar por período (Today, Last 3 Days, Last 7 Days ou Custom) e consultar o Callback Time, Callback Content, Callback URL e Request Result.