Ativar o ARCore

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar a desenvolver experiências de realidade aumentada para seu app, você precisa ativar a funcionalidade do ARCore no seu projeto do Unity. Para fazer isso, você precisa:

  1. Instale o Unity 2019.4.3f1 ou posterior.
  2. ter um projeto de trabalho usando a AR Foundation;
  3. Instalar o pacote de extensões do ARCore
  4. Configure o app para ser necessário para a RA ou (opcional)
  5. Executar verificações de tempo de execução
  6. Configurar o app para ser obrigatório ou obrigatório para profundidade
  7. Garanta que seu app esteja em conformidade com os requisitos de privacidade do usuário do ARCore

Configure o app para ser necessário para a RA ou (opcional)

Um app compatível com recursos de RA pode ser configurado de duas maneiras: AR Required ou AR Optional.

Um app AR Required não funciona sem o ARCore. Ele precisa de um dispositivo compatível com o ARCore que tenha o ARCore, também conhecido como Google Play Services for AR, instalado nele.

  • A Google Play Store disponibiliza AR Required apps apenas em dispositivos compatíveis com o ARCore.
  • Quando os usuários instalam um app AR Required, a Google Play Store instala o Google Play Services for AR automaticamente. No entanto, o app ainda precisará realizar outras verificações no momento da execução, caso Google Play Services for AR precise ser atualizado ou tenha sido desinstalado manualmente.

Um app AR Optional usa o ARCore para aumentar uma funcionalidade diferente. Ela tem recursos opcionais de RA, que são ativados apenas em dispositivos compatíveis com o ARCore com o Google Play Services for AR instalado.

  • AR Optional apps podem ser instalados e executados em dispositivos não compatíveis com o ARCore.
  • Quando os usuários instalam um app AR Optional, a Google Play Store não instala automaticamente Google Play Services for AR com o app.
AR RequiredAR Optional
Uso do recurso de RA Seu app precisa do ARCore para ter funcionalidades básicas. O ARCore aumenta a funcionalidade do seu app. Seu app pode ser executado sem compatibilidade com o ARCore.
Visibilidade na Play Store O app só está disponível na Play Store em dispositivos compatíveis com o ARCore. O app segue os procedimentos normais de listagem.
Método de instalação do Google Play Services for AR A Play Store instala o app Google Play Services for AR junto com seu app. Seu app usa o ARSession.state para fazer o download e instalar o ARCore.
Requisitos do Android minSdkVersion 24 (Android 7.0) 18 (Android 4.3)
É necessário usar ARSession.state para verificar o status de compatibilidade e instalação do ARCore

Para ver mais informações, consulte nossa visão geral de distribuição de apps.

Definir o app como AR Required

Android:

  1. Navegue para Edit > Project Settings > XR Plug-in Management > ARCore. Requirement é definido como Required por padrão.

  2. Clique em Edit > Project Settings > Player e selecione a guia com o ícone do Android.

  3. Em Other Settings > Identification, especifique um Minimum API Level igual ou superior a 24.

iOS:

  1. Navegue para Edit > Project Settings > XR Plug-in Management > ARKit. Requirement é definido como Required por padrão.

  2. Clique em Edit > Project Settings > Player e selecione a guia com o ícone do iOS.

  3. Em Other Settings > Configuration, especifique o Target minimum iOS Version do app.

Definir o app como AR Optional

Android:

  1. Navegue para Edit > Project Settings > XR Plug-in Management > ARCore.

  2. No menu suspenso Requirement, selecione Optional para definir seu app como opcional de RA.

  3. Clique em Edit > Project Settings > Player e selecione a guia com o ícone do Android.

  4. Em Other Settings > Identification, especifique um Minimum API Level igual ou superior a 19.

iOS:

  1. Navegue para Edit > Project Settings > XR Plug-in Management > ARKit.

  2. No menu suspenso Requirement, selecione Optional para definir seu app como opcional de RA.

  3. Clique em Edit > Project Settings > Player e selecione a guia com o ícone do iOS.

  4. Em Other Settings > Configuration, especifique o Target minimum iOS Version do app.

Executar verificações de tempo de execução

Durante o tempo de execução, os apps de RA exigem automaticamente verificações de tempo de execução para garantir que o dispositivo de destino:

  • Compatível com ARCore
  • instalou Google Play Services for AR. Se ele não tiver sido instalado (talvez tenha sido removido pelo usuário) ou a versão for muito antiga, seu app solicitará que o usuário o instale ou atualize.
  • tem dados atualizados de perfil do dispositivo ARCore. Se estiver desatualizado, seu app vai fazer o download de novos dados.

Defina ARSession.attemptUpdate como false para desativar essas verificações padrão. Seu app ainda precisa processar essas condições:

Condição Ação
O dispositivo não é compatível com o ARCore. Oculta a funcionalidade relacionada à RA.
O dispositivo é compatível com o ARCore, mas os dados de perfil do dispositivo Google Play Services for AR e/ou ARCore não estão instalados ou desatualizados. Solicita que o usuário instale ou atualize dados de perfil do dispositivo Google Play Services for AR e/ou ARCore chamando ARSession.Install().
O dispositivo é compatível com o ARCore e o Google Play Services for AR, e os dados do perfil do dispositivo são instalados e atualizados. Cria um ARCore Session e começa a usar o ARCore.

Você também pode acessar o ARSession.state para ver os estados de instalação e suporte.

Configurar o app como Depth Required ou Depth Optional (somente Android)

Se o app exigir compatibilidade com a API Depth, seja porque uma parte principal da experiência de RA depende da profundidade ou não há um substituto elegante para as partes que usam a profundidade, é possível restringir a distribuição do app na Google Play Store para dispositivos compatíveis com a API Depth.

Definir o app como Depth Required

Navegue para Edit > Project Settings > XR Plug-in Management > ARCore.

Depth é definido como Required por padrão.

Definir o app como Depth Optional

  1. Navegue para Edit > Project Settings > XR Plug-in Management > ARCore.

  2. No menu suspenso Depth, selecione Optional para definir um app como "Opcional".

Requisitos de privacidade

Verifique se o app está em conformidade com os requisitos de privacidade do usuário do ARCore.

Próximas etapas