Documentação

Óculos de RA e headsets

Para ver seus projetos do AR Works em óculos de RA ou em um headset, você precisa do app AREngine. Só um link ou um QR code não basta.

Por que um link não basta

Um link do AR Works abre em um navegador. No celular isso funciona, mas um navegador em óculos ou em um headset não consegue usar as câmeras e os sensores do dispositivo como o app AREngine usa.

  • O navegador de um headset não dá nenhuma imagem da câmera a uma página da web, então o rastreamento de imagens e o rastreamento de mãos não funcionam ali.
  • O visualizador web tem um modo de RA para headsets, chamado WebXR, mas ele nunca foi executado em um headset.

O AREngine reproduz seu projeto a partir de um arquivo .arengine que você baixa do AR Works, e não a partir de um link.

Qual app cada dispositivo precisa

Há três tipos de dispositivo, e cada um precisa do AREngine em um lugar diferente.

Óculos de exibição que se conectam a um celular

Os óculos XREAL One, One Pro e da linha XREAL Air, VITURE, Rokid Max e RayNeo Air se conectam a um celular por cabo. Eles não têm câmera que um app possa usar.

  • Instale o AREngine no seu celular Android, e não nos óculos.
  • Abra um projeto no AREngine e conecte os óculos. Os óculos que o app conhece mostram o projeto sozinhos. Se os seus não mostrarem, escolha Mostrar nos óculos no menu do player.
  • O celular vira um touchpad: arraste o dedo para mover o ponteiro, um pequeno círculo nos óculos, e toque para selecionar. Sobre algo que reage a um toque, o círculo vira um ponto dourado maior. Toque com dois dedos para abrir um menu nos óculos.
  • Em óculos XREAL, o AREngine tenta girar a cena quando você vira a cabeça. Os óculos VITURE, Rokid Max e RayNeo Air mostram uma visão 3D fixa: arraste o dedo no celular para olhar ao redor.
  • Nenhuma câmera vê sua imagem impressa, então um projeto que começa em uma imagem é mostrado sem ela.

Testadores estão experimentando o AREngine agora nos seus óculos de realidade aumentada. O primeiro a usá-lo foi com óculos XREAL One Pro, em celulares com Android 12 e com o Android mais recente. O AREngine 0.1.8 corrige o que ele encontrou: nos óculos XREAL One, One Pro e 1S, todas as cenas apareciam de cabeça para baixo. Na 0.1.8, um projeto de ambiente também começa sozinho na sua frente.

Óculos Android com câmera própria

INMO Air 3, Rokid Glasses, RayNeo X3 Pro e Vuzix Blade 2 são pequenos computadores Android com câmera própria.

  • Instale o AREngine nos próprios óculos. O AREngine acompanha imagens impressas, o ambiente e suas mãos com a câmera dos óculos, como no celular.
  • Você vê o mundo real pelas lentes transparentes, e o projeto é desenhado por cima.
  • Escolha Alinhar com o mundo real no menu do player. Segure uma impressão da imagem do projeto à sua frente e mova o contorno até ele ficar sobre a impressão.
  • Em óculos sem tela sensível ao toque, copie o arquivo .arengine do projeto para a pasta do próprio app nos óculos. A tela inicial do app passa a listá-lo.

Headsets

Meta Quest 3 e 3S, Samsung Galaxy XR, XREAL Aura, PICO 4 Ultra e outros headsets OpenXR precisam de uma versão separada do app, chamada AREngine XR.

  • O AREngine XR não está em nenhuma loja de apps. Baixe-o na página do AREngine, no ZIP do AREngine com o guia de configuração, e instale-o manualmente no headset. Ele fica ao lado do app AREngine comum, sem substituí-lo.
  • O rastreamento do próprio headset posiciona uma cena de superfície real, e suas mãos vêm do rastreamento de mãos do headset. Para selecionar, faça um movimento de pinça ou aperte o gatilho de um controle.
  • Um projeto que começa em uma imagem impressa é mostrado sem a imagem.

Ajude a testar

Se você tem óculos de RA ou um headset, um relatório do dispositivo nos ajuda a fazer o AREngine funcionar nele. O relatório não contém nada pessoal.

  1. Abra o AREngine nos óculos ou no headset, ou no celular em que seus óculos estão conectados.
  2. Abra Sobre e depois Relatório do dispositivo.
  3. Toque em Enviar para o AR Works. O navegador abre uma página em ar.works que mostra o relatório, e nada é enviado até você tocar em Enviar nela.

Baixe o app

O app AREngine para Android está na página do AREngine. Reproduzir no aplicativo AREngine explica como criar um arquivo .arengine a partir do seu projeto.