Instruções

Como começar a usar o Unity e o Android XR

Leitura de 6 min
Ver o perfil de Luke Hopkins
Luke Hopkins Engenheiro de relações com desenvolvedores, Android

O Samsung Galaxy XR já chegou, com tecnologia Android XR! Este post faz parte da Semana de Destaques do Android XR, em que oferecemos recursos, como posts do blog, vídeos, exemplos de código e muito mais, para ajudar você a aprender, criar e preparar seus apps para o Android XR. 

Nunca houve um momento melhor para entrar no desenvolvimento de XR. Em dezembro do ano passado, anunciamos o Android XR, a nova plataforma Android do Google criada com base em padrões abertos, como OpenXR e Vulkan, que torna o desenvolvimento de XR mais acessível do que nunca.


E, quando combinado com as ferramentas de XR do Unity, você tem uma stack de desenvolvimento poderosa e madura. Isso possibilita criar e implantar apps de XR que funcionam em vários dispositivos.

openxr_face_tracking2.webp

Mesmo que você nunca tenha desenvolvido para XR, queremos ajudar você a começar.

Neste blog, vamos mostrar como começar a desenvolver para Android XR e Unity. Vamos focar nas etapas práticas para configurar seu ambiente, entender o ecossistema de pacotes e começar a criar.

Ao final deste blog, você vai entender bem:

  • O ecossistema de pacotes
  • Etapas essenciais de configuração
  • Métodos de entrada
  • Privacidade e permissões
  • Camadas de composição

Unity para desenvolvimento no Android XR

Você pode escolher o Unity pela compatibilidade multiplataforma, que permite criar uma vez e implantar no Android XR e em outros dispositivos XR.

Ao usar o Unity, você se beneficia do ecossistema e das ferramentas de XR maduros. Ele já tem pacotes estabelecidos, como o XR Interaction Toolkit, o plug-in OpenXR, as camadas de composição de XR, o XR Hands, uma ampla loja de recursos cheia de componentes e modelos prontos para XR, além de ferramentas de simulação e teste de XR. E como o Unity 6 foi lançado em novembro do ano passado, você também vai se beneficiar da performance aprimorada do Universal Render Pipeline (URP), do melhor suporte a gráficos Vulkan e dos perfis de build aprimorados.

Confira alguns exemplos de projetos para ter uma ideia do que pode ser feito:

Configuração essencial: sua base de desenvolvimento

Requisitos e instalação do Unity 6

Você vai precisar do Unity 6 para criar seu app, já que as versões anteriores não são compatíveis com o Android XR. Instale primeiro o Unity Hub e depois o Unity 6 com o módulo Android Build Support, seguindo estas etapas.

unity6.png

Perfis de build do Android XR: simplificando a configuração

Os perfis de build do Unity são recursos do projeto que armazenam as configurações específicas da plataforma. Em vez de definir manualmente de 15 a 20 configurações diferentes em vários menus, use um perfil de build para fazer isso automaticamente.
Você pode criar seus próprios perfis de build, mas, por enquanto, recomendamos usar o perfil de build dedicado do Android XR que criamos.

Para selecionar seu perfil de build, acesse File > Build Profile no projeto do Unity. Para ver as instruções completas, consulte a página do fluxo de trabalho Desenvolver para Android XR.

Se você fizer mudanças, poderá criar um novo perfil de build para compartilhar com sua equipe. Dessa forma, você garante uma experiência de build consistente em todos os aspectos.

buildprofiles.png

Depois dessas etapas, você poderá criar e executar o APK para dispositivos Android XR.

API de gráficos: por que a Vulkan é importante

Depois de configurar o projeto do Unity com um perfil de build do Android XR, recomendamos que você defina o Vulkan como sua API gráfica. O Android XR foi criado como uma plataforma que prioriza o Vulkan. Em março de 2025, o Google anunciou que o Vulkan agora é a API gráfica oficial do Android. É uma API gráfica moderna de baixo nível que ajuda os desenvolvedores a maximizar o desempenho das GPUs modernas e desbloqueia recursos avançados, como traçado de raio e multithreading, para visuais de jogos realistas e imersivos.

