Configuration des simulateurs : wolfvoice.ini
Emplacement exact, modules DLL, clés partagées, sécurité et vérifications depuis chaque région.
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.
Fichier personnalisé bin/config/wolfvoice.ini
La configuration du module doit se trouver dans bin/config/wolfvoice.ini pour le schéma documenté. Ce dossier permet des surcharges chargées après OpenSim.ini. Si un processus héberge plusieurs régions, l’activation WebRTC peut s’appliquer à toutes les régions de ce même processus.
Installer les trois paires DLL/PDB correspondantes
Pour une nouvelle installation, copiez WebRtcVoice.dll/.pdb, WebRtcVoiceRegionModule.dll/.pdb et WebRtcVoiceServiceModule.dll/.pdb depuis le ZIP de la release v0.9.3.1-webrtc.3. Les versions doivent correspondre ; n’installez pas l’ancienne DLL AdHoc autonome par-dessus celle du ZIP.
Copier les mêmes clés, pas en créer de nouvelles
Les deux fichiers du serveur vocal doivent être copiés de façon privée vers chaque simulateur autorisé. Lorsque les chemins sont relatifs, démarrez OpenSimulator depuis son dossier bin. Limitez les permissions au compte de service et ne publiez aucun fichier de clé.
Exemple de fichier INI pour une installation neuve
L’URL du serveur vocal doit utiliser votre nom DNS TLS, pas une IP. Le mode à deux clés utilise RpcKeyFile ET CredKeyFile. Les adresses example.org sont des exemples non fonctionnels. L’API de conférences AdHoc n’est configurée qu’après son déploiement.
Exemple pour votre propre installation : adaptez tous les domaines, chemins et noms.
[WebRtcVoice] Enabled = true SpatialVoiceService = WebRtcVoice.dll:WebRtcVoiceServiceConnector NonSpatialVoiceService = WebRtcVoice.dll:WebRtcVoiceServiceConnector WebRtcVoiceServerURI = https://voice.example.org:9443 RpcKeyFile = voice_rpc_key CredKeyFile = voice_cred_key MessageDetails = false StunServers = stun:stun.l.google.com:19302,stun:stun1.l.google.com:19302 ; ConferenceApiUrl = https://conference.example.org/adhocconf/wolf_api.php [VivoxVoice] enabled = false
Pourquoi désactiver Vivox
Les deux modules vocaux peuvent enregistrer la même capability. Dans le modèle documenté, [VivoxVoice] enabled=false évite cette concurrence. La voix doit aussi être autorisée au niveau estate et parcelle pour que le viewer demande une connexion.
Modèle historique BloodMoon : une clé et IP autorisées
Il existe une installation BloodMoon historiquement validée avec une clé de credentials et une liste d’IP autorisées. Ne la convertissez pas en deux clés sans planifier la mise à jour de tous les simulateurs : un serveur configuré avec rpc_key rejette les anciens modules incapables de l’envoyer.
Fonctionnement sans serveur Janus
Le connecteur de service WebRtcVoice parle au serveur de voix BloodMoon via des requêtes adaptées. Il n’est pas nécessaire de déployer un serveur Janus en complément pour ce système.