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, Anda sudah siap. Sebaiknya buat Akun Google terpisah untuk tujuan pengujian.

Sebelum memulai

Mendapatkan kunci API

Jika Anda belum mengaktifkan Awareness API dan mendapatkan kunci API Google, ikuti langkah-langkah di 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 Anda, yang biasanya adalah app/build.gradle:

    dependencies {
  implementation 'com.google.android.gms:play-services-awareness:19.1.0'
}

  3. Tambahkan Kunci Awareness API Anda 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 API Awareness Anda sendiri, dalam tanda petik.

    <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 pagar yang digunakan aplikasi Anda.

Contoh panggilan

Contoh panggilan berikut ke getDetectedActivity() 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 lebih lanjut berbagai API dalam Awareness API: