מתחילים

במסמך הזה נסביר איך מתחילים לפתח עם Awareness API ב-Android. Awareness API הוא חלק מ-Google Play Services.

כדי להשתמש ב-Awareness API, צריך חשבון Google. אם כבר יש לכם חשבון, הכול מוכן. מומלץ גם ליצור חשבון Google נפרד למטרות בדיקה.

לפני שמתחילים

קבלת מפתח API

אם עדיין לא הפעלתם את Awareness API וקיבלתם מפתח API של Google, תוכלו לפעול לפי השלבים המפורטים בקטע הרשמה ומפתחות API.

הגדרת האפליקציה

  1. בקובץ build.gradle ברמת הפרויקט, צריך לכלול את מאגר Maven של Google גם בקטע buildscript וגם בקטע allprojects:

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

  2. מוסיפים את יחסי התלות של Awareness API לקובץ Gradle ברמת האפליקציה של המודול, שבדרך כלל הוא app/build.gradle:

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

  3. מוסיפים את מפתח Awareness API לקובץ AndroidManifest.xml של האפליקציה. לשם כך, מוסיפים תג <meta-data> עם הערך android:name="com.google.android.awareness.API_KEY". בשדה android:value, מזינים את מפתח ה-API למודעות מוּדעוּת, מוקף במירכאות כפולות.

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

  4. מוסיפים את ההרשאות הנדרשות לקובץ AndroidManifest.xml של האפליקציה. ההרשאות הנדרשות משתנות בהתאם לשיטות ה-API ולסוגי המחיצות שבהן האפליקציה משתמשת.

קריאה לדוגמה

בקריאה לדוגמה הבאה ל-getDetectedActivity() מוסבר איך להשתמש במודל ללא חיבור של Google Play Services עם 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");
            }
        })

השלבים הבאים

מידע נוסף על ממשקי ה-API השונים ב-Awareness API: