OpenSimulator · FR

Configuration des simulateurs : wolfvoice.ini

Emplacement exact, modules DLL, clés partagées, sécurité et vérifications depuis chaque région.

Cette documentation concerne une pile WebRTC précise. Respectez les versions compatibles et consultez les sources liées avant de modifier une installation de production.

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.

BloodMoon Voice — serveur vocalRelease v1.0.0 et installateur
Modules WebRTC OpenSimulatorRelease v0.9.3.1-webrtc.3, ZIP DLL/PDB
OpenSimulator AdHoc ConferencesDépôt PHP/MySQL et guide d’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.

Lire la suite et sources