คุณอาจต้องออกแบบแอปให้ระบุได้ว่าผู้ใช้เริ่มหรือหยุดกิจกรรมหนึ่งๆ เช่น เดิน ปั่นจักรยาน หรือขับรถ เมื่อใด ตัวอย่างเช่น แอปติดตามระยะทางอาจเริ่มติดตามระยะทางเมื่อผู้ใช้เริ่มขับรถ หรือแอปรับส่งข้อความอาจปิดเสียงการสนทนาทั้งหมดจนกว่าผู้ใช้จะหยุดขับรถ
คุณสามารถใช้ Activity Recognition Transition API เพื่อตรวจจับการเปลี่ยนแปลงในการจดจำกิจกรรมของผู้ใช้ได้ แอปของคุณจะสมัครรับข้อมูลการเปลี่ยนกิจกรรมที่สนใจ และ API จะแจ้งเตือนแอปเมื่อจำเป็นเท่านั้น หน้านี้แสดงวิธีใช้ Activity Recognition Transition API หรือเรียกสั้นๆ ว่า Transition API
ตั้งค่าโปรเจ็กต์
หากต้องการใช้ Transition API ในแอป คุณต้องประกาศทรัพยากร Dependency เป็น API การจดจำตำแหน่งและกิจกรรมของ Google เวอร์ชัน 12.0.0 ขึ้นไป และระบุสิทธิ์ com.google.android.gms.permission.ACTIVITY_RECOGNITION ในไฟล์ Manifest ของแอป
- หากต้องการประกาศทรัพยากร Dependency ไปยัง API ให้เพิ่มการอ้างอิงไปยังที่เก็บ Maven ของ Google และเพิ่มรายการการติดตั้งใช้งานไปยัง
com.google.android.gms:play-services-location:12.0.0ในส่วนทรัพยากร Dependency ของไฟล์build.gradleของแอป ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าบริการ Google Play หากต้องการระบุสิทธิ์
com.google.android.gms.permission.ACTIVITY_RECOGNITIONให้เพิ่มองค์ประกอบ<uses-permission>ในไฟล์ Manifest ของแอป ดังที่แสดงในตัวอย่างต่อไปนี้<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.myapp"> <uses-permission android:name="com.google.android.gms.permission.ACTIVITY_RECOGNITION" /> … </manifest>
ลงทะเบียนเพื่อรับข้อมูลอัปเดตการเปลี่ยนกิจกรรม
หากต้องการเริ่มรับการแจ้งเตือนเกี่ยวกับการเปลี่ยนกิจกรรม คุณต้องดำเนินการดังต่อไปนี้
- ออบเจ็กต์
ActivityTransitionRequestที่ระบุประเภทกิจกรรมและการเปลี่ยนสถานะ - Callback
PendingIntentที่แอปของคุณได้รับการแจ้งเตือน ดูข้อมูลเพิ่มเติมได้ที่การใช้ Intent รอดำเนินการ
หากต้องการสร้างออบเจ็กต์ ActivityTransitionRequest คุณต้องสร้างรายการออบเจ็กต์ ActivityTransition ซึ่งแสดงถึงการเปลี่ยนผ่านที่คุณต้องการรับการแจ้งเตือน ออบเจ็กต์ ActivityTransition มีข้อมูลต่อไปนี้
- ประเภทกิจกรรมที่แสดงโดยคลาส
DetectedActivityTransition API รองรับกิจกรรมต่อไปนี้ - ประเภทการเปลี่ยนหน้าเว็บเป็น
ACTIVITY_TRANSITION_ENTERหรือACTIVITY_TRANSITION_EXITดูข้อมูลเพิ่มเติมได้ที่คลาสActivityTransition
โค้ดต่อไปนี้แสดงวิธีสร้างรายการออบเจ็กต์ ActivityTransition
Kotlin
val transitions = mutableListOf<ActivityTransition>()
transitions +=
ActivityTransition.Builder()
.setActivityType(DetectedActivity.IN_VEHICLE)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_ENTER)
.build()
transitions +=
ActivityTransition.Builder()
.setActivityType(DetectedActivity.IN_VEHICLE)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_EXIT)
.build()
transitions +=
ActivityTransition.Builder()
.setActivityType(DetectedActivity.WALKING)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_EXIT)
.build()
Java
List<ActivityTransition> transitions = new ArrayList<>();
transitions.add(
new ActivityTransition.Builder()
.setActivityType(DetectedActivity.IN_VEHICLE)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_ENTER)
.build());
transitions.add(
new ActivityTransition.Builder()
.setActivityType(DetectedActivity.IN_VEHICLE)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_EXIT)
.build());
transitions.add(
new ActivityTransition.Builder()
.setActivityType(DetectedActivity.WALKING)
.setActivityTransition(ActivityTransition.ACTIVITY_TRANSITION_EXIT)
.build());
คุณสร้างออบเจ็กต์ ActivityTransitionRequest ได้โดยส่งรายการ ActivityTransitions ไปยังคลาส ActivityTransitionRequest ดังที่แสดงในตัวอย่างต่อไปนี้
Kotlin
val request = ActivityTransitionRequest(transitions)
Java
ActivityTransitionRequest request = new ActivityTransitionRequest(transitions);
คุณสามารถลงทะเบียนเพื่อรับข้อมูลอัปเดตการเปลี่ยนกิจกรรมได้โดยส่งอินสแตนซ์ของ ActivityTransitionRequest และออบเจ็กต์ PendingIntent ไปยังเมธอด requestActivityTransitionUpdates() เมธอด requestActivityTransitionUpdates() จะแสดงผลออบเจ็กต์ Task ที่คุณสามารถตรวจสอบความสำเร็จหรือความล้มเหลวได้ ดังที่แสดงในตัวอย่างโค้ดต่อไปนี้
Kotlin
// myPendingIntent is the instance of PendingIntent where the app receives callbacks.
val task = ActivityRecognition.getClient(context)
.requestActivityTransitionUpdates(request, myPendingIntent)
task.addOnSuccessListener {
// Handle success
}
task.addOnFailureListener { e: Exception ->
// Handle error
}
Java
// myPendingIntent is the instance of PendingIntent where the app receives callbacks.
Task<Void> task = ActivityRecognition.getClient(context)
.requestActivityTransitionUpdates(request, myPendingIntent);
task.addOnSuccessListener(
new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void result) {
// Handle success
}
}
);
task.addOnFailureListener(
new OnFailureListener() {
@Override
public void onFailure(Exception e) {
// Handle error
}
}
);
หลังจากลงทะเบียนเพื่อรับข้อมูลอัปเดตการเปลี่ยนกิจกรรมเรียบร้อยแล้ว แอปของคุณจะได้รับการแจ้งเตือนใน PendingIntent ที่ลงทะเบียนไว้
ประมวลผลเหตุการณ์การเปลี่ยนกิจกรรม
เมื่อเกิดการเปลี่ยนกิจกรรมที่ขอ แอปของคุณจะได้รับ Callback Intent คุณสามารถดึงออบเจ็กต์ ActivityTransitionResult จาก Intent ซึ่งรวมถึงรายการออบเจ็กต์ ActivityTransitionEvent ระบบจะจัดเรียงเหตุการณ์ตามลำดับเวลา เช่น หากแอปขอประเภทกิจกรรม IN_VEHICLE ในการเปลี่ยน ACTIVITY_TRANSITION_ENTER และ ACTIVITY_TRANSITION_EXIT แอปจะได้รับออบเจ็กต์ ActivityTransitionEvent เมื่อผู้ใช้เริ่มขับรถ และอีกออบเจ็กต์หนึ่งเมื่อผู้ใช้เปลี่ยนไปทำกิจกรรมอื่น
คุณใช้ Callback ได้โดยสร้างคลาสย่อยของ BroadcastReceiver และใช้เมธอด onReceive เพื่อรับรายการเหตุการณ์การเปลี่ยนกิจกรรม ดูข้อมูลเพิ่มเติมได้ที่การประกาศ ตัวอย่างต่อไปนี้แสดงวิธีใช้เมธอด onReceive
Kotlin
override fun onReceive(context: Context, intent: Intent) {
if (ActivityTransitionResult.hasResult(intent)) {
val result = ActivityTransitionResult.extractResult(intent)!!
for (event in result.transitionEvents) {
// chronological sequence of events....
}
}
}
Java
@Override
public void onReceive(Context context, Intent intent) {
if (ActivityTransitionResult.hasResult(intent)) {
ActivityTransitionResult result = ActivityTransitionResult.extractResult(intent);
for (ActivityTransitionEvent event : result.getTransitionEvents()) {
// chronological sequence of events....
}
}
}
ยกเลิกการลงทะเบียนเพื่อรับข้อมูลอัปเดตการเปลี่ยนกิจกรรม
คุณยกเลิกการลงทะเบียนรับข้อมูลอัปเดตการเปลี่ยนกิจกรรมได้โดยเรียกใช้เมธอด removeActivityTransitionUpdates() ของ ActivityRecognitionClient และส่งออบเจ็กต์ PendingIntent เป็นพารามิเตอร์ ดังที่แสดงในตัวอย่างต่อไปนี้
Kotlin
// myPendingIntent is the instance of PendingIntent where the app receives callbacks.
val task = ActivityRecognition.getClient(context)
.removeActivityTransitionUpdates(myPendingIntent)
task.addOnSuccessListener {
myPendingIntent.cancel()
}
task.addOnFailureListener { e: Exception ->
Log.e("MYCOMPONENT", e.message)
}
Java
// myPendingIntent is the instance of PendingIntent where the app receives callbacks.
Task<Void> task = ActivityRecognition.getClient(context)
.removeActivityTransitionUpdates(myPendingIntent);
task.addOnSuccessListener(
new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void result) {
myPendingIntent.cancel();
}
}
);
task.addOnFailureListener(
new OnFailureListener() {
@Override
public void onFailure(Exception e) {
Log.e("MYCOMPONENT", e.getMessage());
}
}
);
แหล่งข้อมูลเพิ่มเติม
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้งาน API การจดจำกิจกรรมของผู้ใช้ โปรดดูแหล่งข้อมูลต่อไปนี้
ตัวอย่าง
ตัวอย่างเพื่อสาธิตแนวทางปฏิบัติแนะนำสำหรับการจดจำกิจกรรมของผู้ใช้