เริ่มใช้งาน

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

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

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

รับคีย์ API

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