Primeiros passos com a AR Foundation

A AR Foundation, do Unity, é um framework multiplataforma que permite criar experiências de realidade aumentada uma vez e, em seguida, criar para dispositivos Android ou iOS sem fazer outras alterações. O framework está disponível pelo pacote AR Foundation do Unity.

O pacote opcional Extensões ARCore para RA Foundation (link em inglês) adiciona outras funcionalidades, permitindo que você use recursos como o Cloud Anchors, os filtros de configuração da câmera e a gravação e reprodução no seu app.

Migrar ou fazer upgrade de projetos existentes

  • Para migrar um projeto existente do SDK do ARCore (obsoleto) para o Unity para o AR Foundation do Unity e, opcionalmente, ARCore Extensions, consulte o guia de migração.
  • Para fazer upgrade de um projeto atual de uma versão anterior do AR Foundation, consulte os guias de upgrade e migração do Unity.

Requisitos

Dependendo da plataforma de destino, o pacote AR Foundation requer o seguinte:

Android

Hardware

  • Um emulador ou dispositivo Android compatível com o ARCore
  • Um cabo USB para conectar o dispositivo à máquina de desenvolvimento

Software

iOS

Hardware

Software

Instalar a RA Foundation

Siga estas etapas para instalar o pacote do Unity AR Foundation.

  1. Abra um projeto existente do Unity ou crie um novo projeto 3D.

  2. Navegue para Window > Package Manager.

  3. Ao lado de Packages, selecione Unity Registry.

  4. Na barra de pesquisa, digite "AR Foundation".

  5. Clique em Install.

Instalar e ativar pacotes de plug-ins específicos da plataforma

O pacote AR Foundation apresenta uma interface para que os desenvolvedores do Unity usem, mas não implementa nenhum recurso de RA por conta própria. Para usar o AR Foundation em um dispositivo de destino, você também precisará instalar pacotes separados e ativar o plug-in correspondente para cada respectiva plataforma.

Android

O pacote ARCore XR Plugin permite criar apps de realidade aumentada para dispositivos Android. Siga estas etapas para instalá-lo no seu projeto do Unity caso o app seja destinado a dispositivos Android. Use a mesma versão do pacote AR Foundation para evitar problemas de compatibilidade.

  1. No seu projeto, navegue até Window > Package Manager.

  2. Ao lado de Packages, selecione Unity Registry.

  3. Na barra de pesquisa, digite "ARCore XR plugin".

  4. Clique em Install.

  5. Navegue para Edit > Project Settings. No XR Plug-in Management, abra a guia Android e ative a ARCore.

iOS

O plug-in ARKit XR (link em inglês) permite criar apps de realidade aumentada para dispositivos iOS. Siga estas etapas para instalá-lo no seu projeto do Unity se o aplicativo for destinado a dispositivos iOS. Use a mesma versão do pacote AR Foundation para evitar problemas de compatibilidade.

  1. No seu projeto, navegue até Window > Package Manager.

  2. Ao lado de Packages, selecione Unity Registry.

  3. Na barra de pesquisa, digite "ARKit XR plugin".

  4. Clique em Install.

  5. Navegue para Edit > Project Settings. No XR Plug-in Management, abra a guia iOS e ative a ARKit.

Configurar uma sessão de RA e adicionar componentes da RA Foundation à cena

Uma cena precisa de uma sessão de RA para ativar processos de RA, como rastreamento de movimento, compreensão ambiental e estimativa de iluminação. Você precisará dos seguintes objetos de jogo para oferecer compatibilidade com uma sessão de RA:

  • AR Session: controla o ciclo de vida de uma experiência de RA.

  • AR Session Origin: transforma as coordenadas de RA em coordenadas mundiais do Unity.

Antes de adicionar os novos objetos de jogo, exclua o Main Camera padrão. Ele será substituído por um novo AR Camera no AR Session Origin.

Adicione os novos objetos de jogos em RA à sua cena: clique com o botão direito do mouse no painel Hierarchy e selecione XR. Adicione um novo AR Session e um novo objeto de jogo AR Session Origin.

Definir as configurações do player

Android

  1. Navegue até File > Build Settings para abrir a janela Build Settings.
  2. Em Platform, escolha Android e clique em Switch Platform.
  3. Clique em Player Settings.
  4. Aplique as seguintes mudanças:

    Player Settings > … Valor
    Other Settings > Rendering Desmarque Auto Graphics API.
    Se Vulkan estiver listado em Graphics APIs, remova-o porque a Vulkan ainda não é compatível com o ARCore.
    Other Settings > Package Name Crie um ID do app exclusivo usando um formato de nome do pacote Java.
    Por exemplo, use com.example.helloAR.
    Other Settings > Minimum API Level Se você estiver criando um app com RA obrigatória, especifique Android 7.0 'Nougat' (API Level 24) or higher.
    Se você estiver criando um app Opcional do RA, especifique Android API Level 14 or higher.
    Other Settings > Scripting Backend Selecione IL2CPP em vez de Mono para permitir que o suporte a ARM64 seja ativado na próxima etapa.
    Other Settings > Target Architectures Para atender aos requisitos de 64 bits do Google Play, ative ARM64 (ARM de 64 bits). Deixe o ARMv7 (ARM de 32 bits) ativado para oferecer compatibilidade com dispositivos de 32 bits.

iOS

  1. Navegue até File > Build Settings para abrir a janela Build Settings.
  2. Em Platform, escolha iOS e clique em Switch Platform.
  3. Clique em Player Settings.
  4. Defina as configurações a seguir:

    Player Settings > … Valor
    Other Settings > Bundle Identifier Adicione o nome do seu app em um formato DNS reverso.
    Por exemplo, use com.mycompany.myapp.
    Other Settings > Camera usage description Insira uma descrição para explicar o uso da RA (por exemplo, ARKit).
    Other Settings > Target minimum iOS version 11.0 ou mais
    Other Settings > Architecture ARM64

A seguir