Başla

Bu dokümanda, Android'de Awareness API ile geliştirmeye nasıl başlayacağınız açıklanmaktadır. Awareness API, Google Play Hizmetleri'nin bir parçasıdır.

Awareness API'yi kullanmak için Google Hesabınız olmalıdır. Zaten hesabınız varsa hazırsınız demektir. Test amacıyla ayrı bir Google Hesabı da isteyebilirsiniz.

Başlamadan önce

API anahtarı edinme

Awareness API'yi etkinleştirmediyseniz ve Google API anahtarı edindiyseniz bunu yapmak için Kayıt ve API anahtarları bölümündeki adımları uygulayın.

Uygulamanızı yapılandırma

  1. Proje düzeyindeki build.gradle dosyanıza Google'ın Maven deposunu hem buildscript hem de allprojects bölümlerine ekleyin:

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

  2. Awareness API için bağımlılıkları, modülünüzün uygulama düzeyindeki Gradle dosyasına (genellikle app/build.gradle) ekleyin:

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

  3. Awareness API anahtarınızı uygulamanızın AndroidManifest.xml dosyasına ekleyin. Bunun için android:name="com.google.android.awareness.API_KEY" ile bir <meta-data> etiketi ekleyin. android:value için tırnak işaretleri içinde, kendi Awareness API Anahtarınızı girin.

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

  4. Uygulamanızın AndroidManifest.xml dosyasına gerekli izinleri ekleyin. Gerekli izinler, uygulamanızın kullandığı API yöntemlerine ve çit türlerine bağlı olarak değişir.

Örnek arama

Aşağıdaki örnek çağrıda getDetectedActivity() bağlantısız Google Play Hizmetleri modelinin Awareness API ile nasıl kullanılacağı gösterilmektedir:

    // 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");
            }
        })

Sonraki adımlar

Awareness API'deki farklı API'ler hakkında daha fazla bilgi edinin: