Começar a usar as extensões do ARCore para a AR Foundation

O pacote opcional ARCore Extensions para AR Foundation adiciona funcionalidades ao pacote AR Foundation do Unity, permitindo que você use recursos como Cloud Anchors, filtros de configuração de câmera e gravação e reprodução no seu app.

Requisitos

Para desenvolver com o ARCore Extensions for AR Foundation, você vai precisar do seguinte:

Android

Hardware

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

Software

iOS

Hardware

Software

Instalar o pacote de extensões do ARCore

Siga estas etapas para instalar as extensões do ARCore para AR Foundation.

Dependências agrupadas

  1. Verifique se o AR Foundation está instalado e configurado no seu ambiente de desenvolvimento.
  2. Abra ou crie um novo projeto do Unity.
  3. Selecione a plataforma de build de destino:
    1. No menu File, selecione Build Settings.
    2. Selecione Android ou iOS, dependendo da plataforma desejada.
    3. Clique em Switch Platform.

  4. Importe o pacote mais recente de extensões do ARCore:

    1. Navegue para Window > Package Manager.

    2. Clique no botão e escolha a opção Add package from git URL... no menu suspenso.

    3. Cole o seguinte URL no campo de texto:

      https://github.com/google-ar/arcore-unity-extensions.git

    4. Clique em Add.

Sem EDM4U

Por padrão, as extensões do ARCore são empacotadas com outras dependências. Ao usar outras bibliotecas (por exemplo, o Firebase Analytics) que dependem de uma versão diferente do Gerenciador de dependências externas para Unity, pode ocorrer um comportamento indefinido, fazendo com que os dependentes parem de funcionar corretamente.

Instale extensões do ARCore sem dependências agrupadas para evitar conflitos de controle de versões da biblioteca:

  1. Faça o download das extensões do ARCore sem a versão EDM4U e com.google.external-dependency-manager,
  2. Siga as instruções sobre como importar pacotes UPM com arquivos .tgz, instalando pacotes na seguinte ordem:
    1. com.google.external-dependency-manager,
    2. ARCore Extensions (sem EDM4U).

Ao instalar ARCore Extensions, o Unity também instalará automaticamente uma versão adequada das dependências necessárias:

  • AR Foundation
  • ARCore XR Plugin (usado ao segmentar o Android)
  • ARKit XR Plugin (usado ao segmentar o iOS)

Essas dependências podem não estar visíveis na visualização Package Manager > Package: In project. No entanto, os pacotes podem ser encontrados na janela Project em Packages.

Configurar extensões do ARCore

AR Foundation 4.x

  1. No painel Hierarchy, clique com o botão direito do mouse e adicione os seguintes objetos do jogo, caso ainda não tenham sido adicionados:

    • XR > AR Session
    • XR > AR Session Origin
    • XR > ARCore Extensions

  2. No painel Hierarchy, selecione o pacote ARCore Extensions.

  3. No painel Inspector, para cada um dos campos abaixo, clique no botão de destino e conecte cada campo ao objeto de jogo correspondente, da seguinte maneira:

    • Session: use o AR Session do cenário.
    • AR Session Origin: use o AR Session Origin do cenário.
    • Camera Manager: use o AR Camera do cenário.

  4. Se quiser, crie e conecte os seguintes recursos para Cloud Anchors e filtros de configuração de câmera.

    1. No painel Project > Assets, clique com o botão direito do mouse e selecione Create > XR > ARCore Extensions Config.

    2. No painel Project > Assets, clique com o botão direito do mouse e selecione Create > XR > Camera Config Filter.

    3. No painel Hierarchy, selecione o pacote ARCore Extensions.

    4. No campo ARCore Extensions Config do painel Inspector, clique no botão de destino e conecte-se ao recurso ARCoreExtensionsConfig.

    5. No campo Camera Config Filter do painel Inspector, clique no botão de destino e conecte-se ao recurso ARCoreExtensionsCameraConfigFilter.

      Para saber mais, consulte o guia para desenvolvedores do Cloud Anchors e o guia sobre como configurar a câmera.

    6. Se você estiver usando uma versão do Unity anterior à 2020.3:

      • Selecione Custom Gradle Properties Template em Project Settings > Player > Android > Publishing Settings > Build.

Com todos os campos das extensões do ARCore acima conectados corretamente, o painel Inspector das extensões do ARCore vai ficar assim:

AR Foundation 5.x

  1. No painel Hierarchy, clique com o botão direito do mouse e adicione os seguintes objetos do jogo, caso ainda não tenham sido adicionados:

    • XR > AR Session
    • XR > XR Origin (Mobile AR)
    • XR > ARCore Extensions

  2. No painel Hierarchy, selecione o pacote ARCore Extensions.

  3. No painel Inspector, para cada um dos campos abaixo, clique no botão de destino e conecte cada campo ao objeto de jogo correspondente, da seguinte maneira:

    • Session: use o AR Session do cenário.
    • XR Origin: use o XR Origin do cenário.
    • Camera Manager: use o AR Camera do cenário.

  4. Se quiser, crie e conecte os seguintes recursos para Cloud Anchors e filtros de configuração de câmera.

    1. No painel Project > Assets, clique com o botão direito do mouse e selecione Create > XR > ARCore Extensions Config.

    2. No painel Project > Assets, clique com o botão direito do mouse e selecione Create > XR > Camera Config Filter.

    3. No painel Hierarchy, selecione o pacote ARCore Extensions.

    4. No campo ARCore Extensions Config do painel Inspector, clique no botão de destino e conecte-se ao recurso ARCoreExtensionsConfig.

    5. No campo Camera Config Filter do painel Inspector, clique no botão de destino e conecte-se ao recurso ARCoreExtensionsCameraConfigFilter.

      Para saber mais, consulte o guia para desenvolvedores do Cloud Anchors e o guia sobre como configurar a câmera.

    6. Se você estiver usando uma versão do Unity anterior à 2020.3:

      • Selecione Custom Gradle Properties Template em Project Settings > Player > Android > Publishing Settings > Build.

Com todos os campos das extensões do ARCore acima conectados corretamente, o painel Inspector das extensões do ARCore vai ficar assim:

Consulte o guia do Unity sobre editar propriedades para mais informações sobre como configurar propriedades.

Projetos de amostra

As extensões do ARCore para AR Foundation incluem exemplos de projetos que você pode usar para começar a criar seus próprios projetos.

  1. No menu Window, abra o Package Manager e selecione o pacote ARCore Extensions.

  2. Em Samples, clique em Import para o projeto de amostra, descrito abaixo.

Os seguintes projetos de exemplo são importados do repositório do GitHub:

  • Geoespacial (somente Android): crie experiências de RA em escala global e anexe conteúdo remotamente a qualquer área coberta pelo Google Street View. Consulte a introdução da API Geospatial para mais informações.

  • PersistentCloudAnchors (Android e iOS): crie experiências de RA persistentes no mundo real com camadas interativas de informações digitais ancoradas em locais reais e projete experiências que podem ser compartilhadas ao longo do tempo por várias pessoas em muitos dispositivos diferentes. Consulte a introdução ao Cloud Anchors para mais informações.

A seguir

Com as extensões do ARCore para AR Foundation, agora você pode usar Cloud Anchors e configurações de câmera nos seus apps.