Başlama

Bu belgede, 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.

Farkındalık API'sini kullanmak için Google Hesabınızın olması gerekir. Hesabınız varsa başka bir şey yapmanız gerekmez. Test amacıyla ayrı bir Google Hesabı da kullanmak isteyebilirsiniz.

Başlamadan önce

API anahtarı edinme

Farkındalık API'sini henüz etkinleştirmediyseniz ve Google API anahtarı edinmediyseniz bunu yapmak için Kaydolma ve API anahtarları bölümündeki adımları uygulayın.

Uygulamanızı yapılandırma

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

    buildscript {
        repositories {
            google()
        }
    }
    
    allprojects {
        repositories {
            google()
        }
    }
    
  2. Awareness API'ye ait 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.1.0'
    }
    
  3. Farkındalık API'si anahtarınızı uygulamanızın AndroidManifest.xml dosyasına ekleyin. Bunu yapmak için <meta-data> etiketiyle android:name="com.google.android.awareness.API_KEY" ekleyin. android:value için tırnak işaretleri arasında kendi Awareness API anahtarınızı ekleyin.

    <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 görüşme

Aşağıdaki getDetectedActivity() çağrısı örneği, bağlantısız Google Play Hizmetleri modelinin Awareness API ile nasıl kullanılacağını gösterir:

    // 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

Farkındalık API'sindeki farklı API'ler hakkında daha fazla bilgi edinin: