Todos os produtos
Search
Central de documentação

ApsaraVideo Live:Primeiros passos com o ApsaraVideo Live

Última atualização: Jul 14, 2026

Quando um apresentador inicia uma transmissão ao vivo, os espectadores recebem uma notificação e podem entrar para assistir. Este tópico simplifica o processo de integração para ajudar você a criar rapidamente um aplicativo de transmissão ao vivo com o ApsaraVideo Live.

Conceitos principais

Antes de começar, familiarize-se com os conceitos principais do ApsaraVideo Live:

Antes de começar

Antes de iniciar, crie uma conta e adicione fundos conforme as instruções. Para mais informações, consulte Ativar e adquirir o ApsaraVideo Live.

Preparar uma conta

  1. Se você ainda não tem uma conta Alibaba Cloud, siga as instruções na tela na página de Registro para criar uma. Uma conta Alibaba Cloud, que é a entidade pagadora dos seus recursos cloud, é obrigatória para este tutorial.

  2. Este service suporta dois métodos de faturamento: pay-as-you-go e resource plan.

    • Para um teste rápido, recomendamos o método de faturamento pay-as-you-go. Se o tráfego de teste não ultrapassar 10 GB, o custo estimado será de aproximadamente USD 0,42.

      Nota

      Esta estimativa não inclui taxas de registro de domínio, certificados SSL ou registro ICP. O custo final pode variar com base em fatores como região e método de faturamento. Os preços exibidos no console e na fatura final prevalecem.

    • Antes de usar este service, garanta que sua conta tenha saldo suficiente .

Visão geral do fluxo de trabalho

image
  1. Adicionar domínios de ingestão e streaming: O ApsaraVideo Live é um service baseado em domínios. Nesta etapa, prepare seus domínios e configure-os no console do ApsaraVideo Live.

  2. Configurar um registro CNAME para ativar a aceleração de transmissão ao vivo: Vincule seu domínio personalizado a um nome de domínio acelerado atribuído pela Alibaba Cloud para ativar o service rápido e estável do ApsaraVideo Live.

  3. Associar domínios de ingestão e streaming: Transmissões ao vivo geralmente usam dois domínios separados. Associe seu domínio de ingestão ao seu domínio de streaming.

  4. Gerar URLs de ingestão e streaming: Use o gerador de URL para criar URLs de ingestão e streaming a partir dos domínios configurados.

  5. Ingerir e reproduzir um stream: Esta etapa mostra como ingerir um stream com o aplicativo de demonstração do ApsaraVideo Live e reproduzi-lo com o VLC media player.

Etapa 1: Adicionar domínios de ingestão e streaming

Para usar o ApsaraVideo Live, é necessário ter pelo menos um nome de domínio. O domínio de ingestão e o domínio de streaming não podem ser iguais, mas podem ser dois subdomínios diferentes do mesmo domínio raiz.

