Começar a usar o Android XR Interaction Framework para Unity

Dispositivos XR relevantes
Estas orientações ajudam você a criar experiências para esses tipos de dispositivos XR.
Saiba mais sobre esses dispositivos →
Headsets XR
Óculos XR com fio
Saiba mais sobre esses dispositivos →

O Android XR Interaction Framework (AXRIF) oferece interações familiares, de alto nível e opinativas para aplicativos OpenXR no Android XR. O AXRIF preenche a lacuna entre interações no nível do sistema e no app, oferecendo uma maneira intuitiva e coesa de lidar com a entrada do usuário.

Siga este guia para configurar e começar a usar o AXRIF com o Unity.

Pré-requisitos

Antes de começar, verifique se o ambiente de desenvolvimento atende aos seguintes requisitos:

Configurar o Unity

Antes de testar a cena de exemplo, é preciso configurar o Unity para AXRIF. Siga as etapas nas seções abaixo para concluir esse processo.

Importe o pacote AXRIF

Primeiro, instale o pacote AXRIF e as dependências dele:

  1. Acesse Window > Package Manager.
  2. Abra o menu de adição na barra de ferramentas do Package Manager.
  3. Nas opções para adicionar pacotes, clique em + (sinal de adição).

  4. No menu suspenso, selecione Instalar pacote do URL do Git.

    Importe o pacote AXRIF usando o URL do Git.

  5. Digite o seguinte URL:

    https://github.com/android-xr/android-xr-interaction-framework-unity-package.git

  6. Clique em Instalar.

    Detalhes do pacote AXRIF no Unity Package Manager.

Verificar a versão do XR Interaction Toolkit

O pacote AXRIF funciona com o Unity XR Interaction Toolkit (XRIT) e não o substitui. Como o pacote AXRIF define uma dependência do XRIT, o Unity deve ter instalado o XRIT quando você instalou o pacote AXRIF nas etapas anteriores. No entanto, verifique se a versão 3.3.1 ou mais recente está instalada em Window > Package Manager > Unity Registry > XR Interaction Toolkit no Unity Editor.

Figura 1. Verifique a versão instalada do XR Interaction Toolkit no Unity Editor.

Selecione o perfil de build do Android XR

Selecione o perfil de build do Android XR para ativar as extensões OpenXR e as configurações de build adequadas para o Android XR:

  1. Navegue até File > Build Profiles.

  2. Clique em Android XR e em Switch Platform.

    Selecione o perfil de build do Android XR nas configurações do Unity.

Definir as configurações do OpenXR

Configure as definições do OpenXR do Unity para que ele possa acessar os dados necessários do OpenXR:

  1. Acesse Edit > Project Settings > XR Plug-in Management > OpenXR.
  2. Na guia Android, clique em + (mais) na seção Perfis de interação ativados.

  3. Adicione um dos seguintes perfis, dependendo das necessidades do seu app:

    • Perfil de interação de olhar
    • Perfil de interação com as mãos
    • Perfil do controlador Oculus Touch
    • Perfil de interação do mouse do Android XR

  4. Na lista de recursos em XR Plug-in Management > OpenXR, ative os seguintes recursos:

    • Android XR (extensões): camada de composição de passagem
    • Android XR (extensões): gerenciamento de sessão
    • Suporte para Android XR
    • Android XR: câmera de RA
    • Android XR: sessão de RA
    • Android XR: dados de malha da mão em RA
    • Suporte para camadas de composição
    • Subsistema de rastreamento de mãos

Realizar a validação do projeto

Faça a validação do projeto para corrigir erros do OpenXR na configuração do projeto:

  1. Navegue até Edit > Project Settings > XR Plug-in Management > Project Validation.

  2. Corrija os alertas ou avisos pendentes para garantir que os erros de tempo de execução não afetem a compilação.

    Resolva os problemas pendentes do OpenXR realizando a validação do projeto.

Usar a cena de exemplo

Agora que você concluiu a configuração e a configuração preliminares, é possível usar a cena de exemplo do AXRIF. Siga as etapas nas seções a seguir para acessar a cena de exemplo e testá-la.

Importar pacotes de amostra do XRIT e a amostra do AXRIF

A cena de exemplo do AXRIF depende dos pacotes de recursos iniciais do XR Interaction Toolkit (XRIT) do Unity e da demonstração de interação com as mãos.

