O Google está empenhado em promover a igualdade racial para as comunidades negras. Veja como.

Habilitar ARCore para Android

Esta página descreve como habilitar a funcionalidade ARCore em seus projetos Unity que visam dispositivos Android. Para fazer isso, você precisa:

  1. Importe o ARCore SDK para Unity
  2. Configure seu aplicativo para ser AR necessário ou AR opcional
  3. Certifique-se de seus cumpre app com de Arcore requisitos de privacidade do usuário

Serviços do Google Play para AR

Arcore SDKs fazer AR apresenta acessível em Arcore dispositivos suportados que têm serviços Google Play para AR (Arcore) instalado.

O Google Play Services para AR é instalado automaticamente e mantido atualizado na grande maioria dos dispositivos compatíveis.

Antes de iniciar uma sessão de AR, os aplicativos devem:

  1. Verifique se Arcore é suportado, chamando CheckApkAvailability .
  2. Verifique se o Google Play Services para AR está instalado e atualizado, e que Arcore dados perfil de dispositivo necessário tenha sido baixado, chamando Session.RequestApkInstallation(bool userRequested) .

Importe o ARCore SDK para Unity

  1. Abrir Unidade e criar um novo projeto 3D.

  2. Instale pacotes específicos da versão.

    Unity 2020

    Selecione Window> Gerenciador de Pacotes e instalar os seguintes pacotes:

    • Vários jogadores HLAPI (requerido pela amostra Nuvem Âncoras)
    • XR Plugin Gestão (obrigatório por Instant Preview, que utiliza a TrackedPoseDriver )

    Unity 2019

    Selecione Window> Gerenciador de Pacotes e instalar os seguintes pacotes:

    • Vários jogadores HLAPI (requerido pela amostra Nuvem Âncoras)
    • XR legados Ajudantes de entrada (obrigatório por Instant Preview, que utiliza a TrackedPoseDriver )

    Unity 2018

    Nenhum pacote adicional é necessário. Prossiga para o próximo passo.

    Unity 2017

    Nenhum pacote adicional é necessário. Prossiga para o próximo passo.

  3. Importe o ARCore SDK para Unity:

    1. Selecione Assets> Importação pacote> pacote personalizado.

    2. Selecione a arcore-unity-sdk-1.25.0.unitypackage que você baixou.

    3. Na caixa de diálogo Package Importação, certifique-se de que todas as opções de pacotes são selecionados e clique em Importar.

Na janela Projeto de Unidade, você deve ver ambos os arquivos do SDK e do aplicativo de exemplo HelloAR em Assets/GoogleARCore/Examples/HelloAR/ .

Configure seu aplicativo para ser AR necessário ou AR opcional

Uma aplicação que suporte Ar possui pode ser configurado de duas maneiras: AR Obrigatório e AR opcional. Se você precisar de ajuda para decidir qual escolher, consulte Publicar AR Apps na Play Store Google .

AR necessário

Para ser útil, um aplicativo AR Obrigatório requer um dispositivo suportado Arcore que tem o Google Play Services para AR instalado nele.

  • O Google Play Store faz AR Obrigatório aplicativos disponível apenas em dispositivos que Arcore apoio .

  • Quando os usuários instalar um aplicativo AR Obrigatório, a Google Play Store instala automaticamente o Google Play Services para AR . No entanto, a sua aplicação ainda deve executar adicionais tempo de execução verifica no caso do Google Play Services para AR deve ser atualizado ou foi desinstalado manualmente ou dados Arcore perfil de dispositivo não está atualizado.

Para mais informações, consulte Publishing AR Apps na Play Store Google .

Para tornar um aplicativo AR Obrigatório, siga estas etapas.

Unity 2020

  1. Abrir Editar> Configurações do projeto. Selecione Google Arcore e verificar se Arcore Required está marcada.

  2. Defina a mínima adequada API Nível clicando em Editar> Configurações do projeto> Player, e selecionar a aba com o ícone do Android. Em Outras Configurações> Identificação selecionar uma API Nível mínimo que é 24 ou superior.

Unity 2019

  1. Abrir Editar> Configurações do projeto. Selecione Google Arcore e verificar se Arcore Required está marcada.

  2. Defina a mínima adequada API Nível clicando em Editar> Configurações do projeto> Player, e selecionar a aba com o ícone do Android. Em Outras Configurações> Identificação selecionar uma API Nível mínimo que é 24 ou superior.