Por exemplo, se seu domínio raiz for test.com, configure dois subdomínios, a.test.com e b.test.com, para usar como domínios de ingestão e streaming, respectivamente.

  1. Prepare seus nomes de domínio.

    • Caso não possua um nome de domínio, registre um na plataforma Alibaba Cloud Domains. Para mais informações, consulte Registrar um nome de domínio na Alibaba Cloud.

    • Após registrar um nome de domínio, talvez seja necessário solicitar um registro ICP dependendo do uso. Para mais informações, consulte Procedimento de registro ICP.

      Nota
      • Para testar rapidamente os recursos básicos do ApsaraVideo Live, selecione uma região do centro de transmissão fora da China continental e defina a região de aceleração como Outside Chinese Mainland. Nesse caso, não é necessário registro ICP para o seu nome de domínio.

      • Se o domínio de ingestão e o domínio de streaming forem dois subdomínios do mesmo domínio raiz, basta obter um registro ICP para o domínio raiz.

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

  3. No painel de navegação à esquerda, clique em Domain Names. A página Domain Management será exibida.

  4. Clique em Add Domain.

    Nota

    Para adicionar um subdomínio, adicione um prefixo ao seu nome de domínio registrado. Não é necessário registrar um subdomínio separadamente. Certifique-se de distinguir entre o domínio de ingestão e o domínio de streaming.

  5. Configure os parâmetros necessários do nome de domínio.

    Importante

    Ao adicionar um nome de domínio ao ApsaraVideo Live pela primeira vez, é obrigatório verificar sua propriedade. Para mais informações, consulte Verificar propriedade do domínio.

    Show parameters

    Parameter

    Value

    Description

    Domain Type

    • Streaming Domain

    • Ingest Domain

    O tipo de aceleração para o nome de domínio. Um domínio de ingestão acelera a ingestão de streams, enquanto um domínio de streaming acelera a entrega de streams. Não é possível alterar essa configuração após defini-la.

    Nota
    • Ao adicionar um domínio de ingestão, defina Domain Type como Ingest Domain. Ao adicionar um domínio de streaming, defina Domain Type como Streaming Domain.

    • Não é possível usar o mesmo nome de domínio como domínio de ingestão e de streaming simultaneamente.

    Domain Name

    N/A

    Insira o nome de domínio a ser acelerado. Observe o seguinte:

    • Use um subdomínio para o nome de domínio acelerado, como demo.aliyundoc.com.

    • O ApsaraVideo Live não suporta nomes de domínio curinga, como *.aliyundoc.com.

    • Um nome de domínio acelerado deve ser único. Se receber a mensagem The specified domain already exists, verifique se o nome de domínio já não está sendo usado em outro service da Alibaba Cloud, como o ApsaraVideo VOD.

    • Após ativar o ApsaraVideo Live, é possível adicionar até 20 nomes de domínio por conta. Se a largura de banda média diária de pico dos seus domínios exceder 50 Mbps e seu negócio estiver livre de riscos, envie um ticket para solicitar aumento de cota. Para mais informações, consulte Contact Us.

    • Todo o conteúdo acelerado deve cumprir os requisitos legais e padrões comerciais. Para detalhes, consulte Domain name review standards.

    Nota

    O subdomínio deve pertencer à mesma conta Alibaba Cloud. O ApsaraVideo Live verifica isso ao adicionar o nome de domínio. Se o subdomínio pertencer a uma conta diferente, o sistema reportará um erro.

    Acceleration Region

    Chinese Mainland

    • Selecione Chinese Mainland para o domínio de ingestão se seus transmissores estiverem localizados na China Continental.

    • Selecione Chinese Mainland para o domínio de streaming se seus espectadores estiverem localizados na China Continental.

    O nome de domínio requer um registro ICP. Recomendamos usar o Alibaba Cloud ICP Filing system para solicitar um registro ICP.

    Global

    • Selecione Global para o domínio de ingestão se seus transmissores estiverem localizados mundialmente, incluindo na China Continental.

    • Selecione Global para o domínio de streaming se seus espectadores estiverem localizados mundialmente, incluindo na China Continental.

    O nome de domínio requer um registro ICP. Recomendamos usar o Alibaba Cloud ICP Filing system para solicitar um registro ICP.

    Outside Chinese Mainland

    • Selecione Outside Chinese Mainland para o domínio de ingestão se seus transmissores estiverem localizados fora da China Continental.

    • Selecione Outside Chinese Mainland para o domínio de streaming se seus espectadores estiverem localizados fora da China Continental.

    • Se você selecionar Outside Chinese Mainland e o centro de transmissão também estiver fora da China Continental, não será necessário registro ICP para o seu nome de domínio.

    • Se você selecionar Outside Chinese Mainland, mas o centro de transmissão estiver na China Continental, será necessário um registro ICP para o seu nome de domínio. Recomendamos usar o Alibaba Cloud ICP Filing system para solicitar um registro ICP.

    Nota

    Para mais informações sobre como selecionar uma região de aceleração, consulte How do I select an acceleration region for a domain name?.

    Live Center

    N/A

    Um centro de transmissão fornece services de processamento de mídia baseados em cloud, como captura de snapshot, gravação, transcodificação e estúdio de produção.

    O domínio de ingestão e seu domínio de streaming associado devem usar a mesma região do centro de transmissão. Não é possível alterar essa configuração após defini-la.

    Para mais informações sobre como selecionar um centro de transmissão, consulte How do I select a live center?.

  6. Anote o valor do registro CNAME gerado para a próxima etapa.

    Após adicionar o domínio, uma tabela de configuração aparece. Essa tabela inclui o domínio de streaming, tipo de registro (CNAME), nome do host e valor do registro CNAME. Adicione esse valor de registro CNAME no seu provedor de DNS para ativar a aceleração CDN. Também é possível clicar em CNAME Configuration Guide para concluir a configuração.

Etapa 2: Configurar um registro CNAME

Para ativar a aceleração, aponte seu domínio para o endereço CNAME atribuído pelo ApsaraVideo Live. O exemplo a seguir mostra como fazer isso com o Alibaba Cloud DNS.

