How can I detect user pressing HOME key in my activity? [duplicate]

Can you please tell me how can my activity detect user pressing HOME key?

Thank you.

Update [August 2015]: As per the comment of JM Lord, this answer might not work as desired for devices Lollipop and above. See Alternative to getRunningTasks in Android L

Although, its an old question but most of the answers didn't work for me in API level 17 and above. I am answering what finally worked for me. I've tried many method but none of them are working as today. I tried answers on

Call method when home button pressed on android,

Detect home button press in android and

Overriding the Home button - how do I get rid of the choice?. The gist was that Home is like an emergency escape button. So you can't override it but can detect it in some ways.

Some of the ones I tried( including above answers) and didn't work are:

Using keyCode==KeyEvent.KEYCODE_HOME in many ways as stated above. Now, if you read the documentation of KeyEvent.KEYCODE_HOME, it says that This key is handled by the framework and is never delivered to applications. So its no more valid now.
I tried using onUserLeaveHint(). The documentation says:

Called as part of the activity lifecycle when an activity is about to go into the background as the result of user choice. For example, when the user presses the Home key, onUserLeaveHint() will be called, but when an incoming phone call causes the in-call Activity to be automatically brought to the foreground.

The issue with that is that the method also gets called when you start an Activity from within the activity where you are calling onUserleaveLint(), as was my case. See Android onBackPressed/onUserLeaveHint question for more. So its not sure that it would be call ONLY by pressing home button.
Calling onStop(). It can also be called when an activity comes on top of the existing activity and fully covers it. So this also wont work.

Finally the following worked for me :

Seeing How to check current running applications in Android? you can say that if yours is the recent task that is shown on long pressing the home button, then it was send to background.

So, In your onPause() of the activity where you are trying to detect the home button pressed, you can check whether the application has been sent to background.

@Override
public void onPause() {
    if (isApplicationSentToBackground(this)){
        // Do what you want to do on detecting Home Key being Pressed 
    }
    super.onPause();
}

Function to check whether yours is the app which has been most recently sent to the background:

public boolean isApplicationSentToBackground(final Context context) {
    ActivityManager am = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
    List<RunningTaskInfo> tasks = am.getRunningTasks(1);
    if (!tasks.isEmpty()) {
        ComponentName topActivity = tasks.get(0).topActivity;
        if (!topActivity.getPackageName().equals(context.getPackageName())) {
            return true;
        }
    }
    return false;
}

Thanks to @idish for pointing out that don't forget to include the following permission in your manifest:

<uses-permission android:name="android.permission.GET_TASKS" />

I am not sure whether there are any downsides of this, but it worked for me well. Hope it helps someone someday.

P.S: If you use this method in an Activity which has been launched with FLAG_ACTIVITY_NO_HISTORY flag, then this won't be useful as it checks the recent history for figuring out if Home button was clicked.

You can detect a HOME button press via Activity.onUserLeaveHint(). This method is called in two situations; when the user presses HOME and when a new activity is started. Make sure to somehow differenciate between the two.

There is no formal way to be notified of a "HOME" key press. But there is a pretty simple work around to have your app distinguish between a "HOME" key press and any other action which would cause the Activity to stop.

For each class that need to perform some action on a "HOME" key press have them extend from an activity which contains this:

/**************************************** On Home **********************************/
private boolean leaveCalled = false;

@Override
public void startActivity(Intent intent) {  
    leaveCalled= true;
    super.startActivity(intent);
}

@Override
public void onBackPressed() {
    leaveCalled = true;
    super.onBackPressed();
}

@Override
protected void onStop() {   
    super.onStop();
    // Home button pressed
    if(!leaveCalled) {
        // Do whatever you like.
    }

    leaveCalled = false;
}

EDIT

You will also need to extend your Fragments from a parent class which contains this. This is because fragments would otherwise provide an extra route to switch between activities in your app in an expected and not "HOME" way.

@Override
public void startActivity(Intent intent) {  
    getActivity().startActivity(intent);
}

EDIT 2

I'm getting close to thinking this isn't the easiest way to deal with this... You need to also add onConfigurationChange="orientation" to all of your activities which use this method. Then you can add this:

@Override
public void onConfigurationChanged(Configuration newConfig) {   
    super.onConfigurationChanged(newConfig);
    leaveCalled = true;                     
    finish();
    startActivity(getIntent()); 
}

EDIT 3

Urgh

@Override
public void finish() {
    leaveCalled = true;
    super.finish();
}

You can't capture the HOME event and intercept it in any way. The user will always be taken to the home screen of their device when they press the home key.

If you need to know when your Activity is being sent to the background, like from the user pressing the home or back keys, I'd implement the onStop() method.

use onUserLeaveHint() method in your Activity

@Override
protected void onUserLeaveHint()
{
   super.onUserLeaveHint();
}

http://developer.android.com/reference/android/app/Activity.html#onUserLeaveHint()

How can I detect user pressing HOME key in my activity? [duplicate]

Related

Recent Posts