Todos os produtos
Search
Central de documentação

ApsaraVideo Live:Gerenciamento de aplicativos do ApsaraVideo Real-time Communication

Última atualização: Jul 16, 2026

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

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

  2. No painel de navegação à esquerda, clique em Live + > ApsaraVideo Real-time Communication > Applications.

  3. Clique em Create Application.

  4. Selecione Billing Method como Pay-by-duration ou Monthly 95th Percentile.

  5. Insira um Instance Name personalizado, aceite os Terms of Service e clique em Purchase.

  6. 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.

    Nota

    A 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

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

  2. No painel de navegação à esquerda, clique em Live + > ApsaraVideo Real-time Communication > Applications. Selecione o aplicativo desejado e clique em Manage.

  3. Clique em Stream Relay. Configure o Stream Relay de uma das seguintes formas:

    1. 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.

    2. 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.

      1. Ative a chave do Stream Relay.

      2. 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.

        Nota

        Para 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).

        Nota

        Se 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:

  • paneid: o ID da área na janela. Valores válidos: [0,8].

  • zorder: o nível de empilhamento da área. Valores válidos: [0,99].

  • x: a coordenada x da área no canvas. Representada como porcentagem normalizada.

  • y: a coordenada y da área no canvas. Representada como porcentagem normalizada.

  • w: a largura da área. Representada como porcentagem normalizada.

  • h: a altura da área. Representada como porcentagem normalizada.

  • vol: o volume do streamer em decibéis. Valores válidos: [0,255].

  • vad: detecção de atividade de voz (VAD). O valor 150 indica detecção de voz. Qualquer outro valor indica o tempo residual desde a detecção até a ausência de voz.

Nota

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

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

  2. No painel de navegação à esquerda, clique em Live + > ApsaraVideo Real-time Communication > Applications.

  3. 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.

  4. No painel de navegação à esquerda, escolha Callbacks > Channel and User Callbacks e clique em Create Task.

  5. 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 (,).

  6. Clique em OK para criar a tarefa.

Callbacks de bypass e mixagem de streams

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

  2. No painel de navegação à esquerda, clique em Live + > ApsaraVideo Real-time Communication > Applications.

  3. Localize o aplicativo para o qual deseja criar a tarefa de callback e clique em Manage.

  4. No painel de navegação à esquerda, escolha Callbacks > Mixed-stream Relay Callbacks e clique em Configure.

  5. 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.

  1. Acesse a página Channel and User Callbacks e localize a tarefa que deseja atualizar ou excluir.

  2. 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.