Nota
  • O Alibaba Cloud CDN valida registros DNS usando servidores implantados na China continental. Se você configurar resolução regional de DNS para seu domínio, por exemplo, configurando o endereço CNAME do Alibaba Cloud CDN apenas para regiões fora da China continental (incluindo Hong Kong, Macau, Taiwan e outros países e regiões), os servidores de validação não conseguirão resolver o endereço CNAME. Nesse caso, o status CNAME do domínio no console CDN será exibido como Pending Configuration. Isso não afeta o service de aceleração CDN.

  • Os nomes de domínio CNAME para Alibaba Cloud CDN, DCDN, ApsaraVideo Live e ApsaraVideo VOD só podem ser usados para agendamento e resolução do Alibaba Cloud CDN. A Alibaba Cloud reserva-se o direito de suspender os nomes de domínio e contas correspondentes em caso de uso malicioso dos nomes de domínio CNAME.

  1. Faça login no Alibaba Cloud DNS.

  2. No painel de navegação à esquerda, escolha Authoritative DNS Resolution para acessar a página de resolução de nomes de domínio.

  3. Localize o nome de domínio desejado e clique em Settings na coluna Actions.

  4. Clique em Add Record e configure os seguintes parâmetros:

    Parameter

    Description

    Record type

    Selecione CNAME Record para apontar o nome de domínio para outro nome de domínio.

    Hostname

    Insira o prefixo do nome de domínio. Para prefixos comuns e seus nomes de domínio de exemplo correspondentes, consulte a tabela a seguir.

    Query source

    Mantenha o valor padrão.

    Record value

    Insira o valor CNAME para o registro.

    TTL

    Mantenha o valor padrão.

    Prefix

    Example domain

    Description

    demo

    demo.aliyundoc.com

    Resolver um subdomínio.

    @

    aliyundoc.com

    Resolver um domínio raiz.

    *

    *.aliyundoc.com

    Realizar resolução de DNS curinga.

  5. Clique em OK para concluir a configuração do CNAME.

Verificar o registro CNAME

  • Método 1: Na página Add CNAME Record, clique em CNAME Configuration Guide. Na seção CNAME Verification, clique em Verify para verificar se a configuração do CNAME entrou em vigor.

  • Método 2: Execute o comando nslookup -type=cname yourdomain.com. Se o resultado da resolução retornada corresponder ao valor CNAME do domínio no console do ApsaraVideo Live, a configuração do CNAME entrou em vigor.

    C:\Users\xxx>nslookup -type=cname xxx
    Server:  xxx
    Address:  xxx
    Non-authoritative answer:
    xxx    canonical name = cxxx.cdngslb.com
    C:\Users\xxx>

(Opcional) Configurar um certificado SSL

Devido aos requisitos de segurança dos navegadores nativos, se você precisar reproduzir transmissões ao vivo em um navegador, deverá configurar um certificado SSL para os domínios de ingestão e streaming. Para mais informações, consulte Configurar streaming seguro via HTTPS.

Etapa 3: Associar os domínios de ingestão e streaming

O ApsaraVideo Live usa ingestão de borda, portanto, é necessário associar os domínios de ingestão e streaming para ativar a ingestão e reprodução de streams.

  1. No painel de navegação à esquerda, clique em Domain Names. Localize seu domínio de streaming e clique em Domain Settings na coluna Actions para acessar a página Streaming Management > Basic Settings.

  2. Clique na aba Stream Ingest Information.

  3. Clique em Add Stream Ingest Information ou no ícone de edição ao lado de Ingest Domain para selecionar o domínio de ingestão que deseja associar. Na caixa de diálogo Ingest Domain que aparece, selecione um domínio de ingestão existente na lista suspensa Ingest Domain e clique em OK. Se precisar adicionar um novo domínio de ingestão, adicione-o primeiro na página Domain Management.

Etapa 4: Gerar URLs de ingestão e streaming

