เริ่มใช้งาน

เอกสารนี้อธิบายวิธีเริ่มต้นพัฒนาด้วย Awareness API ใน Android Awareness API เป็นส่วนหนึ่งของบริการ Google Play

คุณต้องมีบัญชี Google จึงจะใช้ Awareness API ได้ หากมีบัญชีอยู่แล้ว คุณก็พร้อมใช้งานได้ นอกจากนี้ คุณอาจต้องการ บัญชี Google แยกต่างหากเพื่อวัตถุประสงค์ในการทดสอบด้วย

ก่อนเริ่มต้น

รับคีย์ API

หากยังไม่ได้เปิดใช้ Awareness API และรับคีย์ API ของ Google ให้ทำตามขั้นตอนในการลงชื่อสมัครใช้และคีย์ API

กำหนดค่าแอป

  1. ในไฟล์ build.gradle ระดับโปรเจ็กต์ ให้รวมที่เก็บ Maven ของ Google ไว้ทั้งในส่วน buildscript และ allprojects

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

  2. เพิ่มทรัพยากร Dependency สำหรับ Awareness API ลงในไฟล์ Gradle ระดับแอปของโมดูล ซึ่งโดยปกติคือ app/build.gradle

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

  3. เพิ่มคีย์ API ของ Awareness ลงในไฟล์ AndroidManifest.xml ของแอป โดยให้เพิ่มแท็ก <meta-data> ที่มี android:name="com.google.android.awareness.API_KEY" สำหรับ android:value, ให้ใส่คีย์ API ของ Awareness ที่คุณสร้างเอง โดยใส่เครื่องหมายคำพูดคร่อมไว้

    <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 แบบไม่มีการเชื่อมต่อกับ 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