Dépannage WebRTC : voix et conférences
Des symptômes précis et les premières vérifications à effectuer sans compromettre les clés.
Dépôts et téléchargements officiels
Trois composants distincts : serveur vocal, modules simulateur, et conférences ad hoc optionnelles. Choisis les versions compatibles avec ton installation.
Rien ne se passe quand j’active la voix
Contrôlez d’abord les autorisations vocales sur la parcelle et l’estate. C’est une cause fréquente : le viewer ne demande même pas le provisioning lorsque ces droits sont désactivés.
Journaux à examiner : OpenSim.log sur la région et console du viewer si disponible.
Messages à rechercher (indices, pas erreurs garanties) : Chercher voice, WebRtc, parcel et provisioning ; l'absence de requête peut indiquer un droit de parcelle désactivé.
Vérifications avant de modifier : Vérifier les autorisations voix parcelle et domaine avant le réseau.
Correction possible après confirmation : Réactiver les permissions nécessaires et refaire un essai.
Le serveur est actif mais personne ne se connecte
Contrôlez DNS, certificat TLS, TCP 9443, réglage WebRtcVoiceServerURI et autorisation des simulateurs. Vérifiez les journaux de la région et de wolfvoice.service. Un service systemd actif ne garantit pas une connexion audio réussie.
Exemple pour votre propre installation : adaptez tous les domaines, chemins et noms.
sudo systemctl status wolfvoice.service --no-pager -l sudo journalctl -u wolfvoice.service -n 60 --no-pager
Journaux à examiner : OpenSim.log et journalctl -u wolfvoice.service côté serveur vocal.
Messages à rechercher (indices, pas erreurs garanties) : Chercher WebRtc, HTTPS, TLS, handshake, refused, unauthorized et timeout.
Vérifications avant de modifier : Tester DNS, certificat, port TCP 9443, clés et liste IP autorisées.
Correction possible après confirmation : Corriger le réseau ou l'authentification, sans désactiver la vérification de certificat.
Session créée mais sans audio
La plage UDP 40000–40999 doit être accessible aux viewers. Vérifiez WOLFVOICE_PUBLIC_IP, redirections NAT et les candidats ICE dans les journaux. Une connexion testée sur la même machine peut réussir alors que l’accès externe échoue.
Journaux à examiner : wolfvoice.service et OpenSim.log ; diagnostics ICE du viewer si disponibles.
Messages à rechercher (indices, pas erreurs garanties) : Chercher ICE, candidate, UDP, timeout, failed ; les termes dépendent de la version du backend.
Vérifications avant de modifier : Vérifier UDP 40000–40999, IP publique annoncée et NAT.
Correction possible après confirmation : Corriger l'accessibilité UDP sans ouvrir les ports de gestion privés.
Connected, mais aucun son dans la région
Vérifiez que les avatars ont envoyé leur position et qu’ils sont dans la bonne salle vocale. L’isolation entre parcelles peut être voulue. Contrôlez également volume, micro et périphérique audio du visualiseur.
Journaux à examiner : OpenSim.log, wolfvoice.service et diagnostics audio du viewer.
Messages à rechercher (indices, pas erreurs garanties) : Chercher room, join, position, spatial, disconnect et les erreurs associées.
Vérifications avant de modifier : Vérifier salle, distances, droits parcelle, micro et volume.
Correction possible après confirmation : Corriger la salle ou les périphériques identifiés plutôt que redémarrer la grille.
Appel privé impossible entre deux simulateurs
Vérifiez les versions identiques des trois modules compatibles et les clés sur les deux simulateurs. Un serveur passé en mode RPC à deux clés peut refuser une région configurée uniquement avec l’ancien mode.
Journaux à examiner : OpenSim.log des deux simulateurs et wolfvoice.service.
Messages à rechercher (indices, pas erreurs garanties) : Chercher call, credentials, RPC, forbidden, unauthorized, timeout.
Vérifications avant de modifier : Comparer versions des modules, modes d'authentification et accès aux fichiers de clés.
Correction possible après confirmation : Aligner les modules et les clés de manière coordonnée, sans renouvellement improvisé.
Conférence AdHoc : refus HTTP 403
Vérifiez le registre PHP/MySQL, la signature des requêtes, la clé partagée et l’IP sortante autorisée du simulateur. Ne désactivez pas le contrôle d’accès pour faire disparaître l’erreur.
Journaux à examiner : Logs HTTP PHP/web et MySQL de l'API AdHoc, ainsi que OpenSim.log.
Messages à rechercher (indices, pas erreurs garanties) : Chercher HTTP 403, authentication, signature, whitelist et erreurs de base.
Vérifications avant de modifier : Comparer IP sortante de la région, clé/signature et règles du service.
Correction possible après confirmation : Corriger l'entrée autorisée ou la signature sans désactiver le contrôle d'accès.
Erreur TLS ou certificat
Le DNS indiqué dans WebRtcVoiceServerURI doit correspondre au certificat HTTPS. Les modules vérifient la chaîne et le nom, indépendamment de certains réglages généraux d’OpenSimulator. N’utilisez pas un certificat invalide comme solution de facilité.
Journaux à examiner : OpenSim.log et wolfvoice.service ; logs TLS du proxy si utilisé.
Messages à rechercher (indices, pas erreurs garanties) : Chercher certificate, SSL, TLS, hostname mismatch, handshake.
Vérifications avant de modifier : Contrôler nom DNS, chaîne de certificats, renouvellement et heure système.
Correction possible après confirmation : Corriger le certificat ou l'URI, pas les validations TLS.
Son haché sous charge
Surveillez CPU du serveur vocal, réseau UDP, pertes de paquets, nombre de sessions, capacité de la VM et logs. La voix est sensible à la latence et au jitter ; une saturation de ressources peut provoquer des coupures.
Journaux à examiner : wolfvoice.service, OpenSim.log et métriques CPU/réseau.
Messages à rechercher (indices, pas erreurs garanties) : Chercher disconnect, overload, timeout, ICE et erreurs répétées pendant les coupures.
Vérifications avant de modifier : Corréler charge CPU, sessions, latence, pertes UDP et événements système.
Correction possible après confirmation : Corriger la ressource identifiée et mesurer avant/après.
Firestorm affiche parfois une alerte Vivox
Le guide source décrit une alerte Vivox pouvant être déclenchée par le panneau de réglage audio malgré un WebRTC fonctionnel. Distinguez cette alerte d’un véritable échec de provisioning WebRTC en analysant les logs.
Journaux à examiner : OpenSim.log et diagnostics du viewer si disponibles.
Messages à rechercher (indices, pas erreurs garanties) : Rechercher un véritable échec WebRTC plutôt que supposer que toute alerte Vivox en est un.
Vérifications avant de modifier : Vérifier si la voix fonctionne réellement lors de l'alerte.
Correction possible après confirmation : Ne pas réinstaller le backend sur la seule base de cette alerte.