יכול להיות שתצטרכו לתכנן את האפליקציה כך שתזהה מתי המשתמש מתחיל או מפסיק פעילות מסוימת, כמו הליכה, רכיבה על אופניים או נהיגה. לדוגמה, אפליקציה למעקב אחרי קילומטראז' יכולה להתחיל לעקוב אחרי הקילומטרים כשהמשתמש מתחיל לנהוג, או שאפליקציית הודעות יכולה להשתיק את כל השיחות עד שהמשתמש מפסיק לנהוג.
אפשר להשתמש ב-Activity Recognition Transition API כדי לזהות שינויים בפעילות של המשתמש. האפליקציה שלכם נרשמת למעבר בין פעילויות שמעניינות אתכם, וה-API שולח התראה לאפליקציה רק כשצריך. בדף הזה מוסבר איך להשתמש ב-Activity Recognition Transition API, שנקרא גם Transition API בקיצור.
הגדרת הפרויקט
כדי להשתמש ב-Transition API באפליקציה, צריך להצהיר על תלות בגרסה 12.0.0 ומעלה של Google Location and Activity Recognition API, ולציין את ההרשאה com.google.android.gms.permission.ACTIVITY_RECOGNITION בקובץ המניפסט של האפליקציה.
- כדי להצהיר על תלות ב-API, מוסיפים הפניה למאגר Maven של Google ומוסיפים רשומת הטמעה של
com.google.android.gms:play-services-location:12.0.0לקטע dependencies בקובץbuild.gradleשל האפליקציה. מידע נוסף זמין במאמר הגדרת Google Play Services. כדי לציין את ההרשאה
com.google.android.gms.permission.ACTIVITY_RECOGNITION, מוסיפים רכיב<uses-permission>בקובץ המניפסט של האפליקציה, כמו בדוגמה הבאה:<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 כולל את הנתונים הבאים:
- סוג פעילות, שמיוצג על ידי המחלקה
DetectedActivity. Transition 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 ל-method 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 כשהמשתמש מתחיל לנהוג, ואובייקט נוסף כשהמשתמש עובר לפעילות אחרת.
כדי להטמיע את הקריאה החוזרת, יוצרים מחלקת משנה של 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 לזיהוי פעילות המשתמש, אפשר לעיין במקורות המידע הבאים:
דוגמאות
דוגמה שממחישה שיטות מומלצות לזיהוי פעילות משתמשים.