Menggunakan ARCore API di Google Cloud

Pilih platform: Android Unity (AR Foundation) iOS

Fitur ARCore seperti fitur Geospatial API dan Cloud Anchor menggunakan ARCore API yang dihosting di Google Cloud. Saat menggunakan fitur-fitur ini, aplikasi Anda menggunakan kredensial untuk mengakses layanan ARCore API.

Panduan memulai ini menjelaskan cara menyiapkan aplikasi agar dapat berkomunikasi dengan layanan ARCore API yang dihosting di Google Cloud.

Buat project Google Cloud baru atau gunakan project yang sudah ada

Jika Anda sudah memiliki project, pilih project tersebut.

Buka pemilih project

Jika Anda belum memiliki project Google Cloud, Anda bisa membuatnya.

Buat project baru

Mengaktifkan ARCore API

Untuk menggunakan ARCore API, Anda harus mengaktifkannya di project Anda.

Mengaktifkan ARCore API

Menyiapkan metode otorisasi

Aplikasi Android dapat berkomunikasi dengan ARCore API menggunakan dua jenis metode otorisasi: Otorisasi tanpa kunci (OAuth 2.0), yang merupakan metode yang direkomendasikan, dan otorisasi Kunci API:

• Otorisasi tanpa kunci menggunakan kombinasi nama paket aplikasi dan sidik jari kunci penandatanganan untuk memberi otorisasi pada aplikasi Anda.
• Kunci API adalah string yang mengidentifikasi project Google Cloud. Kunci API bersifat umumnya tidak dianggap aman karena umumnya dapat diakses oleh klien. Pertimbangkan untuk menggunakan otorisasi Keyless untuk berkomunikasi dengan ARCore API.

Tanpa kunciKunci API

Untuk memberi otorisasi aplikasi menggunakan Autentikasi tanpa kunci, buat klien OAuth 2.0 pelanggan.

Menentukan sidik jari kunci penandatanganan

Client ID OAuth 2.0 menggunakan sidik jari kunci penandatanganan aplikasi untuk mengidentifikasi .

Penting: Anda biasanya menandatangani aplikasi dengan kunci penandatanganan yang berbeda. Anda harus membuat Client ID untuk setiap kunci penandatanganan yang akan digunakan. Umumnya, ini adalah penandatanganan debug kunci dan kunci penandatanganan rilis.

Cara mendapatkan sidik jari penandatanganan debug

Saat menjalankan atau men-debug project Anda, fitur Android SDK akan otomatis menandatangani aplikasi Anda dengan sertifikat debug yang dihasilkan.

• Di Android Studio, buka Gradle toolpanel.
• Buka project-name > Tugas > Android.
• Jalankan tugas signingReport.

  

• Salin sidik jari SHA-1 untuk varian debug.

Cara mendapatkan sidik jari penandatanganan dari keystore

Jika Anda memiliki file keystore, gunakan utilitas keytool untuk menentukan sidik jari.

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

Kemudian, utilitas keytool mencetak sidik jari ke terminal. Contoh:

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

Cara mendapatkan kunci penandatanganan aplikasi dari Penandatanganan Aplikasi Play

Saat menggunakan Penandatanganan Aplikasi Play, Google mengelola kunci penandatanganan aplikasi dan menggunakannya untuk menandatangani APK Anda. Kunci ini harus digunakan untuk sidik jari penandatanganan.

1. Di halaman Penandatanganan Aplikasi di Konsol Google Play, scroll ke Sertifikat kunci penandatanganan aplikasi.
2. Gunakan sidik jari sertifikat SHA-1.

Membuat client ID OAuth 2.0

Untuk setiap kunci penandatanganan yang berlaku dari langkah sebelumnya, buat client ID OAuth 2.0 di Kredensial project Google Cloud.

• Di Google Cloud, buka halaman Credentials.

  Kredensial

• Klik Create credentials, lalu pilih OAuth client ID dari menu.

• Isi kolom wajib diisi sebagai berikut:

  • Jenis aplikasi: pilih Android.
  • Nama paket: gunakan nama paket seperti yang dinyatakan di AndroidManifest.xml.
  • Sidik jari sertifikat SHA-1: menggunakan sidik jari yang diperoleh di langkah sebelumnya.

• Tekan Buat.

Menyertakan library yang diperlukan

1. Sertakan com.google.android.gms:play-services-auth:16+ dalam dependensi aplikasi Anda.

2. Jika Anda menggunakan minifikasi kode, menambahkannya ke file build.gradle aplikasi Anda:

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

3. Tambahkan kode berikut ke file proguard-rules.pro aplikasi Anda:

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

Aplikasi Anda kini telah dikonfigurasi untuk menggunakan autentikasi Keyless.

1. Di Google Cloud, buka halaman Credentials.
   Kredensial
2. Klik Create credentials, lalu pilih API key dari menu.
   Dialog pembuatan kunci API menampilkan string untuk kunci yang baru dibuat.

3. Di Android Studio, tambahkan kunci API baru ke project Anda. Sertakan kunci API dalam sebuah <meta-data> di <application> di AndroidManifest.xml aplikasi Anda:

   <meta-data
     android:name="com.google.android.ar.API_KEY"
     android:value="API_KEY"/>
   

4. Tinjau dokumentasi tentang pembatasan kunci API untuk mengamankan kunci API.

Aplikasi Anda kini dikonfigurasi untuk menggunakan kunci API.

Langkah berikutnya

Dengan otorisasi terkonfigurasi, lihat fitur ARCore berikut yang menggunakan hal tersebut:

• Geospatial API
• Cloud Anchor API