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
Dalam file
build.gradle
level project, sertakan repositori Maven Google di bagianbuildscript
danallprojects
:buildscript { repositories { google() } } allprojects { repositories { google() } }
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' }
Tambahkan Kunci Awareness API ke file
AndroidManifest.xml
aplikasi Anda. Untuk melakukannya, tambahkan tag<meta-data>
denganandroid:name="com.google.android.awareness.API_KEY"
. Untukandroid: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>
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: