Introdução à AR Foundation

do Unity A AR Foundation (em inglês) é uma um framework multiplataforma que permite criar experiências de realidade aumentada uma vez, e criar para dispositivos Android ou iOS sem fazer mudanças. O framework está disponível pelo pacote AR Foundation do Unity.

O opcional do ARCore Extensões do ARCore para AR Foundation adiciona funcionalidades adicionais, permitindo que você use recursos como Âncoras do Cloud, filtros de configuração de câmera e gravação e reprodução app.

Migrar ou fazer upgrade de projetos existentes

  • Para migrar um projeto existente do SDK do ARCore para Unity (descontinuado) à AR Foundation do Unity e, opcionalmente, às Extensões ARCore, consulte a guia de migração (em inglês).
  • Para fazer upgrade de um projeto de uma versão anterior da AR Foundation, consulte a guias de upgrade e migração.

Requisitos

Dependendo da plataforma de destino, o pacote AR Foundation exige o seguintes:

Android

Hardware

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

Software

iOS

Hardware

Software

Instalar a AR Foundation

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

  1. Abra um projeto do Unity existente 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-in específicos da plataforma

O pacote AR Foundation apresenta uma interface para desenvolvedores do Unity usarem, mas Ele não implementa nenhum recurso de RA. Para usar a AR Foundation em um alvo você também precisa instalar pacotes separados e ativar o plug-in correspondente para cada plataforma.

Android

O plug-in ARCore XR permite que você crie apps de realidade aumentada para dispositivos Android. Siga estas etapas para instalá-lo no seu projeto do Unity se seu aplicativo é 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 ARCore.

iOS

O plug-in ARKit XR permite criar apps de realidade aumentada para dispositivos iOS. Siga estas etapas para instalá-lo no seu projeto do Unity se seu aplicativo segmenta 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 ARKit.

Configurar uma sessão de RA e adicionar componentes de base de RA à sua cena

Uma cena precisa de uma sessão de RA para ativar os processos de RA. como rastreamento de movimento, compreensão do ambiente e estimativa de iluminação. Você vai precisar dos seguintes objetos do jogo para oferecer suporte a uma sessão de RA:

Base de RA 4.x

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

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

Antes de adicionar os novos objetos de jogo, exclua o Main Camera padrão. Ela vai ser substituída por uma nova AR Camera no AR Session Origin.

Para adicionar os novos objetos de jogo de RA à sua cena, clique com o botão direito do mouse no Painel Hierarchy e selecione XR. Adicione um um novo AR Session e um novo AR Session Origin objeto do jogo.

Base de RA 5.x

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

  • XR Origin: transforma coordenadas de RA em Unity coordenadas mundiais.

Antes de adicionar os novos objetos de jogo, exclua o Main Camera padrão. Ela vai ser substituída por uma nova AR Camera no XR Origin.

Para adicionar os novos objetos de jogo de RA à sua cena, clique com o botão direito do mouse no Painel Hierarchy e selecione XR. Adicione um um novo AR Session e um novo XR Origin objeto do jogo.

Definir as configurações do player

Android

  1. Navegue até File > Build Settings para abrir Build Settings janela.
  2. Em Platform, escolha Android e clique em Switch Platform.
  3. Clique em Player Settings.

  4. Aplique as alterações a seguir:

    Player Settings > … Valor
    Other Settings > Rendering Desmarque Auto Graphics API.
    Se Vulkan estiver listado em Graphics APIs, remova-o, porque o Vulkan ainda não é compatível com o ARCore.
    Other Settings > Package Name Crie um ID do app exclusivo usando um formato de nome de pacote Java.
    Por exemplo, use com.example.helloAR.
    Other Settings > Minimum API Level Se você estiver criando um app AR necessário, especifique Android 7.0 'Nougat' (API Level 24) or higher.
    Se você estiver criando um app opcional de RA, especifique Android API Level 19 or higher.
    Other Settings > Scripting Backend Selecione IL2CPP em vez de Mono para permitir que o suporte para ARM64 seja ativado na próxima etapa.

    Durante o desenvolvimento:

    • Usar Mono + 32 bits (ARMv7)
    • Instalar um APK do ARCore FAT (32 bits + 64 bits)

    Ao enviar para a Play Store:

    • Usar IL2CPP
    • Ative as versões de 32 bits (ARMv7) e 64 bits (ARM64) para atender aos requisitos de 64 bits da Play Store
    • Opcional (compatível com a versão 2018.3 ou mais recente): em Build Settings, ative Android App Bundles
    Other Settings > Target Architectures Para atender ao requisito de 64 bits do Google Play, ativar ARM64 (ARM de 64 bits). Deixe ARMv7 (ARM de 32 bits) ativado para oferecer suporte a dispositivos de 32 bits.

iOS

  1. Navegue até File > Build Settings para abrir Build Settings janela.
  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 app em um formato DNS inverso.
    Por exemplo, use com.mycompany.myapp.
    Other Settings > Camera usage description Digite uma descrição para explicar seu uso da RA (por exemplo, ARKit).
    Other Settings > Target minimum iOS version 11.0 ou mais
    Other Settings > Architecture ARM64

A seguir