Ativar o ARCore

Esta página descreve como ativar a funcionalidade do ARCore nos seus projetos do Unreal Engine. Para fazer isso, você precisa:

  1. Configurar o app para que seja compatível com RA ou opcional:
  2. Verifique se o app está em conformidade com os Requisitos de privacidade do usuário do ARCore

Google Play Services para RA

Há duas maneiras de ativar o ARCore no app: AR obrigatório e opcional do AR. Se precisar de ajuda para decidir qual deles escolher, consulte Publicar apps de RA na Google Play Store.

RA necessária

AR obrigatório significa que seu app não pode ser usado sem RA e o disponibiliza somente em dispositivos compatíveis com o ARCore.

Para tornar um app necessário para RA, marque a caixa App obrigatório no ARCore nas configurações do plug-in do GoogleARCore. Essa configuração está localizada no menu Edit > Project Settings > Plugins > GoogleARCore.

O app realizará automaticamente verificações de tempo de execução para garantir que o dispositivo seja compatível com o ARCore e que o Google Play Services para dados de perfil de dispositivo de RA e ARCore seja instalado e atualizado. Se o Google Play Services para AR não estiver instalado (talvez porque tenha sido removido pelo usuário), a versão for muito antiga ou os dados do perfil do dispositivo ARCore não estiverem atualizados, o app solicitará que o usuário o instale ou atualize. Se a instalação ou a atualização falhar (possivelmente devido a uma falha na rede), o nó Blueprint do Get ARCore Session Status retornará Error, e seu app precisará resolver o erro e sair.

RA opcional

Opcional: RA significa que seu app pode ser instalado e executado em dispositivos não compatíveis com o ARCore, mas inclui recursos de RA ativados quando executados em dispositivos compatíveis. Quando os usuários instalam um app opcional de RA, a Google Play Store não instala automaticamente o Google Play Services para RA.

Para tornar um app RA opcional, desmarque a caixa App obrigatório do ARCore nas configurações do plug-in do GoogleARCore.

No seu app, use o nó Blueprint do Check ARCore Availability para verificar se o dispositivo é compatível com o ARCore e, em caso afirmativo, se o Google Play Services para AR está instalado.

O app precisa processar estas 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 o Google Play Services não está instalado ou está desatualizado. Solicita que o usuário instale ou atualize usando o Blueprint Install ARCore Service.
O dispositivo é compatível com o ARCore e o Google Play Services para RA está instalado e atualizado. Inicia o serviço.

Requisitos de privacidade do usuário

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

Próximas etapas

Leia o código no app de exemplo e na referência da ARCore para Unreal API.