Mulai

Dokumen ini menjelaskan cara mulai mengembangkan dengan Awareness API di Android. Awareness API adalah bagian dari layanan Google Play.

Untuk menggunakan Awareness API, Anda memerlukan Akun Google. Jika sudah memiliki akun, artinya Anda sudah siap. Anda mungkin juga menginginkan Akun Google terpisah untuk tujuan pengujian.

Sebelum memulai

Mendapatkan kunci API

Jika Anda belum mengaktifkan Awareness API dan memperoleh kunci Google API, ikuti langkah-langkah di bagian Pendaftaran dan kunci API untuk melakukannya.

Mengonfigurasi aplikasi Anda

  1. Dalam file build.gradle level project, sertakan repositori Maven Google di bagian buildscript dan allprojects:

    buildscript {
        repositories {
            google()
        }
    }
    
    allprojects {
        repositories {
            google()
        }
    }
    
  2. Tambahkan dependensi untuk Awareness API ke file Gradle level aplikasi modul, biasanya app/build.gradle:

    dependencies {
      implementation 'com.google.android.gms:play-services-awareness:19.0.1'
    }
    
  3. Tambahkan Kunci Awareness API ke file AndroidManifest.xml aplikasi Anda. Untuk melakukannya, tambahkan tag <meta-data> dengan android:name="com.google.android.awareness.API_KEY". Untuk android:value, masukkan Kunci Awareness API Anda sendiri, yang diapit tanda kutip.

    <manifest>
        <application>
            <meta-data
                android:name="com.google.android.awareness.API_KEY"
                android:value="API_KEY"/>
        </application>
    </manifest>
    
  4. Tambahkan izin yang diperlukan ke file AndroidManifest.xml aplikasi Anda. Izin yang diperlukan bervariasi, bergantung pada metode API dan jenis fence yang digunakan oleh aplikasi Anda.

Contoh panggilan

Contoh panggilan ke getDetectedActivity() berikut menunjukkan cara menggunakan model layanan Google Play tanpa koneksi dengan Awareness API:

    // Each type of contextual information in the snapshot API has a corresponding "get" method.
    // For instance, this is how to get the user's current Activity.
    Awareness.getSnapshotClient(this).getDetectedActivity()
        .addOnSuccessListener(new OnSuccessListener<DetectedActivityResponse>() {
            @Override
            public void onSuccess(DetectedActivityResponse dar) {
                ActivityRecognitionResult arr = dar.getActivityRecognitionResult();
                // getMostProbableActivity() is good enough for basic Activity detection.
                // To work within a threshold of confidence,
                // use ActivityRecognitionResult.getProbableActivities() to get a list of
                // potential current activities, and check the confidence of each one.
                DetectedActivity probableActivity = arr.getMostProbableActivity();

                int confidence = probableActivity.getConfidence();
                String activityStr = probableActivity.toString();
                mLogFragment.getLogView().println("Activity: " + activityStr
                    + ", Confidence: " + confidence + "/100");
            }
        })

Langkah berikutnya

Pelajari berbagai API dalam Awareness API lebih lanjut: