Usar a API ARCore no Google Cloud

Selecione a plataforma:

Os recursos do ARCore, como a API Geospatial e o Cloud Anchors, usam a API ARCore hospedada no Google Cloud. Ao usar esses recursos, o aplicativo usa credenciais para acessar o serviço da API ARCore.

Neste guia de início rápido, descrevemos como configurar o aplicativo para que ele possa se comunicar com o serviço da API ARCore hospedado no Google Cloud.

Criar um novo projeto do Google Cloud ou usar um atual

Se você já tiver um projeto, selecione-o.

Acessar o seletor de projetos

Se você não tiver um projeto do Google Cloud, crie um.

Criar um projeto

Ativar a API ARCore

Para usar a API ARCore, ela precisa ser ativada no seu projeto.

Ativar a API ARCore

Configurar um método de autorização

Um aplicativo Android pode se comunicar com a API ARCore com dois métodos de autorização diferentes: autorização sem chave (OAuth 2.0), que é o método recomendado, e autorização por chave de API.

  • Esse recurso usa uma combinação do nome do pacote do aplicativo e da impressão digital da chave de assinatura para autorizar o aplicativo.
  • Uma chave de API é uma string que identifica um projeto do Google Cloud. Em geral, as chaves de API não são consideradas seguras, já que podem ser acessadas pelos clientes. Considere usar a autorização sem chave para se comunicar com a API ARCore.

Sem chave

Para autorizar o app usando a autenticação sem chave, crie IDs do cliente OAuth 2.0.

Determinar impressões digitais da chave de assinatura

Um ID do cliente OAuth 2.0 usa a impressão digital da chave de assinatura do app para identificar o app.

Como conseguir a impressão digital de assinatura de depuração

Ao executar ou depurar o projeto, as Ferramentas do SDK do Android assinam automaticamente o app com um certificado de depuração gerado.

  • No Android Studio, abra o painel de ferramentas do Gradle.
  • Navegue até project-name > Tarefas > Android.
  • Execute a tarefa signingReport.

  • Copie a impressão digital SHA-1 para a variante debug.

Como conseguir uma impressão digital de assinatura de um keystore

Se você tiver um arquivo de keystore, use o utilitário keytool para determinar a impressão digital.

keytool -list -v -alias your-key-name -keystore path-to-production-keystore

O utilitário keytool imprime a impressão digital no terminal. Exemplo:

   Certificate fingerprint: SHA1: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09

Como conseguir a chave de assinatura do app na Assinatura de apps do Google Play

Ao usar a Assinatura de apps do Google Play, o Google gerencia a chave de assinatura do seu app e a usa para assinar seus APKs. Essa chave precisa ser usada para a impressão digital de assinatura.

  1. Na página "Assinatura de apps" do Google Play Console, role até Certificado da chave de assinatura do app.
  2. Use a impressão digital do certificado SHA-1.

Criar IDs do cliente OAuth 2.0

Para cada chave de assinatura aplicável das etapas anteriores, crie um ID do cliente OAuth 2.0 nas credenciais do seu projeto do Google Cloud.

  • No Google Cloud, abra a página "Credenciais".

    Credenciais

  • Clique em Criar credenciais e selecione ID do cliente OAuth no menu.

  • Preencha os campos obrigatórios da seguinte forma:

    • Tipo de aplicativo: escolha Android.
    • Package name: use o nome do pacote declarado no AndroidManifest.xml.
    • Impressão digital do certificado SHA-1: use a impressão digital da etapa anterior.

  • Pressione Criar.

Incluir bibliotecas necessárias

  1. Inclua com.google.android.gms:play-services-auth:16+ nas dependências do app.

  2. Se você estiver usando a minificação de código, adicione-a ao arquivo build.gradle do app:

    buildTypes {
  release {
    ...
    proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
  }
}

  3. Adicione o código abaixo ao arquivo proguard-rules.pro do seu app:

    -keep class com.google.android.gms.common.** { *; }
-keep class com.google.android.gms.location.** { *; }
-keep class com.google.android.gms.auth.** { *; }
-keep class com.google.android.gms.tasks.** { *; }

Agora seu app está configurado para usar a autenticação sem chave.

Chave de API

  1. No Google Cloud, abra a página "Credenciais".
    Credenciais
  2. Clique em Criar credenciais e, em seguida, selecione a chave de API no menu.
    A caixa de diálogo "Chave de API" mostra a string da sua chave recém-criada.

  3. No Android Studio, adicione a nova chave de API ao projeto. Inclua a chave de API em um elemento <meta-data> no elemento <application> no AndroidManifest.xml do app:

    <meta-data
  android:name="com.google.android.ar.API_KEY"
  android:value="API_KEY"/>
  4. Consulte a documentação sobre restrições da chave de API para proteger sua chave.

Agora seu app está configurado para usar chaves de API.

A seguir

Com a autorização configurada, confira os seguintes recursos do ARCore que a usam: