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

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

Configure seu app para que ele seja compatível com RA ou 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 AR required 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ó vai disponibilizar os apps necessários para RA em dispositivos compatíveis com o ARCore.
  • Quando os usuários instalam um app de RA obrigatório, a Google Play Store instala automaticamente o Google Play Services para RA no dispositivo. No entanto, o app ainda vai precisar fazer mais verificações 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 apenas em dispositivos com suporte ao ARCore e que tenham instalado o Google Play Services para RA.

  • Os apps opcionais de RA podem ser instalados e executados em dispositivos sem suporte ao ARCore.
  • Quando os usuários instalam um app opcional de RA, a Google Play Store não instala automaticamente o Google Play Services para RA no dispositivo.
RA necessáriaRA opcional
Uso de recursos de RA Seu app precisa do ARCore para a funcionalidade básica. 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 ARCore. Seu app segue os procedimentos normais de informações do produto.
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. O app usa o ARSession.state para fazer o download e instalar o ARCore.
Requisitos do Android minSdkVersion Android 7.0 (API de nível 24) Android 4.4 (API de nível 19), embora a execução de qualquer funcionalidade de RA exija pelo menos o Android 7.0 (API de nível 24)
É necessário usar ARSession.state para verificar o status da instalação e do suporte do ARCore

Tornar seu app obrigatório

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 o app de RA 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 opcional para 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 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 ambiente de execução

Conferir se o Google Play Services para RA está instalado

Os apps de RA necessária e opcionais de RA precisam chamar ARSession.state antes de criar uma sessão do ARCore para conferir se uma versão compatível do Google Play Services para RA está (ainda) instalada e se todos os dados necessários do perfil do ARCore no dispositivo foram transferidos por download.

Durante a execução, os apps de RA precisam realizar automaticamente verificações nesse momento para garantir que o dispositivo de destino:

  • Compatível com 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 vai solicitar que o usuário a instale ou atualize.
  • Tem dados de perfil do dispositivo atualizados com o ARCore. Se estiverem desatualizados, 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 estas condições:

Condição Ação
O dispositivo não é compatível com o ARCore. Oculta funcionalidades relacionadas à RA.
O dispositivo é compatível com o ARCore, mas os dados de perfil Google Play Services for AR e/ou do ARCore não estão instalados ou estão desatualizados. Solicita que o usuário instale ou atualize dados de perfil de dispositivo Google Play Services for AR e/ou do ARCore chamando ARSession.Install().
O dispositivo é compatível com o ARCore e o Google Play Services for AR, e os dados de perfil do dispositivo 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.

Cumpra os requisitos de privacidade do usuário

Para publicar seu app na Play Store, verifique se ele obedece aos requisitos de privacidade do usuário do ARCore.

O que vem em seguida?