Importar pacotes de amostra do XRIT

Importe os pacotes de amostra do XRIT de que a amostra do AXRIF depende:

  1. Acesse Window > Package Manager.
  2. Selecione XR Interaction Toolkit na lista de pacotes.

  3. Na guia Exemplos, clique em Importar ao lado de Recursos iniciais e Demonstração de interação com as mãos.

    Importe os pacotes de amostra do XRIT necessários antes de importar o pacote de amostra do AXRIF.

Importar a amostra do AXRIF

Importe a amostra do AXRIF para receber a cena de exemplo:

  1. Acesse Window > Package Manager.
  2. Selecione Android XR Interaction Framework na lista de pacotes.

  3. Na guia Amostras, clique em Importar ao lado de Amostra do Axrif.

    Importe a amostra do AXRIF no gerenciador de pacotes do Unity.

Abrir a cena

Depois de importar os pacotes de amostra necessários, abra a cena:

  1. Navegue até Assets > Samples > Android XR Interaction Framework > [AXRIF Version Number] > Axrif Sample.

  2. Abra AxrifDemoScene.

    Importe o pacote de amostra do AXRIF no gerenciador de pacotes do Unity.

Conheça os prefabs

A cena vem pré-configurada usando prefabs modulares localizados em Packages > Android XR Interaction Framework > Prefabs.

Prefabs de interação

Os prefabs do Axrif Interactor impulsionam a mecânica do interator Unity XRIT usando as modalidades de entrada correspondentes da seguinte lista:

  • Raio da mão/do controlador:
    • Axrif Left Interactor: usa o raycast ou o controlador da mão esquerda.
    • Axrif Right Interactor: usa o raycast ou o controlador da mão direita.
  • Pinça de olhar:
    • Axrif Left GazePinch Interactor: usa o olhar e o movimento da mão esquerda ao fazer um gesto de pinça.
    • Axrif Right GazePinch Interactor: usa o olhar e o movimento da mão direita ao fazer um gesto de pinça.
    • Axrif Gaze Interactor: usa o olhar para apontar apenas.
  • Hand Poke:
    • Axrif Left Poke Interactor: usa o dedo indicador esquerdo ao tocar em elementos interativos.
    • Axrif Right Poke Interactor: usa o dedo indicador direito ao tocar em elementos interativos.
  • Mouse:
    • Axrif Mouse Interactor - Uses Android XR spatial mouse.

Axrif Interaction Manager e prefabs de origem

  • Gerenciador de interação do Axrif: esse prefab é o hub central do AXRIF na cena. O prefab abriga o componente Axrif Interaction Manager, que foi projetado para funcionar em conjunto com o XRIT XR Interaction Manager. Esse prefab é responsável por:

    • Inicializar e gerenciar os principais subsistemas do AXRIF em tempo de execução.
    • Processamento e roteamento de dados de entrada do OpenXR usando o adaptador de entrada do Interaction Framework.
    • Observar estados de UI e collider usando o Interaction Framework Scene Integrator.

  • Axrif XR Origin: serve como personagem principal e driver de câmera e gerencia visualizadores de malha de mão.

Configurar ações de entrada

Para fazer a ponte entre os dados de tempo de execução do OpenXR e as ações de entrada do Unity, registre associações de mapa em todo o projeto:

  1. Acesse Packages > Android XR Interaction Framework > InputActions.
  2. Localize AndroidXRInteractionFramework Input Actions.

  3. Clique em Atribuir como as ações de entrada em todo o projeto.

    Configure ações de entrada para o Unity fazer a ponte entre os dados de tempo de execução e as ações de entrada do Unity.

Modificar interações

Usando o prefab do Axrif Interaction Manager, é possível ativar ou desativar diferentes modalidades de entrada. O AXRIF oferece suporte às seguintes modalidades de entrada:

  • Raycasting do controlador
  • Pinçar e olhar
  • Raycasting de mão
  • Mão direta
  • Interações do mouse.

É possível configurar modalidades de entrada diretamente no Inspector, na seção Configurations do componente Interaction Framework Manager.

Figura 2. Configure as modalidades de entrada no Inspector.

Criar a amostra

Quando quiser criar a amostra, clique em Build ou Build and Run no Unity Editor.