Todos os produtos
Search
Central de documentação

ApsaraVideo Live:Códigos de erro

Última atualização: Jul 05, 2026

Lista os códigos de erro comuns do SDK do ApsaraVideo Real-time Communication (RTC), com causas e soluções.

Códigos de erro

Hexadecimal

Decimal

Descrição do erro

Causas

Solução

0x01010301

16843521

already joined

O usuário já entrou no canal.

Verifique a lógica de chamada da API.

0x02010903

33622275

failed to join channel due to invalid channel profile

Os perfis de canal não correspondem. Por exemplo, esse erro ocorre se o primeiro usuário entrar no modo de comunicação e um usuário subsequente tentar entrar no modo interativo.

Verifique se o modo de canal do usuário é consistente com o modo dos demais usuários no canal.

0x05040002

84148226

channel is overdue

  • Sua conta tem pagamentos pendentes.

  • O token expirou. Verifique essa condição pelo parâmetro timestamp.

  • O AppId e o AppKey estão incorretos ou não correspondem. Cada AppId associa-se a um AppKey exclusivo.

  • Um parâmetro de autenticação está incorreto.

Verifique os seguintes itens:

  • Confirme se o saldo da conta é suficiente.

  • Confirme se o token expirou. Use o parâmetro timestamp convertido para UTC+8 para verificar. Em alguns casos, o timestamp representa o horário de expiração; em outros, a expiração ocorre 48 horas após o timestamp.

  • Certifique-se de que o AppId e o AppKey correspondem. Cada AppId associa-se a um AppKey exclusivo.

  • Confirme se os parâmetros de autenticação estão corretos.

0x02010702

33621762

join channel failed due to same user repeat join, please check if another device still in the channel

Falha ao entrar no canal devido a uma tentativa repetida de entrada. Isso pode acontecer quando o mesmo usuário tenta entrar no mesmo canal a partir de dois dispositivos diferentes ou quando a sessão anterior do usuário não foi totalmente encerrada.

Verifique a lógica de chamada da API.

0x02010104

33620228

session join

O cliente tentou entrar no canal usando o mesmo ID de sessão após sair dele.

Tente entrar no canal novamente.

0x02010204

33620484

channel is not exist

Falha ao entrar no canal porque ele não existe. Por exemplo, o criador do canal entrou e saiu rapidamente. Quando outro usuário tentou entrar, o canal já havia sido removido.

Tente entrar no canal novamente.

0x02010201

33620481

bad appid

O AppId não existe.

Verifique se o AppId existe no ambiente e no console.

0x02010202

33620482

invalid appid

O AppId é inválido.

Verifique o status atual do AppId no console.

0x02010203

33620483

bad channel

Não foi possível criar o canal ou a criação falhou.

Verifique a nomenclatura do ID do canal e tente novamente.

0x02010205

33620485

bad token

O token calculado pelo cliente não corresponde ao token calculado pelo serviço ApsaraVideo Real-time Communication.

  • Execute o código de exemplo fornecido pela Alibaba Cloud com os mesmos parâmetros para comparar e validar os resultados.

  • Verifique se os parâmetros de autenticação são consistentes com os parâmetros passados para o SDK.

  • Confirme se o algoritmo correto está em uso.

0x01030101

16974081

bad param

Um parâmetro inválido foi utilizado.

  • Execute o código de exemplo fornecido pela Alibaba Cloud com os mesmos parâmetros para comparar e validar os resultados.

  • Verifique se os parâmetros usados no cálculo do token seguem as convenções de nomenclatura, como comprimento da string e uso de caracteres especiais.

  • Confirme se o algoritmo correto está em uso.

0x05010011

83951633

join channel failed due to invalid channel id

O ID do canal na solicitação de Global Server Load Balancing (GSLB) é inválido. Por exemplo, o ID do canal não pode conter espaços.

Verifique o formato do ID do canal.

O ID do canal deve ter entre 1 e 64 caracteres e pode conter letras maiúsculas, letras minúsculas, dígitos, sublinhados (_) e hifens (-).

0x05010012

83951634

join channel failed due to invalid user id

O ID do usuário na solicitação GSLB é inválido.

Tente entrar no canal novamente.

0x0501001a

83951642

join channel due to invalid channel id

O AppId está configurado para o modo de canal de grande escala, que exige a versão 1.16.5 ou posterior do SDK. A entrada no canal falhará com versões mais antigas.

Verifique a versão do SDK.

