Habilitar suporte para headsets em projetos EasyAR
Este documento descreve como habilitar o suporte para headsets em uma cena existente do EasyAR Unity.
Antes de começar
- Leia Suporte para headsets no EasyAR para entender os tipos de headsets suportados pelo EasyAR e os recursos que podem ser executados neles.
- Leia Suporte para headsets no EasyAR Unity para entender a arquitetura geral do suporte para headsets no EasyAR Unity.
Este artigo pressupõe que você já tenha uma cena funcional com o EasyAR. Se precisar criar essa cena ou adicionar componentes do EasyAR a uma cena de headset, consulte:
Adicionar componentes de headset à cena
Antes de adicionar componentes de headset à cena, geralmente é necessário remover a câmera e a XR Origin existentes.
Remover câmera e XR Origin
Exclua a câmera existente na cena.
Se a cena já contiver um XR Origin, seja do EasyAR ou da estrutura XR do Unity, na maioria dos casos ele deve ser excluído.
Dica
Em usos avançados, você pode decidir se deseja excluí-lo conforme sua necessidade.
Adicionar componentes de headset
Siga as instruções oficiais do headset para adicionar seus componentes. Aqui, usamos o headset Pico como exemplo; em caso de conflito com as instruções oficiais, siga as oficiais.
Adicione um XR Interaction Manager usando o menu:
Adicione um XR Origin usando o menu:
Antes de executar, certifique-se de ler as instruções oficiais do headset para entender como uma cena com SDK de headset deve ser configurada e executada.
Configurar frame source
Dispositivos com suporte integrado
Selecione AR Session (EasyAR) e clique com o botão direito, então use o menu EasyAR Sense > Head-mounted Display (Built-in) > Frame Source : [Name] (keep it only) para criar a frame source [Name] e manter apenas ela.
Por exemplo, configurar a frame source para Apple Vision Pro:
Após a operação, a frame source na sessão ficará assim:
Dica
Se a sessão contiver a frame source correspondente ao dispositivo e for a primeira frame source disponível no dispositivo (como na imagem acima, onde no sistema visionOS a VisionOS ARKit é a primeira disponível), não é necessário modificar. Algumas sessões criadas por padrão pelo menu se enquadram nesse caso.
Dispositivos com suporte estendido
Selecione AR Session (EasyAR) e clique com o botão direito, então use o menu EasyAR Sense > Extensions > Frame Source : [Name] (keep it only) para criar a frame source [Name] e manter apenas ela.
Por exemplo, configurar a frame source para headset Pico:
Após a operação, a frame source na sessão ficará assim:
Suporte multiplataforma
Se precisar que a cena funcione em diferentes dispositivos, mantenha outras frame sources e garanta que a frame source atual do dispositivo possa ser selecionada.
Usar itens de menu sem (keep it only) adiciona apenas a frame source sem excluir outras. Por exemplo, EasyAR Sense > Extensions > Frame Source : Pico criará uma frame source para Pico no final de todas as frame sources da sessão. Geralmente, após adicionar assim, você precisará movê-la para a posição adequada.
Dica
Em usos avançados, você pode ajustar a posição da frame source conforme necessário ou modificá-la via código.
Próximos passos
- Configuração de projeto Vision Pro
- Configuração de projeto XREAL
- Configuração de projeto para outros dispositivos Android