janus server

Serveur de présence Janus VR

Cette version est celle que les sites VR s'exécutent, qui est le serveur par défaut, sauf si un autre est spécifié dans votre code <Room> . Lisez ici pour savoir comment votre chambre peut spécifier un autre serveur.

Introduction

Le serveur de présence VR Janus est un projet open source lancé par Lisa Croxford qui permet à un client JanUSVR de partager des informations avec un autre client. Il permet le multijoueur. Le logiciel Server est ce qui permet à chacun des clients JanUSVR de savoir où les autres avatars sont géographiquement et qui d'autre se trouve dans le même espace virtuel. C'est aussi ce qui permet des choses comme le chat.

Si vous avez besoin de plus d'informations ou si vous souhaitez vous impliquer, vous trouverez la plupart des amateurs de JanUSVR sur le Sous-Soudredit JanUSVR. Vous pouvez également lire le fichier CONTRIBUTORS.md à la racine de ce référentiel.

Si vous souhaitez comprendre comment un client interagit avec le serveur Janus VR Présence, consultez l' API Documentation.md à la racine de ce référentiel.

Installation

1. Téléchargez et installez le nœud à partir de Nodejs.org
2. Clone ce dépôt ou téléchargez la dernière version via la page des versions sur GitHub.
3. cd dans la racine du référentiel où se trouve server.js et exécuter npm install pour installer toutes les dépendances du module répertoriées dans package.json . Les modules seront placés dans le dossier node_modules et sont requis pour que le serveur puisse démarrer.
4. Copiez config-example.js à config.js et modifiez les variables dont vous avez besoin pour exécuter votre serveur. C'est assez bien commenté pour vous guider.

SSL

SSL n'est pas nécessaire pour exécuter votre serveur, mais il est recommandé. À tout le moins, vous devriez passer par le processus SSL auto-signé ci-dessous.

---

SSL auto-signé

Exécutez le script ./generate_key dans la racine du référentiel pour générer un certificat SSL pour le serveur.

• Lorsqu'on lui a demandé de fournir un nom commun pour le serveur Entrez le nom de domaine sur lequel le serveur s'exécutera. C'est-à-dire yourdomain.com . Si l'exécution d'une version de développement du serveur sur OSX, vous pouvez également utiliser votre nom Bonjour, c'est-à-dire yourcomputer.local . Sur OSX, vous pouvez voir le nom de bonjour de votre ordinateur en allant aux préférences système -> partager et chercher sous le champ Nom de l'ordinateur.
• Lorsqu'on lui a demandé de fournir un mot de passe de défi lors de la génération du certificat SSL, appuyez sur Entrée pour sauter la définition d'un mot de passe.

SSL certifié

Si vous avez un certificat SSL valide:

1. Enregistrez le fichier clé sous la clé de CERT / Server-key.pem
2. Enregistrez le fichier de certificat en tant que certificat / serveur-certe.pem
3. Enregistrez les certificats intermédiaires de votre CA en tant que CERT / CABUNDLE.PEM

Exécution du serveur

1. cd à la racine du référentiel où se trouve server.js .
2. Exécutez la commande suivante pour démarrer le serveur: node server.js . Si vous voulez que cela s'exécute en permanence, vous pouvez rechercher à utiliser forever ou pm2 qui sont des modules de nœud construits spécifiquement pour exécuter d'autres applications de serveur de nœuds.
3. Lancez le client JanUSVR avec des paramètres pour vous connecter à votre serveur.

• Les fenêtres créent un raccourci vers JanUSVR et ajoutent les arguments suivants après le chemin de l'exécutable JanUSVR
  • -server my.server.com -port 5566 où my.server.com est l'adresse IP de votre ordinateur ( 127.0.0.1 ou localhost devrait également fonctionner ici) et où 5566 est le port sur lequel le serveur fonctionne comme défini dans config.js .
• OSX Vous pouvez exécuter le client à partir de la ligne de commande en naviguant vers janusvr.app/Contents/MacOS/ et en cours d'exécution
  • ./janusvr -server my.server.com -port 5566 pour non-ssl
  • ./janusvr -server my.server.com -port 5567 pour SSL

Contributif

Nous avons un guide des contributeurs dans le fichier contributeurs.md trouvé dans ce répertoire.

Dépannage

Je ne vois pas d'autres personnes lors de l'utilisation de JanUSVR et je sais que d'autres ont le même serveur configuré.

Press / Une fois que JanUSVR a commencé. JanUSVR répertorie tous les serveurs auxquels vous essayez de vous connecter ou êtes connecté. Vous devriez voir votre serveur dans cette liste. Si votre serveur est rouge, cela signifie que JanUSVR ne peut pas s'y connecter. Vérifiez les paramètres du pare-feu sur le serveur pour vous assurer que le port 5566 et 5567 (pour SSL) est ouvert et capable de recevoir du trafic. Vérifiez le fichier server.log sur le serveur pour voir s'il y a des erreurs.

J'ai entré les mauvais détails pour ma clé après avoir exécuté ./generate_key .

./generate_key générera 3 fichiers en fonction de votre entrée:

• /cert/server-key.pem
• /cert/server-cert.pem
• /cert/cabundle.pem
  Supprimez-les simplement et exécutez à nouveau './generate_key'.

J'ai un problème général et j'ai besoin de dispositions d'informations sur l'application du serveur.

Consultez le fichier server.log . Just It et vous verrez le journal écrit au fur et à mesure que les activités se déroulent - par exemple, la connexion, etc.

Licence

Ce projet est autorisé sous la licence du MIT. Voir le fichier licence.txt dans ce répertoire pour un texte complet.