Google Cloud'da ARCore API'yi kullanma

Platform seçin:

Geospatial API ve Cloud Anchor gibi ARCore özellikleri, Google Cloud'da barındırılan ARCore API'yi kullanır. Uygulamanız, bu özellikleri kullanırken ARCore API hizmetine erişmek için kimlik bilgilerini kullanır.

Bu hızlı başlangıç kılavuzunda, uygulamanızı Google Cloud'da barındırılan ARCore API hizmetiyle iletişim kuracak şekilde nasıl ayarlayacağınız açıklanmaktadır.

Yeni bir Google Cloud projesi oluşturun veya mevcut bir projeyi kullanın

Mevcut bir projeniz varsa seçin.

Proje seçiciye git

Google Cloud projeniz yoksa yeni bir proje oluşturun.

Yeni proje oluştur

ARCore API'yi etkinleştir

ARCore API'sini kullanmak için projenizde etkinleştirmeniz gerekir.

ARCore API'yi etkinleştirme

Yetkilendirme yöntemi ayarlama

Bir Android uygulaması, ARCore API'si ile iki farklı yetkilendirme yöntemi kullanarak iletişim kurabilir: önerilen yöntem olan Anahtarsız yetkilendirme (OAuth 2.0) ve API Anahtarı yetkilendirmesi:

  • Anahtarsız yetkilendirme, uygulamanızı yetkilendirmek için uygulamanın paket adı ve imzalama anahtarının parmak izinin bir kombinasyonunu kullanır.
  • API anahtarı, Google Cloud projelerini tanımlayan bir dizedir. API anahtarları, genellikle istemciler tarafından erişilebilir olduğundan genellikle güvenli kabul edilmez. ARCore API ile iletişim kurmak için anahtarsız yetkilendirmeyi kullanmayı düşünün.

Anahtarsız

Uygulamanızı Anahtarsız kimlik doğrulama kullanarak yetkilendirmek için OAuth 2.0 istemci kimlikleri oluşturun.

İmzalama anahtarı parmak izlerini belirleyin

OAuth 2.0 istemci kimliği, uygulamanızı tanımlamak için uygulamanızın imzalama anahtarı parmak izini kullanır.

Hata ayıklama imzalı parmak izinizi alma

Android SDK araçları, projenizi çalıştırırken veya hata ayıklarken uygulamanızı oluşturulan bir hata ayıklama sertifikasıyla otomatik olarak imzalar.

  • Android Studio'da Gradle araç panelini açın.
  • project-name > Görevler > Android'e gidin.
  • signingReport görevini çalıştırın.

  • Hata ayıklama varyantı için SHA-1 parmak izini kopyalayın.

Anahtar deposundan imza parmak izi nasıl alınır?

Anahtar deposu dosyanız varsa parmak izini belirlemek için keytool yardımcı programını kullanın.

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

Daha sonra keytool yardımcı programı, parmak izini terminale yazdırır. Örneğin:

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

Play Uygulama İmzalama'dan uygulamanızın imzalama anahtarını alma

Play Uygulama İmzalama kullanılırken Google, uygulamanızın imzalama anahtarını yönetir ve APK'larınızı imzalamak için kullanır. Bu anahtar, imzalama parmak izi için kullanılmalıdır.

  1. Google Play Console'daki Uygulama İmzalama sayfasında Uygulama imzalama anahtarı sertifikası'na gidin.
  2. SHA-1 sertifika parmak izini kullanın.

OAuth 2.0 istemci kimlikleri oluşturma

Önceki adımlarda geçerli olan her imzalama anahtarı için Google Cloud projenizin kimlik bilgilerinde bir OAuth 2.0 istemci kimliği oluşturun.

  • Google Cloud'da Kimlik bilgileri sayfasını açın.

    Kimlik bilgileri

  • Kimlik bilgileri oluştur'u tıklayın, ardından menüden OAuth istemci kimliği'ni seçin.

  • Zorunlu alanları aşağıdaki gibi doldurun:

    • Uygulama türü: Android'i seçin.
    • Paket adı: AndroidManifest.xml dosyanızda belirtilen paket adını kullanın.
    • SHA-1 sertifika parmak izi: Önceki adımlarda edindiğiniz bir parmak izi kullanın.

  • Oluştur'a basın.

Gerekli kitaplıkları dahil et

  1. Uygulamanızın bağımlılıklarına com.google.android.gms:play-services-auth:16+ ekleyin.

  2. Kod küçültme kullanıyorsanız bunu uygulamanızın build.gradle dosyasına ekleyin:

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

  3. Uygulamanızın proguard-rules.pro dosyasına aşağıdakileri ekleyin:

    -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.** { *; }

Uygulamanız artık Anahtarsız kimlik doğrulama kullanacak şekilde yapılandırılmış.

API Anahtarı

  1. Google Cloud'da Kimlik bilgileri sayfasını açın.
    Kimlik bilgileri
  2. Kimlik bilgileri oluştur'u tıklayın, ardından menüden API anahtarı'nı seçin.
    API anahtarı oluşturuldu iletişim kutusu, yeni oluşturduğunuz anahtarın dizesini görüntüler.

  3. Android Studio'da projenize yeni API anahtarını ekleyin. API anahtarını, uygulamanızın AndroidManifest.xml öğesindeki <application> öğesine bir <meta-data> öğesine ekleyin:

    <meta-data
  android:name="com.google.android.ar.API_KEY"
  android:value="API_KEY"/>
  4. API anahtarınızı güvence altına almak için API anahtarı kısıtlamaları ile ilgili belgeleri inceleyin.

Uygulamanız artık API anahtarları kullanacak şekilde yapılandırılmış.

Sırada ne var?

Yetkilendirme yapılandırılmışsa onu kullanan aşağıdaki ARCore özelliklerine göz atın: