Suspend Shutdown hooks

The TomTom BRIDGE allows you to intervene when it is about to be suspended or shut down. It will look for apps listening for the ACTION_REQUEST_CONFIRM_SUSPEND_SHUTDOWN intent and if one is installed, control over the suspend/shutdown flow is handed over to this app. This can be useful for situations where you do not want the device to suspend/shutdown because some process is not finished or users first need to log out of your own systems, for example.

Make sure to use a priority higher than 5 for this intent-filter, to make sure your app will be called. The default handler uses priority 5 so to supersede it your priority must be higher. So your AndroidManifest.xml will contain this:

1<!-- Permissions needed -->
2<uses-permission android:name="android.permission.DEVICE_POWER" />
3<uses-permission android:name="android.permission.SHUTDOWN" />
4...
5<!-- Priority needed > 5 -->
6<intent-filter android:priority="10" >s
7  <action android:name="android.intent.action.ACTION_REQUEST_CONFIRM_SUSPEND_SHUTDOWN" />
8  <category android:name="android.intent.category.DEFAULT" />
9</intent-filter>

The intent comes with two integer extras: poweroff_state and poweroff_reason. The former indicates the state the system is trying to get to, 1 for a shutdown and 2 to be suspended, and the reason gives an indication why the device is trying to get to that state:

Once you have decided to proceed with the suspend/shutdown it's the apps responsibility now to make that happen! These are the calls you can use:

1private void suspend() {
2    try {
3        finish()
4        final PowerManager pm = (PowerManager) getSystemService(Context.POWER_SERVICE);
5        pm.goToSleep(SystemClock.uptimeMillis());
6    } catch (final SecurityException e) {
7        Log.e(TAG, "SecurityException ", e);
8    }
9}
10
11private void shutdown() {
12    try {
13        finish();
14        final Intent shutdownIntent = new Intent("android.intent.action.ACTION_REQUEST_SHUTDOWN");
15        startActivity(shutdownIntent);
16    } catch (final SecurityException e) {
17        Log.e(TAG, "SecurityException ", e);
18    }
19}

To prevent the suspend/shutdown from happening, the only thing you need to do is ignore it: don't suspend or request a shutdown from your app and nothing will happen.