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.

Configurar o app para uso de RA necessário 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 Google Play Services para apps de RA.

Um app RA necessário 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 de RA opcionais que são ativados apenas em dispositivos compatíveis com o ARCore que têm o Google Play Services para RA instalado.

  • Os apps opcionais de RA podem ser instalados e executados em dispositivos que não têm suporte ao ARCore.
  • Quando os usuários instalam um app opcional de RA, a Google Play Store não instala o Google Play Services para RA no dispositivo automaticamente.
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 O app só está listado na Play Store em dispositivos com suporte ao ARCore. O 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 o app. Seu app usa a corrotina ARSession.Install() (link em inglês) para fazer o download e instalar o ARCore.
Requisitos do Android minSdkVersion 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
Deve usar a corrotina ARSession.Install() (link em inglês) para instalar o Google Play Services para RA

Tornar o app obrigatório com 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 Android ícone.

  3. Em Other Settings > Identification, especifique Minimum API Level que é 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 iOS ícone.

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

Tornar o app opcional: RA

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 Android ícone.

  4. Em Other Settings > Identification, especifique Minimum API Level que é 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 iOS ícone.

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

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

Verificar se o Google Play Services para RA está instalado

Os apps de RA necessários e opcionais precisam usar os dois. a corrotina ARSession.Install() (link em inglês) antes de criar uma sessão do 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 de perfil do dispositivo do ARCore tenham sido transferidos por download.

Durante o tempo de execução, os apps com RA vão fazer automaticamente verificações para verifique se o dispositivo de destino:

  • Compatível com ARCore
  • O Google Play Services for AR foi instalado (se não estiver instalado) (possivelmente porque foi removida pelo usuário) ou a versão é muito antiga, o app solicitará que o usuário o instale ou atualize.
  • Ter dados de perfil de dispositivo do ARCore atualizados. Se estiverem desatualizados, seu app fará o download dos novos dados.

Defina ARSession.attemptUpdate como false para desativar essas verificações padrão. Seu app ainda deve lidar com 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 ARCore não estão instalados ou desatualizados. Solicita que o usuário instale ou atualize Google Play Services for AR e/ou Dados de perfil do dispositivo com o ARCore chamando ARSession.Install().
O dispositivo oferece suporte ao ARCore, Google Play Services for AR e Os dados do perfil do dispositivo com o ARCore estão instalados e atualizados. Cria um Session do ARCore e começa a usar o ARCore.

Você também pode conferir os estados de instalação e suporte em ARSession.state.

Obedeça aos requisitos de privacidade do usuário

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

O que vem em seguida?