Resolução de problemas
9 perguntas
-
O WorkAdventure não consegue funcionar corretamente em alguns tipos de VPNs, redes de campus ou redes corporativas. O áudio e o vídeo precisam de uma rota direta para a internet, e proxies ou inspeção de pacotes na rede podem bloqueá-los. Se você estiver nessa situação, pode tentar:
- desativar sua VPN,
- pedir ao administrador da rede para desbloquear o WorkAdventure,
- entrar em contato conosco.
Para desbloquear o WorkAdventure em um firewall pessoal ou corporativo, leia o artigo “Preparing your network” da nossa documentação (em inglês).
-
Se o firewall da sua empresa estiver configurado para bloquear chamadas de vídeo de saída (em especial o tráfego UDP de saída), será necessário solicitar ao administrador da rede que modifique a configuração para permitir a passagem dos fluxos do WorkAdventure.
Os endereços e as portas a liberar estão listados no artigo “Preparing your network” da nossa documentação (em inglês).
-
Você consegue se conectar ao WorkAdventure e mover seu personagem, mas quando se aproxima de outro usuário, não consegue falar com ele? Ou não consegue falar nem ouvir as pessoas em uma sala de reunião?
Todos esses problemas podem ocorrer quando não conseguimos estabelecer uma conexão de vídeo/áudio. No jargão técnico, chamamos essas conexões de “WebRTC”. Em uma bolha, o WorkAdventure tenta conectar os usuários diretamente entre si via UDP; quando isso não é possível, os fluxos passam por servidores de retransmissão. As conexões WebRTC podem falhar devido a um grande número de problemas, mas, na maioria das vezes, isso se deve a uma rede muito restrita por causa de firewalls ou outras proteções instaladas pelo administrador da rede.
Direcione seu administrador de rede para a página “Preparing your network” da nossa documentação (em inglês) para ajudá-lo a adaptar as configurações da rede ao WorkAdventure.
Enquanto isso, se você usa uma VPN, tente desativá-la. Você também pode conectar seu notebook ao ponto de acesso 4G/5G do seu celular: uma conexão móvel costuma ser menos restrita do que a rede de um escritório.
-
Se a câmera nem sempre é a correta quando você entra no seu espaço virtual, o Chrome provavelmente está detectando várias câmeras e escolhendo aquela que considera prioritária. No Mac isso pode acontecer quando o iPhone é oferecido como câmera junto com a do computador; uma webcam externa ou um monitor com câmera integrada provocam o mesmo, e a escolha pode mudar de uma sessão para outra.
Defina a câmera no WorkAdventure. Abra as configurações da câmera, clique na seta e escolha o dispositivo desejado. O WorkAdventure volta a selecioná-lo em cada sessão, sempre que estiver disponível.
Faça o mesmo no Chrome. Vá em Configurações, Privacidade e segurança, Configurações do site e depois Câmera, e selecione a câmera integrada do seu Mac como câmera padrão.
Verifique a permissão do seu espaço: clique no ícone à esquerda da URL do seu espaço virtual e confirme que o acesso à câmera está permitido.
Depois dessa alteração, feche completamente a aba ou o navegador e conecte-se novamente ao seu espaço virtual.
-
Se o seu microfone muda toda vez que você entra no seu espaço virtual, é o navegador ou o sistema que está selecionando outro dispositivo de áudio disponível no seu lugar.
No Mac, isso acontece com frequência quando um iPhone está por perto e o Chrome o detecta como microfone externo: ele pode passar a considerá-lo o dispositivo padrão e usá-lo no lugar do microfone interno do Mac.
Defina o microfone no WorkAdventure. Abra as configurações do microfone, clique na seta e escolha o dispositivo desejado. O WorkAdventure volta a selecioná-lo em cada sessão, sempre que estiver disponível.
Faça o mesmo no Chrome. Vá em Configurações, Privacidade e segurança, Configurações do site e depois Microfone, e selecione explicitamente o microfone interno do seu Mac, como Microfone interno ou Microfone do MacBook.
Verifique também no macOS, em Ajustes do Sistema, depois Som e Entrada: o microfone interno também deve ser a principal fonte de entrada.
Se o microfone errado continuar sendo usado, feche completamente o Chrome, reabra o navegador e conecte-se novamente ao seu espaço virtual. Isso costuma ajudar a redefinir a detecção do dispositivo de áudio.
-
Abra o menu, vá em Configurações, e você vai encontrar dois controles separados:
- “Qualidade de vídeo” — para a sua câmera.
- “Qualidade de compartilhamento de tela” — para o que você compartilha da sua tela.
Cada um tem três posições:
Configuração O que faz Baixa A menor largura de banda e os codecs mais leves. Use em uma conexão fraca, em uma máquina mais antiga ou em um notebook na bateria. Recomendada O padrão. Qualidade e largura de banda equilibradas; um compartilhamento de tela é capturado em 1080p. High O máximo de detalhe dentro do limite; um compartilhamento de tela é capturado em 1440p. Use para código, planilhas e slides densos. Eles são separados de propósito: compartilhar uma tela de código em 1440p enquanto a miniatura da sua webcam continua modesta costuma ser exatamente o que você quer.
Logo abaixo, “Se a largura de banda da rede estiver limitada” decide o que cede quando um fluxo precisa ser comprimido:
- “Manter o texto legível” — mantém a resolução e descarta quadros. A escolha certa para documentos, slides e código.
- “Manter animações suaves” — mantém a taxa de quadros e reduz a resolução. A escolha certa quando você compartilha um vídeo ou qualquer coisa que se mova.
- “Equilibrar taxa de quadros e resolução” — sem preferência.
Uma mudança de configuração vale para o próximo fluxo, e não para o que já está em andamento; então pare e reinicie o compartilhamento de tela para ver o efeito.
No uso normal, você não precisa gerenciar isso manualmente: o WorkAdventure escolhe um codec de vídeo com base no que a sua máquina realmente consegue codificar, e reduz a qualidade sozinho quando ela não dá conta. A configuração existe para quando você quiser passar por cima dessa escolha. Como isso funciona, em detalhes (em inglês).
-
Um compartilhamento de tela desfocado quase sempre significa que o vídeo está sendo comprimido mais do que o conteúdo merece. Há dois motivos diferentes para isso acontecer, e eles pedem soluções opostas — então comece descobrindo qual dos dois você tem diante de si.
Abra Configurações, ative “Exibir estatísticas de qualidade de vídeo” e olhe a linha
Limited by:no vídeo:bandwidth— a sua conexão (ou a de quem assiste) não consegue transportar o fluxo. Nada na máquina vai ajudar.cpu— o seu computador não consegue codificar os quadros rápido o suficiente, e o WorkAdventure reduziu a resolução para acompanhar. Fechar outros aplicativos e abas do navegador muitas vezes resolve de vez.- nada — a imagem está tão boa quanto as configurações atuais permitem, então aumente-as.
Depois, no mesmo painel de configurações:
- “Qualidade de compartilhamento de tela” controla quanto detalhe é capturado e quanta largura de banda é gasta com ele. High captura em 1440p; Recomendada em 1080p; Baixa em 720p. Se você está compartilhando código ou uma planilha densa, High é a configuração que você quer.
- Em “Se a largura de banda da rede estiver limitada”, escolha “Manter o texto legível”. Isso diz ao WorkAdventure para sacrificar a taxa de quadros em vez da resolução quando o fluxo precisa ser comprimido — exatamente a troca certa para slides, documentos e código, e exatamente a errada para um vídeo.
Mais uma coisa que vale saber: um compartilhamento de tela fica mais nítido logo depois que para de se mover. A compressão de vídeo gasta seus bits com o que muda, então rolar um documento longo o mantém borrado, e ele entra em foco um segundo depois que você para.
Se quiser os detalhes de como o WorkAdventure escolhe codecs e taxas de bits, e do que ele faz quando uma máquina não dá conta, está tudo neste artigo (em inglês).
-
Um vídeo travando ou engasgando significa que quadros estão sendo descartados em algum ponto entre a câmera e a tela. Há três lugares possíveis, e é fácil distingui-los.
Abra Configurações e ative “Exibir estatísticas de qualidade de vídeo”. Cada vídeo passa então a mostrar a sua resolução, a taxa de bits e uma linha
Limited by::bandwidth— a rede não consegue transportar o fluxo. Verifique a sua conexão e prefira uma conexão cabeada ou um ponto de acesso mais próximo. Reduzir “Qualidade de vídeo” e “Qualidade de compartilhamento de tela” para Baixa diminui o que você está exigindo dela.cpu— o computador não consegue codificar rápido o suficiente. É o caso mais comum em notebooks, e fica muito pior com várias pessoas em uma bolha: em uma conversa ponto a ponto, a sua máquina codifica a sua câmera uma vez para cada pessoa com quem você está falando. Feche outros aplicativos, pare o compartilhamento de tela se houver um em andamento ou ajuste a qualidade para Baixa.- Nada aparece, mas o vídeo continua travando — o problema provavelmente está do lado de quem recebe. Quem assiste em uma máquina que não consegue decodificar rápido o suficiente vê travamentos que mais ninguém vê.
Duas coisas que o WorkAdventure faz sozinho a respeito: ele reduz a taxa de quadros e a resolução das miniaturas pequenas em vez de enviar a qualidade máxima para uma miniatura, e, quando os seus codificadores não dão conta em uma conversa em grupo, ele passa a bolha para o nosso servidor de mídia, para que a sua máquina codifique uma vez só em vez de uma vez por participante. As duas coisas acontecem sem perguntar nada a você.
Se o problema persistir em uma máquina que deveria dar conta, o navegador importa. Esse alívio automático depende de o navegador nos avisar que o codificador está com dificuldades, o que o Chrome e o Edge fazem e o Firefox não — no Firefox, a solução é reduzir a configuração de qualidade manualmente.
A explicação completa de como isso funciona está neste artigo (em inglês).
-
Se o WorkAdventure cai depois de alguns minutos em uma aba em segundo plano, o mais provável é que o navegador tenha desativado a aba para recuperar memória. O Chrome chama isso de Economia de memória (Memory Saver), e o Microsoft Edge, de guias em suspensão (sleeping tabs). Uma aba desativada mantém o título e o ícone, mas não está mais em execução: a conexão com seu espaço virtual é encerrada, e a página é recarregada do zero na próxima vez que você clicar nela.
Os dois navegadores permitem isentar os sites que precisam continuar em execução, e o WorkAdventure é um deles.
Google Chrome
- Abra Configurações ▸ Desempenho.
- À direita de Sempre manter estes sites ativos, selecione Adicionar.
- Escolha a aba do WorkAdventure na lista de abas abertas, ou digite o endereço do seu espaço (play.workadventu.re, ou seu próprio domínio se você usa um nome de domínio personalizado ou hospeda o WorkAdventure por conta própria), e selecione Adicionar.
Um site dessa lista nunca é desativado, qualquer que seja o modo de Economia de memória. Se sua equipe usa o Chrome com economia de memória Máxima (Configurações ▸ Desempenho), as abas ficam inativas muito mais rápido do que com a configuração padrão, então vale a pena verificar isso também.
Microsoft Edge
- Abra Configurações ▸ Sistema e desempenho ▸ Desempenho.
- Em Sempre manter estes sites ativos, selecione Adicionar site.
- Digite o endereço do seu espaço e selecione Adicionar.
Se continuar desconectando
Nenhum dos dois navegadores desativa uma aba que está reproduzindo áudio ou vídeo, compartilhando a tela ou em uma chamada; por isso, a suspensão de abas só afeta quem deixa o avatar no mapa sem estar em uma conversa. Se você é desconectado enquanto está em uma bolha ou em uma sala de reunião, a causa é outra: vale verificar sua rede e seu firewall (documentação em inglês). Testar a partir de outra rede (por exemplo, usando o 4G/5G do celular como roteador) ajuda a identificar se o problema está na sua rede ou no seu computador.
Nenhum resultado.