Esses padrões oferecem a melhor compatibilidade para seus aplicativos atuais e facilitam os problemas e custos de portabilidade. Além disso, ele permite ativar recursos avançados do Android XR, como o URP Application Space Warp e a renderização foveada. 

O Unity 6 lida com o Vulkan automaticamente. Portanto, quando você usa o perfil de build do Android XR, o Unity configura o Vulkan como sua API gráfica. Isso garante que você tenha acesso a todos os recursos avançados do Android XR sem nenhuma configuração manual.

Para verificar as configurações da API de gráficos, acesse "Edit" > "Configurações do projeto" > "Player" > "Android tab" > "Other settings" > "Graphics APIs".

graphics-api.png
appentrypoint.png

Noções básicas sobre o ecossistema de pacotes

Há dois pacotes diferentes que você pode usar para o Android XR no Unity. Uma é usando as extensões do Android XR para Unity, e a outra é usando o pacote Unity OpenXR: Android XR.

Parece que estamos falando da mesma coisa, mas não é bem assim.

O pacote Unity OpenXR: Android XR é o pacote oficial do Unity para suporte ao Android XR. Ele oferece a maioria dos recursos do Android XR, disponibilizados pelos padrões do OpenXR. Ele também permite a integração da AR Foundation para recursos de realidade mista. O principal benefício de usar o pacote Unity OpenXR: Android XR é que ele oferece uma API unificada para oferecer suporte a dispositivos XR.


Já as extensões do Android XR para Unity são o pacote de XR do Google, projetado especificamente para o desenvolvimento de dispositivos Android XR. Ele complementa o pacote Unity OpenXR com recursos adicionais, como modos de combinação de ambiente, malha de cena, rastreamento de imagens e rastreamento corporal. A desvantagem é que você só pode desenvolver para dispositivos Android XR.


A escolha depende das suas necessidades específicas, mas geralmente recomendamos o Unity OpenXR: Android XR, porque ele oferece muito mais flexibilidade para os dispositivos compatíveis com seu app. Depois, com base nos requisitos do aplicativo, você pode adicionar as extensões do Android XR para Unity.

Como instalar pacotes

Para adicionar um novo pacote, com o projeto aberto no Unity, selecione "Window" > "Package Management" > "Package Manager".

Nela, você pode instalar os seguintes pacotes na guia "Unity Registry":

packagemanager.png

Para instalar o pacote do Android XR para Unity pelo GitHub, selecione o ícone ➕, escolha "Install package from git URL" e insira "https://github.com/android/android-xr-unity-package.git".

packagemanager2.png

Recursos necessários do OpenXR

Agora que você instalou os pacotes necessários, vamos ativar alguns recursos principais para que o projeto funcione.

Ative a configuração do OpenXR para Android: "Edit" -> "Project Settings" -> "XR Plugin Management" -> clique em "Android" e ative o OpenXR.

xrpluginmgmt.png

Em seguida, precisamos ativar o suporte para: "Android XR support". Vamos abordar outros recursos do OpenXR conforme necessário. Por enquanto, só precisamos que o suporte ao Android XR esteja ativado.

Entrada

O Android XR aceita entrada por mãos, voz, acompanhamento ocular, teclado e controles. Recomendamos instalar o XR Interaction Toolkit e o XR Hands, porque eles contêm os melhores prefabs para começar. Ao usar esses prefabs, você terá tudo o que precisa para oferecer suporte a mãos e controles no seu app.

xrinteractiontoolkit.png

Depois de instalar o XR Hands e o XR Interaction Toolkit, recomendo importar os recursos iniciais e a demonstração de interação com as mãos. Em seguida, ative os perfis Hand Interaction e Khronos Simple Controller e os recursos Hand Tracking Subsystem e Meta Hand Tracking Aim.

Para editar essas configurações, acesse Edit > Project Settings > XR Plug-in Management > OpenXR.

