Ativar a RA no seu app AR Foundation (somente Android)

Ative a RA para usar recursos de realidade aumentada no seu app novo ou existente.

Configure seu app para RA ou RA opcional

Para economizar espaço em dispositivos individuais, todos os recursos de RA são armazenados em um app chamado Google Play Services para RA, que é atualizado separadamente pela Play Store. Os apps Android que usam recursos de RA se comunicam com o Google Play Services para RA usando o SDK do ARCore. Um app compatível com recursos de RA pode ser configurado de duas maneiras: RA necessária e RA opcional. Essa designação determina como o app interage com o app Google Play Services para RA.

Um app Obrigatório para RA não funciona sem o ARCore. É necessário um dispositivo compatível com o ARCore que tenha instalado o Google Play Services para RA.

  • A Google Play Store só disponibilizará apps necessários para RA em dispositivos compatíveis com o ARCore.
  • Quando os usuários instalam um app necessário para RA, a Google Play Store instala automaticamente o Google Play Services para RA no dispositivo. No entanto, o app ainda precisará realizar verificações adicionais no tempo de execução caso o Google Play Services para RA esteja desatualizado ou tenha sido desinstalado manualmente.

Um app opcional de RA usa o ARCore para melhorar a funcionalidade existente. Ela tem recursos opcionais de RA que são ativados somente em dispositivos com suporte ao ARCore e que tenham o Google Play Services para RA instalado.

  • Os apps opcionais de RA podem ser instalados e executados em dispositivos sem suporte ao ARCore.
  • Quando os usuários instalarem um app opcional de RA, a Google Play Store não instalará automaticamente o Google Play Services para RA no dispositivo.
RA necessáriaRA opcional
Uso de recursos de RA Seu app precisa do ARCore para funcionalidades básicas. O ARCore aumenta a funcionalidade do seu app. Seu app pode ser executado sem suporte ao ARCore.
Visibilidade na Play Store Seu app só está disponível na Play Store em dispositivos compatíveis com o ARCore. Seu app segue os procedimentos normais de listagem.
Método de instalação do Google Play Services para RA A Play Store instala o Google Play Services para RA junto com seu app. Seu app usa a corrotina ARSession.Install() para fazer o download e instalar o ARCore.
Requisitos do minSdkVersion do Android Android 7.0 (API de nível 24) Android 4.4 (nível 19 da API), embora a execução de qualquer funcionalidade de RA exija pelo menos o Android 7.0 (nível 24 da API)
É necessário usar ARSession.state para verificar o status da instalação e do suporte ao ARCore
É necessário usar a corrotina ARSession.Install() (link em inglês) para instalar o Google Play Services para RA.

Torne seu app obrigatório para RA

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 que seja 24 ou mais recente.

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.

Tornar a RA do seu app opcional

Android

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

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

  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 que seja 24 ou mais recente.

iOS

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

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

  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.

Realizar verificações no momento da execução

Conferir se o Google Play Services para RA está instalado

Tanto os apps AR required e AR opcionais precisam usar a corrotina ARSession.Install() antes de criar uma sessão ARCore para verificar se uma versão compatível do Google Play Services para RA está (ainda) instalada e garantir que todos os dados necessários do perfil do dispositivo ARCore foram transferidos por download.

Durante o tempo de execução, os apps de RA necessários realizam verificações automáticas para garantir que o dispositivo de destino:

  • Oferece suporte ao ARCore
  • Instalou o Google Play Services for AR: se ele não estiver instalado, possivelmente porque foi removido pelo usuário, ou se a versão for muito antiga, o app solicitará que o usuário a instale ou atualize.
  • Tem dados de perfil do dispositivo do ARCore atualizados. Se estiverem desatualizados, o app vai fazer o download de novos dados.

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

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

Também é possível verificar o ARSession.state para ver os estados de instalação e suporte.

Obedeça aos requisitos de privacidade do usuário

Para publicar seu app na Play Store, verifique se ele está em conformidade com os requisitos de privacidade do usuário do ARCore.

O que vem em seguida?