0x01020201

16908801

signal request is timeout

Nenhuma resposta recebida para a solicitação GSLB, causando tempo limite.

Verifique se a conectividade de rede está normal.

0x01020204

16908804

join timeout

Nenhuma resposta recebida para a solicitação de entrada no canal, causando tempo limite.

Verifique se a conectividade de rede está normal.

0x01030202

16974338

join error

Erro ao entrar no canal.

Verifique se as informações de autenticação estão corretas e se o ambiente de rede está estável.

0x01030201

16974337

gslb error

O campo gslb no parâmetro AuthInfo está incorreto.

Verifique se o campo gslb em AuthInfo está completo ou valide se o AuthInfo passa na verificação.

0x01040404

17040388

mic open fail

Falha na inicialização do dispositivo de captura. Por exemplo, o dispositivo pode estar em uso.

No macOS e Windows, verifique se há um indicador de nível de atividade nas Configurações do Sistema.

No iOS e Android, confirme se outro aplicativo está usando o dispositivo.

Se tudo estiver normal, reinicie o dispositivo.

0x01040405

17040389

speaker open fail

Falha na inicialização do dispositivo de reprodução.

No macOS e Windows, verifique se há um indicador de nível de atividade nas Configurações do Sistema.

No iOS e Android, confirme se outro aplicativo está usando o dispositivo.

Se tudo estiver normal, reinicie o dispositivo.

0x01040406

17040390

mic interrupt

Outro aplicativo está usando o dispositivo.

Outros aplicativos precisam liberar o dispositivo.

0x01040407

17040391

speaker interrupt

Outro aplicativo está usando o dispositivo.

O outro aplicativo precisa liberar o dispositivo.

0x01040408

17040392

mic auth fail

A autorização para o dispositivo de captura de áudio não foi concedida.

Solicite autorização ao usuário.

0x01040409

17040393

mic not available

Nenhum dispositivo de captura de áudio disponível.

Verifique se o dispositivo existe no sistema.

Verifique se o dispositivo está desabilitado no sistema.

0x01040410

17040400

speaker not available

Nenhum dispositivo de reprodução de áudio disponível.

Verifique se o dispositivo existe no sistema.

Verifique se o dispositivo está desabilitado no sistema.

0x01040104

17039620

camera open fail

Falha na inicialização do dispositivo de captura de vídeo.

Verifique se o aplicativo está usando a câmera.

0x01040106

17039622

camera interrupt

O dispositivo de captura de vídeo foi interrompido à força.

Verifique se outro aplicativo está usando o dispositivo.

Verifique se o dispositivo funciona corretamente.

0x01040201

17039873

display open fail

Falha na inicialização do dispositivo de renderização.

Em dispositivos Windows, verifique o driver da placa gráfica. Em dispositivos móveis, verifique se a tela está presente.

0x01040202

17039874

display interrupt

O dispositivo de renderização foi interrompido.

Verifique se o driver do sistema funciona corretamente. Em caso afirmativo, reinicie o dispositivo.

0x01030404

16974852

subscribe invalid

Assinatura inválida.

Verifique se o usuário remoto entrou no canal.

0x01010550

16844112

subscribe not joinchannel

Falha na assinatura porque o usuário não entrou no canal.

Chame primeiro a API joinchannel.

0x01010551

16844113

subscribe audio stream failed

O fluxo de áudio assinado é inválido.

Verifique se o usuário remoto tem um fluxo de áudio disponível para assinatura.

Verifique se esse fluxo de áudio está presente no callback OnRemoteTrackAvailable recebido pelo cliente local.

0x01010552

16844114

subscribe video stream failed

O fluxo de vídeo assinado é inválido.

Verifique se o usuário remoto tem um fluxo de vídeo disponível para assinatura.

Verifique se esse fluxo de vídeo está presente no callback OnRemoteTrackAvailable recebido pelo cliente local.

0x01070101

17236225

audio buffer full

A fila interna de buffer de áudio do SDK está cheia ao enviar dados pela API de captura de áudio personalizada.

Reduza a frequência de entrada externa. Defina um tempo de espera de 20 ms e garanta que um único envio de dados não exceda 40 ms.

0x01070102

17236226

video buffer full

A fila interna de buffer de vídeo do SDK está cheia ao usar entrada de dados brutos externos.

Reduza a frequência de entrada externa. Aguarde o intervalo de keyframe de vídeo antes da próxima entrada.