profiles.png

Também recomendamos o prefab do Unity, XR Origin, que representa a posição e a orientação do usuário no espaço XR. Ele contém o equipamento da câmera e os componentes de rastreamento necessários para renderizar sua experiência de XR do ponto de vista correto.

A maneira mais simples de adicionar esse prefab é importá-lo da demonstração de integração de mãos que importamos anteriormente, que pode ser encontrada aqui: "Hands Integration Toolkit" > "Hand Interaction" > "Prefabs" > "XR Origin".

prefabs.png

Recomendo usar esse Prefab em vez da opção "XR Origin" nos objetos do jogo, porque ele usa o XR Input Modality Manager, que alterna automaticamente entre as mãos e os controles dos usuários. Isso vai garantir o melhor resultado ao alternar entre as mãos e os controles.

Privacidade e permissões: como conquistar a confiança do usuário

Seja qual for o app, você precisará capturar as permissões de execução dos usuários. Isso ocorre porque a compreensão de cena, o acompanhamento ocular, a captura de expressões faciais e a captura de movimentos das mãos fornecem acesso a dados que podem ser mais sensíveis para o usuário.

Esses recursos fornecem informações pessoais mais detalhadas do que os apps tradicionais para computadores ou dispositivos móveis. Por isso, as permissões de execução garantem que os usuários tenham controle total sobre os dados que compartilham. Para manter as políticas de segurança e privacidade do Android, o Android XR tem permissões para cada um desses recursos.

Por exemplo, se você usar o pacote XR Hands para gestos com a mão personalizados, precisará solicitar a permissão de captura de movimentos das mãos (veja abaixo), já que esse pacote precisa rastrear muitas informações sobre as mãos do usuário. Isso inclui o rastreamento de poses de articulações das mãos e velocidades angulares e lineares.

Observação: para conferir uma lista completa de extensões que exigem permissões, consulte as informações no site para desenvolvedores de XR.

const string k_Permission = "android.permission.HAND_TRACKING";

#if UNITY_ANDROID
void Start()
{
    if (!Permission.HasUserAuthorizedPermission(k_Permission))
    {
        var callbacks = new PermissionCallbacks();
        callbacks.PermissionDenied += OnPermissionDenied;
        callbacks.PermissionGranted += OnPermissionGranted;
        
        Permission.RequestUserPermission(k_Permission, callbacks);
    }
}

void OnPermissionDenied(string permission)
{
    // handle denied permission
}


void OnPermissionGranted(string permission)
{
    // handle granted permission
}

#endif // UNITY_ANDROID

Como melhorar a qualidade visual com camadas de composição

Uma camada de composição é a maneira recomendada de renderizar elementos da interface. Elas possibilitam mostrar elementos com uma qualidade muito maior em comparação com o pipeline de renderização padrão do Unity, já que tudo é renderizado diretamente no compositor da plataforma.

Por exemplo, se você estiver exibindo texto, a renderização padrão do Unity terá mais chances de apresentar texto desfocado, bordas suaves e artefatos visuais. Já com as camadas de composição, o texto fica mais claro, os contornos ficam mais nítidos e a experiência é melhor no geral.


Além de texto, ele também renderiza vídeos, imagens e elementos da interface com uma qualidade muito maior. Para isso, ele usa o suporte nativo para as camadas de composição do ambiente de execução.

Para ativar as camadas de composição, abra o Gerenciador de Pacotes, selecione "Unity Register" e instale "XR Composition Layers".

Criar e executar

Agora que você instalou os pacotes do OpenXR, ativou os recursos e configurou um prefab para o movimento das mãos e da cabeça, pode criar sua cena e implantá-la diretamente no headset para testes.

Próxima etapa: ampliar suas habilidades

Agora que você configurou seu ambiente de desenvolvimento do Android XR e entende os conceitos principais, confira as próximas etapas para continuar sua jornada de desenvolvimento em XR:

Recursos essenciais para continuar aprendendo:

Exemplos de projetos para explorar:

Escrito por:
Continue lendo