Github repo: https://github.com/Bethel-Eyo/Transitions
In this tutorial, you will learn the following:
For this tutorial, you will need the following :
Intermediate
The provision for Mobile development on new Smart phones has helped to aid slick innovative technologies that has helped to better the lives of individuals. Our mobile devices have become indispensable in our daily activities, we basically take it everywhere we go; but until now it has been difficult for apps to adjust their experience to a user’s continually changing environment and activity.
Activity transition API helps to solve this problem by providing a simple API that does all the processing for you and provides you with information that is specific to your needs. This tutorial shows you how to properly integrate this feature into your android app.
To integrate the Transition API into your app, you are required to declare a dependency
1. To make the Google Play services APIs available to your app.
build.gradle file inside your application module directory, play-services, as of this tutorial I used com.google.android.gms:play-services-location:15.0.1. maven { url "https://maven.google.com" } reference to your top-level build.gradle file. 2. Add a new permission to your AndroidManifest.xml file as shown below
To view the manifest file. Click here
In order to get notified on activity transitions, you are required to implement an ActivityTransitionRequest (to specify the type of activity and transition) and a PendingIntent callback for receiving notifications.
To create an ActivityTransitionRequest object, you have to create a list of ActivityTransition objects which will serve as a representation of the transition that you want to be notified about.
To know more about Activity Transitions, click here
To know more about these activities, click here
Here is a screenshot of how i created a list of ActivityTransitionObjects in my Transitions Android App
To view the activity from which I created the list of activity objects, click here.
Then you create can ActivityTransitionRequest object by passing in the list of transitions into the ActivityTransitionRequest class as shown below;
ActivityTransitionRequest request = new ActivityTransitionRequest(transitions);
You can also register for updates in activity transitions by passing in the instance of AcitvityTransitionrequest and your PendingIntent object to the requestActivityTransitionUpdates method which then returns a Task object which in turn helps you to check for for success or failure as shown in the code below;
Task<Void> task =
ActivityRecognition.getClient(this)
.requestActivityTransitionUpdates(request, mPendingIntent);
task.addOnSuccessListener(
new OnSuccessListener<Void>() {
@Override
public void onSuccess(Void result) {
Log.i(TAG, "Transitions Api was successfully registered.");
}
});
task.addOnFailureListener(
new OnFailureListener() {
@Override
public void onFailure(Exception e) {
Log.e(TAG, "Transitions Api could not be registered: " + e);
}
});
}After for activity transition updates successfully, the app begins to receive notifications in the registered PendingIntent.
On the occurrence of the activity transition, an intent callback is received. An ActivityTransitionResult object can be extracted from the intent and this will include a list of ActivityTransitionEvent objects. The events are ordered in a timely manner. For instance, if an app makes a request for the IN_VEHICLE activity type on the ACTIVITY_TRANSITION_ENTER and ACTIVITY_TRANSITION_EXIT transitions, then an ActivityTransitionEvent is received when the user starts driving, and another when the user transits to any other activity.
The callback can be implemented by creating a BroadcastReceiver and implementing the onReceive() method. as shown in the screenshot below
Click here to view the file in which this was implemented
After all the processes has been achieved and all activity transitions have been rightly implemented, you can de-register for activity transition updates by calling the removeActivityTransitionUpdates() method, of the ActivityRecognitionClient and passing in the PendingIntent object as the parameter as shown in the code below
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());
}
});A Basic Android app was implemented to better describe how the Activity Transition API can be implemented and how its features can be effectively utilized. To get a better understanding you can clone the repo with this link to your local machine see how it has been implemented and work through the code.
I hope Android developers find this tutorial helpful and get to work on implementing this new and amazing feature that makes activity transition detection smooth and easy. You can access the complete code for this tutorial on my github repo
The apk of the app can also be downloaded here