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 atual.

Configurar o app para ser obrigatório ou opcional para RA

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: Obrigatório e Opcional. Essa designação determina como o app interage com o Google Play Services para RA.

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

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

Um app AR opcional usa o ARCore para melhorar a funcionalidade existente. Ele tem recursos opcionais de RA que são ativados apenas em dispositivos com suporte ao ARCore que instalaram o Google Play Services para RA.

Os apps opcionais de RA podem ser instalados e executados em dispositivos que não oferecem 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 obrigatório	RA (opcional)
Uso do recurso de RA	O app precisa do ARCore para ter funcionalidade básica.	O ARCore aumenta a funcionalidade do seu app. Seu app pode ser executado sem suporte ao ARCore.
Visibilidade na Play Store	O app só é listado na Play Store em dispositivos compatíveis com o ARCore.	Seu app segue os procedimentos normais de inclusão.
Método de instalação do Google Play Services para RA	A Play Store instala o Google Play Services para RA junto com o app.	Seu app usa a corrotina `ARSession.Install()` para fazer o download e instalar o ARCore.
Requisitos do `minSdkVersion` do Android	Android 7.0 (nível 24 da API)	O 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 suporte ao ARCore e o status da instalação
É necessário usar a cronoda de `ARSession.Install()` para instalar o Google Play Services para RA.

Exigir que o app use RA

Android

Navegue para Edit > Project Settings > XR Plug-in Management > ARCore. Requirement é definido como Required por padrão.
Clique em Edit > Project Settings > Player e selecione a guia com o ícone do Android.
Em Other Settings > Identification, especifique um Minimum API Level que seja 24 ou mais recente.

iOS

Navegue para Edit > Project Settings > XR Plug-in Management > ARKit. Requirement é definido como Required por padrão.
Clique em Edit > Project Settings > Player e selecione a guia com o ícone do iOS.
Em Other Settings > Configuration, especifique o Target minimum iOS Version do app.

Tornar a RA opcional no seu app

Android

Navegue para Edit > Project Settings > XR Plug-in Management > ARCore.
No menu suspenso Requirement, selecione Optional para definir o app como opcional para RA.
Clique em Edit > Project Settings > Player e selecione a guia com o ícone do Android.
Em Other Settings > Identification, especifique um Minimum API Level que seja 24 ou mais recente.

iOS

Navegue para Edit > Project Settings > XR Plug-in Management > ARKit.
No menu suspenso Requirement, selecione Optional para definir o app como "AR opcional".
Clique em Edit > Project Settings > Player e selecione a guia com o ícone do iOS.
Em Other Settings > Configuration, especifique o Target minimum iOS Version do app.

Realizar verificações no ambiente de execução

Verificar se o Google Play Services para RA está instalado

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

Durante a execução, os apps com a exigência de AR realizam verificações automaticamente para garantir que o dispositivo de destino:

Suporte ao ARCore
Instalou Google Play Services for AR: se isso não estiver instalado (possivelmente porque foi removido pelo usuário) ou a versão for muito antiga, seu app solicitará que o usuário a instale ou atualize.
Possui dados atualizados do perfil do dispositivo do ARCore. 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 precisa processar estas condições:

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

Você também pode verificar o ARSession.state para conferir 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 está em conformidade com os Requisitos de privacidade do usuário do ARCore.

O que vem em seguida?

Saiba como configurar uma sessão do ARCore.