Todos os produtos
Search
Central de documentação

ApsaraVideo Live:Solução de problemas do Push SDK

Última atualização: Jun 30, 2026

Use este guia para diagnosticar e resolver problemas comuns do Push SDK.

Referências

Navegação no console

O console do ApsaraVideo Live oferece recursos de gerenciamento de transmissões ao vivo, gerenciamento de aplicativos, central de dados e caixa de ferramentas.

  • Para obter informações sobre os recursos suportados pelo console, consulte a Visão geral dos recursos.

  • Para gerenciar suas licenças de SDK, acesse a página My Licenses no console.

  • Para saber como usar a ferramenta de solução de problemas na caixa de ferramentas, consulte Solução de problemas.

Perguntas frequentes

Suporte técnico

Se esses recursos não resolverem seu problema, entre em contato conosco para obter suporte técnico.

Inclua as seguintes informações para acelerar a resolução:

Item

Descrição

Observação

Visão geral

Descreva o problema encontrado em uma frase.

-

Descrição do problema

  1. Cenário de negócio

    Especifique o cenário de uso do SDK, como transmissão ao vivo padrão ou interativa.

  2. Informações do SDK

    Informe o tipo e a versão do SDK.

  3. Fase

    Indique quando o problema ocorre: durante a integração ou em operação.

  4. Detalhes do problema

    Descreva o problema detalhadamente: interrupção de fluxo, ausência de vídeo, falta de áudio, etc.

  5. Reprodução

    Informe se o problema é consistente ou intermitente e como reproduzi-lo.

  6. Distribuição

    Forneça a plataforma, versão do SO, modelo do dispositivo e região.

  1. Para problemas relacionados a licenças, forneça o nome do pacote do aplicativo e a License Key.

  2. Use a versão mais recente do SDK para obter melhor suporte.

Contexto

  1. Detalhes

    Forneça os detalhes do ambiente.

  2. URLs de ingestão e transmissão

    Oculte ou sanitize quaisquer informações sensíveis.

  3. Momento da ocorrência

  4. Logs de erro

    Compacte os logs, como logs do logcat ou arquivos de log.

  5. Configurações

    Podem incluir o nome do aplicativo, nome do pacote e configurações de transmissão com múltiplos apresentadores.

  6. Outras informações

    Podem incluir capturas de tela ou gravações de tela.

  1. Configure o registro de logs por meio das operações da API da classe AlivcLiveBase antes de capturar os logs. Verifique o source do aplicativo de demonstração para exemplos.

  2. Não capture logs de arquivo durante uma transmissão ao vivo.

  3. Caminhos dos logs de arquivo:

    1. Android: /sdcard/Android/data/${app_id}/files/

    2. iOS: no diretório sandbox

  4. Para transmissão com múltiplos apresentadores, forneça também:

    1. URL de ingestão do apresentador (incluindo AppID, número do canal e ID do usuário)

    2. URL de transmissão do espectador (incluindo o domínio de reprodução configurado na retransmissão de fluxo)

Informações adicionais

  1. Quaisquer mensagens de erro (se disponíveis, inclua códigos ou mensagens de erro).

  2. Se o problema se recupera automaticamente (por exemplo, via reconexão automática).

  3. Outras informações que possam ajudar a identificar o problema.

Modelo de descrição de problema

Modelo

Title: One-sentence summary of the issue.
Business scenario: Such as standard live streaming, interactive streaming, Real-Time Streaming.
SDK version: Such as AlivcLivePusher: x.y.z or AlivcLivePusher_Interactive: x.y.z.
App/Package name: Such as LiveExample / com.example.liveapp

Issue description: For example, occasional stream interruption / Unable to pull stream / No video. Briefly describe the specific symptoms.
Reproduction: For example, intermittent or consistent.
Detailed reproduction steps:
1. 
2. 
3. 
Affected users/device distribution: Such as Android 9 and earlier / iOS / Specific regions.

Ingest URL: Paste the complete ingest URL.
Streaming URL: If applicable.
Occurrence time: Specify the exact time, or provide examples if multiple occurrences.
Network environment: Wi-Fi/4G/5G/Wired network.
Issue logs: Logcat logs, ingest/streaming logs, preferably compressed.
Screen recording/screenshots: Upload any recordings or key screenshots of abnormal behavior.
Ingest parameter configuration: Such as resolution, frame rate, and bitrate.

Error messages: If errors occurred, provide error codes or messages.
Automatic recovery from exception: For example, auto-reconnection. Describe reconnection results.
Other: Any information you think might be helpful.

Problema em transmissão ao vivo padrão

Title: Occasional stream interruption during standard live streaming.
Business scenario: Standard live streaming.
SDK version: AlivcLivePusher: x.y.z.
App/Package name: LiveExample / com.example.liveapp

Issue description: During streaming, the stream is occasionally interrupted approximately every 30 minutes, requiring manual restart.
Reproduction: Intermittent.
Detailed reproduction steps:
1. Start stream ingest.
2. Stream interruption occurs after about 30 minutes.
3. Need to ingest again to recover.
Affected users/device distribution: Android 9 and earlier, multiple device models, more frequent in Southeast Asia.

Ingest URL: rtmp://test.alivecdn.com/live/streamId?auth_key=XXX
Occurrence time: 2024-05-18 12:34
Network environment: 4G
Issue logs: See attachment logcat_20240518.zip.
Screen recording/screenshots: See attachment.
Ingest parameter configuration: Resolution 720p, bitrate 1500kbps, frame rate 30fps.

Error messages: No error messages.
Automatic recovery from exception: No, manual restart required.
Other: None.

Problema em transmissão interativa

Title: CDN viewers cannot receive host's video.
Business scenario: Multi-host streaming, AUI Kits interactive streaming.
SDK version: AlivcLivePusher_Interactive: x.y.z
App/Package name: LiveExample / com.example.liveapp

Issue description: Host-side stream ingest is normal, guests can pull the stream normally, but viewers cannot see the host's video, with no error messages.
Reproduction: Consistent.
Detailed reproduction steps:
1. Host starts interactive streaming and begins stream ingest.
2. Guests receive the host's stream normally.
3. Viewers (Android/iOS) enter the channel but cannot see the host's video.
Affected users/device distribution: Consistent on both Android and iOS.

Ingest URL: artc://live.aliyun.com/push/633?timestamp=1685094092&token=fe4e674ade****6686&userId=718&sdkAppId=xxx
Streaming URL: rtmp://test.alivecdn.com/live/xxx_633_718_camera?auth_key=XXX
Configuration: Channel number 633, AppID xxx, User ID 718, Playback domain test.alivecdn.com.
Occurrence time: 2024-05-18 12:34
Network environment: Wi-Fi
Issue logs: See attachment logcat_20240518.zip.
Screen recording/screenshots: See attachment.
Ingest parameter configuration: Resolution 720p, bitrate 1200kbps, frame rate 20fps.

Error messages: None.
Automatic recovery from exception: No, need to restart streaming.
Other: No messages on viewer side. Switching networks/devices does not help.