Dépannage
9 questions
-
WorkAdventure ne peut pas fonctionner correctement sur certains types de VPN, de réseaux de campus ou de réseaux d’entreprise. L’audio et la vidéo ont besoin d’un accès direct à Internet, et les proxys ou l’inspection de paquets sur le réseau peuvent les bloquer. Si vous êtes dans cette situation, vous pouvez essayer de :
- désactiver votre VPN,
- demander à votre administrateur réseau de débloquer WorkAdventure,
- nous contacter.
Pour débloquer WorkAdventure sur un pare-feu personnel ou d’entreprise, lisez l’article « Preparing your network » de notre documentation (en anglais).
-
Si le pare-feu de votre entreprise est configuré pour bloquer les appels vidéo sortants (en particulier le trafic UDP sortant), vous devrez demander à votre administrateur réseau de modifier la configuration pour autoriser le passage des flux WorkAdventure.
Les adresses et les ports à ouvrir sont listés dans l’article « Preparing your network » de notre documentation (en anglais).
-
Vous pouvez vous connecter à WorkAdventure et déplacer votre personnage, mais lorsque vous vous approchez d’un autre utilisateur, vous ne pouvez pas lui parler ? Ou vous ne pouvez pas parler ni entendre les autres dans une salle de réunion ?
Tous ces problèmes peuvent survenir lorsque nous ne parvenons pas à établir une connexion vidéo/audio. Dans le jargon technique, nous appelons ces connexions « WebRTC ». Dans une bulle, WorkAdventure essaie de connecter les utilisateurs directement entre eux en UDP ; quand ce n’est pas possible, les flux passent par des serveurs relais. Les connexions WebRTC peuvent échouer pour un grand nombre de raisons, mais la plupart du temps, cela est dû à un réseau trop restreint en raison de pare-feu ou d’autres protections installées par l’administrateur du réseau.
Dirigez votre administrateur réseau vers la page « Preparing your network » de notre documentation (en anglais) pour l’aider à adapter les paramètres du réseau à WorkAdventure.
En attendant, si vous utilisez un VPN, essayez de le désactiver. Vous pouvez aussi connecter votre ordinateur au partage de connexion 4G/5G de votre téléphone : une connexion mobile est généralement moins restreinte que le réseau d’une entreprise.
-
Si la caméra n’est pas toujours la bonne lorsque vous rejoignez votre espace virtuel, Chrome détecte probablement plusieurs caméras et choisit celle qu’il considère prioritaire. Sur Mac, cela peut se produire lorsque l’iPhone est proposé comme caméra en plus de celle de l’ordinateur ; une webcam externe ou un écran avec caméra intégrée provoquent la même chose, et le choix peut changer d’une session à l’autre.
Définissez la caméra dans WorkAdventure. Ouvrez les réglages de la caméra, cliquez sur le chevron et choisissez le périphérique voulu. WorkAdventure le réutilise à chaque session, dès qu’il est disponible.
Faites de même dans Chrome. Allez dans Paramètres, Confidentialité et sécurité, Paramètres des sites, puis Caméra, et sélectionnez la caméra intégrée de votre Mac comme caméra par défaut.
Vérifiez l’autorisation de votre espace : cliquez sur l’icône à gauche de l’URL de votre espace virtuel et assurez-vous que la caméra est autorisée.
Une fois la modification faite, fermez complètement l’onglet ou le navigateur, puis reconnectez-vous à votre espace virtuel.
-
Si votre microphone change à chaque fois que vous rejoignez votre espace virtuel, c’est le navigateur ou le système qui sélectionne à votre place un autre périphérique audio disponible.
Sur Mac, cela arrive le plus souvent lorsqu’un iPhone se trouve à proximité et que Chrome le détecte comme microphone externe : il peut alors le considérer comme périphérique par défaut et l’utiliser à la place du microphone intégré du Mac.
Définissez le microphone dans WorkAdventure. Ouvrez les réglages du microphone, cliquez sur le chevron et choisissez le périphérique voulu. WorkAdventure le réutilise à chaque session, dès qu’il est disponible.
Faites de même dans Chrome. Allez dans Paramètres, Confidentialité et sécurité, Paramètres des sites, puis Micro, et sélectionnez explicitement le microphone interne de votre Mac, par exemple Micro interne ou Micro MacBook.
Vérifiez aussi côté macOS, dans Réglages Système, puis Son, puis Entrée : le microphone intégré doit y être la source principale.
Si le mauvais microphone est toujours utilisé, quittez complètement Chrome, relancez-le puis reconnectez-vous à votre espace virtuel. Cela aide souvent à réinitialiser la détection du périphérique audio.
-
Ouvrez le menu, allez dans Paramètres, et vous trouverez deux réglages distincts :
- « Qualité vidéo » : pour votre caméra.
- « Qualité du partage d’écran » : pour ce que vous partagez depuis votre écran.
Chacun propose trois positions :
Réglage Effet Basse Le moins de bande passante et les codecs les plus légers. À utiliser avec une connexion faible, une machine ancienne ou un ordinateur portable sur batterie. Recommandée Le réglage par défaut. Un équilibre entre qualité et bande passante ; un partage d’écran est capturé en 1080p. Haute Le plus de détails possible dans l’enveloppe disponible ; un partage d’écran est capturé en 1440p. À utiliser pour du code, des tableurs et des diapositives denses. Ils sont séparés exprès : partager en 1440p un écran rempli de code pendant que la vignette de votre webcam reste modeste, c’est généralement exactement ce que vous voulez.
Juste en dessous, « Si la bande passante réseau est limitée » décide de ce qui cède quand un flux doit être compressé :
- « Garder le texte lisible » : conserve la résolution et sacrifie des images. Le bon choix pour les documents, les diapositives et le code.
- « Conserver des animations fluides » : conserve le nombre d’images par seconde et baisse la résolution. Le bon choix lorsque vous partagez une vidéo ou tout ce qui bouge.
- « Équilibrer fluidité et résolution » : aucune préférence.
Un changement de réglage s’applique au flux suivant et non à celui déjà en cours : arrêtez puis relancez un partage d’écran pour en voir l’effet.
En temps normal, vous n’avez pas à gérer cela à la main : WorkAdventure choisit un codec vidéo en fonction de ce que votre machine est réellement capable d’encoder, et baisse la qualité de lui-même quand elle ne suit plus. Le réglage est là pour quand vous voulez reprendre la main. Le fonctionnement en détail (en anglais).
-
Une vidéo saccadée ou hachée signifie que des images se perdent quelque part entre la caméra et l’écran. Trois endroits sont possibles, et il est facile de les distinguer.
Ouvrez les Paramètres et activez « Afficher les statistiques de qualité vidéo ». Chaque vidéo affiche alors sa résolution, son débit et une ligne
Limited by::bandwidth: le réseau ne peut pas transporter le flux. Vérifiez votre connexion, et privilégiez une connexion filaire ou un point d’accès plus proche. Passer « Qualité vidéo » et « Qualité du partage d’écran » sur Basse réduit ce que vous lui demandez.cpu: l’ordinateur n’arrive pas à encoder assez vite. C’est le cas le plus courant sur les ordinateurs portables, et il s’aggrave nettement à plusieurs dans une bulle : dans une conversation pair-à-pair, votre machine encode votre caméra une fois par personne avec qui vous parlez. Fermez d’autres applications, arrêtez le partage d’écran si vous en avez un en cours, ou passez la qualité sur Basse.- Rien d’affiché, mais la vidéo reste saccadée : le problème se situe plus probablement du côté de la réception. Une personne dont la machine n’arrive pas à décoder assez vite voit des saccades que personne d’autre ne voit.
WorkAdventure agit de lui-même de deux façons : il baisse la fluidité et la résolution des petites vignettes plutôt que d’envoyer la pleine qualité dans une miniature, et lorsque vos encodeurs ne suivent plus dans une conversation de groupe, il bascule la bulle sur notre serveur média, pour que votre machine encode une seule fois au lieu d’une fois par participant. Les deux se font sans rien vous demander.
Si le problème persiste sur une machine qui devrait tenir la charge, le navigateur compte. Ce soulagement automatique repose sur le fait que le navigateur nous signale que l’encodeur peine, ce que font Chrome et Edge, mais pas Firefox : sur Firefox, la solution est de baisser le réglage de qualité à la main.
L’explication complète de ce fonctionnement se trouve dans cet article (en anglais).
-
Un partage d’écran flou signifie presque toujours que la vidéo est plus compressée que le contenu ne le mérite. Cela peut arriver pour deux raisons différentes, qui demandent des solutions opposées : commencez donc par savoir laquelle vous concerne.
Ouvrez les Paramètres, activez « Afficher les statistiques de qualité vidéo », et regardez la ligne
Limited by:sur la vidéo :bandwidth: votre connexion (ou celle de la personne qui regarde) ne peut pas transporter le flux. Rien sur la machine n’y changera quoi que ce soit.cpu: votre ordinateur ne parvient pas à encoder les images assez vite, et WorkAdventure a baissé la résolution pour suivre. Fermer d’autres applications et onglets du navigateur suffit souvent à régler le problème.- rien du tout : l’image est aussi bonne que les réglages actuels le permettent ; augmentez-les.
Ensuite, dans le même panneau de réglages :
- « Qualité du partage d’écran » détermine le niveau de détail capturé et la bande passante qui y est consacrée. Haute capture en 1440p, Recommandée en 1080p, Basse en 720p. Si vous partagez du code ou un tableur dense, c’est Haute qu’il vous faut.
- Pour « Si la bande passante réseau est limitée », choisissez « Garder le texte lisible ». WorkAdventure sacrifiera alors la fluidité plutôt que la résolution quand le flux doit être compressé : exactement le bon compromis pour des diapositives, des documents et du code, et exactement le mauvais pour un extrait vidéo.
Une dernière chose à savoir : un partage d’écran est le plus net juste après qu’il a cessé de bouger. La compression vidéo consacre ses bits à ce qui change, si bien que faire défiler un long document le laisse flou, et qu’il redevient net une seconde après que vous vous êtes arrêté.
Si vous voulez savoir en détail comment WorkAdventure choisit ses codecs et ses débits, et ce qu’il fait quand une machine ne suit plus, tout est dans cet article (en anglais).
-
Si WorkAdventure se déconnecte après quelques minutes dans un onglet en arrière-plan, c’est très probablement que votre navigateur a désactivé l’onglet pour récupérer de la mémoire. Chrome appelle cela l’économiseur de mémoire (Memory Saver), Microsoft Edge la mise en veille des onglets (sleeping tabs). Un onglet désactivé garde son titre et son icône, mais il ne tourne plus : la connexion à votre espace virtuel est fermée, et la page se recharge entièrement la prochaine fois que vous cliquez dessus.
Les deux navigateurs permettent d’exempter les sites qui doivent rester actifs, et WorkAdventure en fait partie.
Google Chrome
- Ouvrez Paramètres ▸ Performances.
- À droite de Toujours garder ces sites actifs, sélectionnez Ajouter.
- Choisissez votre onglet WorkAdventure dans la liste des onglets ouverts, ou saisissez l’adresse de votre espace (play.workadventu.re, ou votre propre domaine si vous utilisez un nom de domaine personnalisé ou hébergez WorkAdventure vous-même), puis sélectionnez Ajouter.
Un site de cette liste n’est jamais désactivé, quel que soit le mode d’économiseur de mémoire choisi. Si votre équipe utilise Chrome avec l’économie de mémoire Maximale (Paramètres ▸ Performances), les onglets deviennent inactifs bien plus vite qu’avec le réglage par défaut : cela vaut la peine de le vérifier en même temps.
Microsoft Edge
- Ouvrez Paramètres ▸ Système et performances ▸ Performances.
- Sous Toujours garder ces sites actifs, sélectionnez Ajouter un site.
- Saisissez l’adresse de votre espace et sélectionnez Ajouter.
Si la déconnexion continue
Aucun des deux navigateurs ne désactive un onglet qui lit de l’audio ou de la vidéo, partage un écran ou est en appel : la mise en veille des onglets ne touche donc que les personnes qui laissent leur avatar sur la carte sans être en conversation. Si vous êtes déconnecté alors que vous êtes dans une bulle ou une salle de réunion, la cause est ailleurs : vérifiez votre réseau et votre pare-feu (documentation en anglais). Tester depuis un autre réseau (par exemple en partageant la connexion 4G/5G de votre téléphone) aide à savoir si le problème vient de votre réseau ou de votre ordinateur.
Aucun résultat.