Unity 2018

  1. Abrir Editar> Configurações do projeto. Selecione Google Arcore e verificar se Arcore Required está marcada.

  2. Defina a mínima adequada API Nível clicando em Editar> Configurações do projeto> Player, e selecionar a aba com o ícone do Android. Em Outras Configurações> Identificação selecionar uma API Nível mínimo que é 24 ou superior.

Unity 2017

  1. Abrir Editar> Configurações do projeto> Google Arcore, em seguida, verificar se Arcore Required está marcada.

  2. Defina a mínima adequada API Nível clicando em Editar> Configurações do projeto> Player, e selecionar a aba com o ícone do Android. Em Outras Configurações> Identificação selecionar uma API Nível mínimo que é 24 ou superior.

Seu aplicativo executará verificações de tempo de execução automaticamente para garantir que o dispositivo seja compatível com ARCore e tenha o Google Play Services para AR instalado e que os dados de perfil do dispositivo ARCore estejam atualizados. Se o Google Play Services for AR não estiver instalado (possivelmente porque foi removido pelo usuário) ou a versão for muito antiga, seu aplicativo solicitará que o usuário o instale ou atualize. Se os dados de perfil do dispositivo ARCore não estiverem atualizados, seu aplicativo fará o download e atualizará. Se instalar ou atualização falhar (possivelmente devido a uma falha de rede), Session.Status retornará um erro, e seu aplicativo deve lidar com o erro e sair.

AR opcional

Um AR Opcional aplicativo tem características AR opcionais, que são ativados apenas em dispositivos que tem o Google Play Services para AR instalado.

  • Aplicativos opcionais de AR podem ser instalados e executados em dispositivos que não suportam ARCore.

  • Quando os usuários instalar um aplicativo AR Opcional, o Google Play Store não irá instalar automaticamente o Google Play Services para AR com o aplicativo.

Para tornar um aplicativo AR opcional, siga estas etapas.

Unity 2020

  1. Abrir Editar> Configurações do projeto. Selecione Google Arcore e desmarque Arcore Obrigatório.

  2. Defina a mínima adequada API Nível clicando em Editar> Configurações do projeto> Player, e selecionar a aba com o ícone do Android. Em Outras Configurações> Identificação selecionar uma API Nível mínimo que é 18 ou superior.

Unity 2019

  1. Abrir Editar> Configurações do projeto. Selecione Google Arcore e desmarque Arcore Obrigatório.

  2. Defina a mínima adequada API Nível clicando em Editar> Configurações do projeto> Player, e selecionar a aba com o ícone do Android. Em Outras Configurações> Identificação selecionar uma API Nível mínimo que é 18 ou superior.

Unity 2018

  1. Abrir Editar> Configurações do projeto. Selecione Google Arcore e desmarque Arcore Obrigatório.

  2. Defina a mínima adequada API Nível clicando em Editar> Configurações do projeto> Player, e selecionar a aba com o ícone do Android. Em Outras Configurações> Identificação selecionar uma API Nível mínimo que é 18 ou superior.

Unity 2017

  1. Abrir Editar> Configurações do projeto> Google Arcore e desmarque Arcore Obrigatório.

  2. Defina a mínima adequada API Nível clicando em Editar> Configurações do projeto> Player, e selecionar a aba com o ícone do Android. Em Outras Configurações> Identificação selecionar uma API Nível mínimo que é 18 ou superior.

Execute verificações de tempo de execução

Quando lançado, o aplicativo deve chamar Session.CheckApkAvailability() para verificar se o dispositivo suporta Arcore e, caso afirmativo, se o Google Play Services para dados do perfil de dispositivo AR e Arcore estão instalados e atualizados.

Seu aplicativo deve lidar com estas condições:

Doença Açao
O dispositivo não é compatível com ARCore. Oculta funcionalidades relacionadas a AR.
O dispositivo é compatível com ARCore, mas os dados de perfil do dispositivo Google Play Services para AR e / ou ARCore não estão instalados ou desatualizados. Solicita que o usuário para instalar ou atualizar o Google Play Services para AR e / ou dados de perfil de dispositivo de Arcore chamando Session.RequestApkInstallation() .
O dispositivo é compatível com ARCore e Google Play Services para AR e os dados de perfil do dispositivo ARCore estão instalados e atualizados. Cria um Arcore Session e começa a usar Arcore.

Requisitos de privacidade do usuário

Certifique-se de seus cumpre app com de Arcore requisitos de privacidade do usuário .

Próximos passos

Leia o código no aplicativo de exemplo e Arcore para referência API Unity .