Ative a RA para usar recursos de realidade aumentada no seu app novo ou atual.
Configurar o app como "RA necessária" 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 que oferece suporte a recursos de RA pode ser configurado de duas maneiras: RA necessária e RA opcional. Essa designação determina como o app de RA interage com o Google Play Services para RA.
Um app RA necessária não funciona sem o ARCore. Ele exige um dispositivo compatível com o ARCore que tenha o Google Play Services para RA instalado.
- A Google Play Store só disponibiliza apps "RA necessária" em dispositivos compatíveis com o ARCore.
- Quando os usuários instalam um app "RA necessária", a Google Play Store instala automaticamente o Google Play Services para RA no dispositivo. No entanto, o app ainda precisa realizar outras verificações de tempo de execução caso o Google Play Services para RA esteja desatualizado ou tenha sido desinstalado manualmente.
Um app RA opcional usa o ARCore para melhorar a funcionalidade atual. Ele tem recursos de RA opcionais que só são ativados em dispositivos compatíveis com o ARCore que tenham o Google Play Services para RA instalado.
- Os apps "RA opcional" podem ser instalados e executados em dispositivos que não oferecem suporte ao ARCore.
- Quando os usuários instalam um app "RA opcional", a Google Play Store não instala automaticamente o Google Play Services para RA no dispositivo.
| RA necessária | RA opcional | |
|---|---|---|
| Uso do recurso de RA | O app precisa do ARCore para a funcionalidade básica. | O ARCore aumenta a funcionalidade do app. O app pode ser executado sem suporte ao ARCore. |
| Visibilidade na Google Play Store | O app só aparece na Google Play Store em dispositivos compatíveis com o 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. | O app usa
a ARSession.Install() corrotina
para fazer o download e instalar o ARCore. |
Requisitos de minSdkVersion do Android |
Android 7.0 (nível 24 da API) | Android 4.4 (nível 19 da API), embora executar 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 do ARCore e o status da instalação
|
||
É necessário usar
a ARSession.Install() corrotina
para instalar o Google Play Services para RA |
Tornar o app "RA necessária"
Android
Navegue até Edit > Project Settings > XR Plug-in Management > ARCore. Requirement é definido como Required por padrão.
Clique em Edit > Project Settings > Player, selecione a guia com o ícone do Android.
Em Other Settings > Identification, especifique um Minimum API Level que seja
24ou mais recente.
iOS
Navegue até Edit > Project Settings > XR Plug-in Management > ARKit. Requirement é definido como Required por padrão.
Clique em Edit > Project Settings > Player, selecione a guia com o ícone do iOS.
Em Other Settings > Configuration, especifique o Target minimum iOS Version do app.
Tornar o app "RA opcional"
Android
Navegue até Edit > Project Settings > XR Plug-in Management > ARCore.
No menu suspenso Requirement, selecione Optional para definir o app como "RA opcional".
Clique em Edit > Project Settings > Player, selecione a guia com o ícone do Android.
Em Other Settings > Identification, especifique um Minimum API Level que seja
24ou mais recente.
iOS
Navegue até Edit > Project Settings > XR Plug-in Management > ARKit.
No menu suspenso Requirement, selecione Optional para definir o app como "RA opcional".
Clique em Edit > Project Settings > Player, selecione a guia com o ícone do iOS.
Em Other Settings > Configuration, especifique o Target minimum iOS Version do app.
Realizar verificações de tempo de execução
Verificar se o Google Play Services para RA está instalado
Os apps "RA necessária" e "RA opcional" precisam usar
a ARSession.Install() corrotina
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 de perfil do dispositivo ARCore necessários tenham sido baixados.
Durante o tempo de execução, os apps "RA necessária" realizam verificações automáticas para garantir que o dispositivo de destino:
- Ofereça suporte ao ARCore.
- Tenha o Google Play Services for AR instalado. Se ele não estiver instalado (possivelmente porque foi removido pelo usuário) ou a versão for muito antiga, seu app vai pedir ao usuário para instalar ou atualizar.
- Tenha dados de perfil do dispositivo ARCore atualizados. Se estiverem desatualizados, o app vai baixar novos dados.
Defina ARSession.attemptUpdate como false para desativar essas verificações padrão. O app ainda precisa processar essas condições:
| Condição | Ação |
|---|---|
| O dispositivo não oferece suporte ao ARCore. | Oculta a funcionalidade relacionada à RA. |
| O dispositivo oferece suporte ao ARCore, mas Google Play Services for AR e/ou dados de perfil do dispositivo ARCore não estão instalados ou estão desatualizados. | Pede ao usuário para instalar ou atualizar Google Play Services for AR e/ou dados de perfil do dispositivo ARCore chamando ARSession.Install(). |
| O dispositivo oferece suporte ao ARCore, e Google Play Services for AR e dados de perfil do dispositivo ARCore estão instalados e atualizados. | Cria uma Session do ARCore e começa a usar o ARCore. |
Você também pode verificar o ARSession.state para estados de instalação e suporte.
Cumprir os requisitos de privacidade do usuário
Para publicar seu app na Google 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.