URLs de ingestão e streaming são URLs baseadas em domínio usadas para enviar e receber uma transmissão ao vivo. Siga estas etapas para gerá-las no console:

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

  2. No painel de navegação à esquerda, escolha Toolbox.

  3. Na aba Live URL Generator, configure os parâmetros para obter as URLs de ingestão e streaming. Também é possível escanear o código QR para obter as URLs. Após concluir a configuração, clique em Generate URLs. Na seção Ingest URL, as URLs de ingestão são exibidas nos formatos RTMP (começa com rtmp://) e RTS (começa com artc://). No final de cada linha, clique no botão de cópia ou escaneie o código QR para obter a URL.

    A tabela a seguir descreve os parâmetros. Para mais informações, consulte Geradores de URL.

    Parameter

    Description

    Streaming Domain

    Selecione o domínio de streaming adicionado na Etapa 1 na lista suspensa Streaming Domain.

    Authentication

    Este parâmetro aparece após selecionar um Streaming Domain. O padrão é Tipo A.

    Nota
    • Este parâmetro é exibido se a assinatura de URL estiver configurada para o domínio de ingestão ou streaming.

    • Para modificar parâmetros como o período de validade da assinatura, consulte URL signing.

    • O Tipo A é um mecanismo de assinatura baseado em timestamp e assinatura.

    Ingest Domain

    • Para cenários padrão de transmissão ao vivo:

      • Se você já associou os domínios de ingestão e streaming na Etapa 3, este campo será preenchido automaticamente com o domínio de ingestão associado após selecionar um Streaming Domain.

      • Se você não associou os domínios de ingestão e streaming, faça isso primeiro.

    • Para cenários apenas de recebimento (pull), pule esta configuração; não é necessário selecionar um domínio de ingestão associado.

    AppName

    Insira um AppName. Trata-se de um identificador personalizado usado para diferenciar diferentes aplicativos de transmissão ao vivo ou cenários de negócios.

    StreamName

    Insira um StreamName. É um identificador personalizado usado para identificar exclusivamente uma transmissão ao vivo específica.

    Transcoding Template

    Selecione um Transcoding Template que você configurou. Se este parâmetro for deixado vazio, a qualidade original do stream será usada por padrão.

    Nota

    Um modelo de transcodificação deve ser configurado usando o recurso de transcoding. Após selecionar um domínio de streaming e inserir o AppName usado na configuração de transcodificação, os modelos de transcodificação correspondentes a esse AppName serão carregados.

  4. Clique em Generate URLs para obter as URLs de ingestão e streaming. Para exemplos e descrições das URLs, consulte Gerar URLs de transmissão ao vivo.

Etapa 5: Ingerir e reproduzir um stream

Nota

Se encontrar problemas durante a ingestão ou reprodução de streams, use a ferramenta de solução de problemas de autoatendimento para realizar diagnósticos. Essa ferramenta diagnostica rapidamente problemas comuns de transmissão ao vivo e fornece soluções. Para mais informações, consulte Solução de problemas.

Ingerir um stream

A ingestão de stream é o processo de envio de áudio e vídeo encapsulados da fase de captura para o centro do ApsaraVideo Live. Este exemplo mostra como ingerir um stream usando o aplicativo de demonstração do ApsaraVideo Live.

  1. Escaneie o código QR no seu dispositivo móvel para instalar o aplicativo de demonstração do ApsaraVideo Live.

    image

    Nota

    Se vir uma mensagem "Untrusted Enterprise Developer" no seu dispositivo iOS, acesse Settings > General > VPN & Device Management, localize o perfil Taobao e toque em Trust.

  2. Execute o aplicativo de demonstração do ApsaraVideo Live.

  3. Escolha Camera Pushing ou Screen Sharing. A interface principal oferece três opções: Camera Pushing, Screen Sharing e Live Playback. Camera Pushing e Screen Sharing são as opções de ingestão.

    Nota

    Ao ingerir vídeo local de um dispositivo móvel, apenas o formato YUV original da imagem de vídeo é suportado.

  4. Escaneie o código QR da URL de ingestão assinada da Etapa 4 para preencher o campo de URL ou insira a URL manualmente. Na aba Ingest Parameters, defina a Resolution (por exemplo, 540p), ative Adaptive Bitrate e Adaptive Resolution conforme necessário, ou expanda Advanced Settings para mais opções. Por exemplo, a URL poderia ser rtmp://demo.aliyundoc.com/app/stream?auth_key=**********-0-0-9c6e7c8190c10bdfb3c0************.

  5. Clique em Ingest para começar a ingerir do seu dispositivo móvel.

  6. Acesse Stream Management e visualize e gerencie os streams de áudio e vídeo enviados na aba Active Streams.

Nota

Para outros métodos de ingestão, consulte Ingestão de stream ao vivo.

Reproduzir uma transmissão ao vivo

A reprodução de transmissão ao vivo é o processo de distribuição de conteúdo do centro do ApsaraVideo Live para um player. Este exemplo mostra como reproduzir um stream com o VLC media player.

  1. Baixe e instale o VLC media player. Link para download: VLC media player.

  2. Execute o VLC media player.

  3. Na barra de menus, escolha Media > Open Network Stream...

  4. Na aba Network, insira uma URL de streaming. Exemplo: rtmp://example.aliyundoc.com/app/stream?auth_key=1543300311-0-0-d47ce016332bf280cf275********.

  5. Clique em Play.

Nota
  • O cliente de ingestão deve manter o stream durante a reprodução ao vivo. Caso contrário, a reprodução falhará.

  • Para outros métodos de reprodução, consulte Reprodução de stream ao vivo.

Referências

FAQ