您可能需要设计应用以确定用户何时启动或停止特定 Activity(例如步行、骑车或驾车)。例如,里程跟踪应用可以在用户开始驾车时开始跟踪里程,或者即时通讯应用可以在用户停止驾车之前忽略所有会话。
Activity Recognition Transition API 可用于检测用户 Activity 的变化。您的应用可以订阅相关 Activity 中的转换事件,该 API 仅在需要时通知您的应用。本页介绍了如何使用 Activity Recognition Transition API,以下简称 Transition API。
设置项目
如需在应用中使用 Transition API,您必须在清单文件中声明依赖 Google Location and Activity Recognition API 12.0.0 或更高版本,并指定 com.google.android.gms.permission.ACTIVITY_RECOGNITION 权限。
- 如需声明依赖该 API,请添加对 Google Maven 代码库的引用,并将
com.google.android.gms:play-services-location:12.0.0的实现条目添加到应用build.gradle文件的 dependencies 部分。如需了解详情,请参阅设置 Google Play 服务。 如需指定
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>
注册 Activity 转换更新
如需开始接收有关 Activity 转换的通知,您必须实现以下两项:
- 一个
ActivityTransitionRequest对象,用于指定活动和转换的类型。 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());
您可以通过将 ActivityTransitions 列表传递给 ActivityTransitionRequest 类来创建 ActivityTransitionRequest 对象,如以下示例所示:
Kotlin
val request = ActivityTransitionRequest(transitions)
Java
ActivityTransitionRequest request = new ActivityTransitionRequest(transitions);
您可以通过将 ActivityTransitionRequest 实例和 PendingIntent 对象传递给 requestActivityTransitionUpdates() 方法来注册 activity 转换更新。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
}
}
);
成功注册 Activity 转换更新后,您的应用会在已注册的 PendingIntent 中接收通知。
处理 Activity 转换事件
当发生请求的活动转换时,您的应用会收到 Intent 回调。您可以从 Intent 中提取 ActivityTransitionResult 对象,其中包含 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....
}
}
}
取消注册 Activity 转换更新
您可以通过调用 ActivityRecognitionClient 的 removeActivityTransitionUpdates() 方法并传递 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 的使用情况,请查看以下资料:
示例
此示例演示了用户运动状态识别的最佳实践。