janus server

Janus VR Presence Server

Esta versão é a que os sites de VR são executados, que é o servidor padrão, a menos que outro seja especificado no seu código <Room> . Leia aqui para saber como seu quarto pode especificar um servidor diferente.

Introdução

O Janus VR Presence Server é um projeto de código aberto iniciado por Lisa Croxford, que permite que um cliente Janusvr compartilhe informações com outro cliente. Permite multiplayer. O software do servidor é o que permite que cada um dos clientes Janusvr saiba onde outros avatares estão geograficamente e quem mais está no mesmo espaço virtual. É também o que permite coisas como bate -papo.

Se você precisar de mais informações ou quiser se envolver, encontrará a maioria dos entusiastas de Janusvr no subreddit de Janusvr. Você também pode ler o arquivo CONTRIBUTORS.md na raiz deste repositório.

Se você deseja entender como um cliente interage com o servidor Janus VR Presence, consulte a API Documentation.md na raiz deste repositório.

Instalação

1. Faça o download e instale o node de nodejs.org
2. Clone este repositório ou faça o download do lançamento mais recente na página de lançamentos no Github.
3. cd na raiz do repositório onde server.js está localizado e execute npm install para instalar todas as dependências do módulo listadas no package.json . Os módulos serão colocados na pasta node_modules e são necessários para o início do servidor.
4. Copie config-example.js para config.js e altere qualquer uma das variáveis necessárias para executar seu servidor. É bastante bem comentado para guiá -lo.

Ssl

O SSL não é obrigado a executar seu servidor, mas é recomendado. No mínimo, você deve passar pelo processo SSL autoassinado descrito abaixo.

---

SSL autoassinado

Execute o script ./generate_key na raiz do repositório para gerar um certificado SSL para o servidor.

• Quando solicitado a fornecer um nome comum para o servidor, insira o nome de domínio em que o servidor estará em execução. Ou seja, yourdomain.com . Se executar uma versão de desenvolvimento do servidor no OSX, você também poderá usar seu nome Bonjour, ou seja, yourcomputer.local . No OSX, você pode ver o nome Bonjour do seu computador indo para as preferências do sistema -> Compartilhando e olhando no campo Nome do computador.
• Quando solicitado a fornecer uma senha de desafio enquanto gera o certificado SSL Pressione Enter para pular a configuração de uma senha.

SSL certificado

Se você tiver um certificado SSL válido:

1. Salve o arquivo-chave como cert/servidor-key.pem
2. Salve o arquivo de certificado como cert/servider-cert.pem
3. Salve os certificados intermediários da sua CA como certificados/CABNELDE.PEM

Executando o servidor

1. cd para a raiz do repositório onde server.js está localizado.
2. Execute o seguinte comando para iniciar o servidor: node server.js . Se você deseja que isso seja executado continuamente, consulte o uso forever ou pm2 , que são módulos de nó criados especificamente para executar outros aplicativos do Node Server.
3. Inicie o cliente JANUSVR com parâmetros para se conectar ao seu servidor.

• O Windows cria um atalho para Janusvr e adiciona os seguintes argumentos após o caminho para o executável Janusvr
  • -server my.server.com -port 5566 onde my.server.com é o endereço IP do seu computador ( 127.0.0.1 ou localhost também deve funcionar aqui) e onde 5566 é a porta em que o servidor está sendo executado conforme definido em config.js .
• OSX Você pode executar o cliente da linha de comando navegando para janusvr.app/Contents/MacOS/ e executando
  • ./janusvr -server my.server.com -port 5566 para não -SSL
  • ./janusvr -server my.server.com -port 5567 para SSL

Contribuindo

Temos um guia dos colaboradores no arquivo colaborador.md encontrado neste diretório.

Solução de problemas

Não consigo ver outras pessoas ao usar Janusvr e sei que outras pessoas têm o mesmo servidor configurado.

Pressione / Uma vez Janusvr começar. Janusvr listará todos os servidores aos quais você está tentando se conectar ou está conectado. Você deve ver seu servidor nesta lista. Se o seu servidor estiver vermelho, isso significa que Janusvr não pode se conectar a ele. Verifique as configurações do firewall no servidor para garantir que a porta 5566 e 5567 (para SSL) esteja aberta e capaz de receber tráfego. Verifique o arquivo server.log no servidor para ver se há algum erro.

Digitei os detalhes errados para a minha chave após a execução ./generate_key .

./generate_key gerará 3 arquivos com base na sua entrada:

• /cert/server-key.pem
• /cert/server-cert.pem
• /cert/cabundle.pem
  Basta excluir estes e executar './gereate_key' novamente.

Tenho um problema geral e preciso de algumas informações sobre solução de problemas sobre o aplicativo do servidor.

Confira o arquivo server.log . Basta segui -lo e você verá o registro sendo escrito à medida que as atividades ocorrem - por exemplo, logon etc.

Licença

Este projeto está licenciado sob a licença do MIT. Consulte o arquivo License.txt neste diretório para obter um texto completo.