TimeoutSensor

Timeout Sensor for Android Applications

This library will make it easy to set a session timeout duration and monitor the application for inactivity. If there has not been any user interaction for the specified amount of time, a dialog will pop up and give the user an additional 30 seconds to respond otherwise the application will kill itself.

Make sure to add to your gradle:

allprojects {
	repositories {
		...
		maven { url 'https://jitpack.io' }
	}
}


	dependencies {
        compile 'com.github.buradd:TimeoutSensor:1.8'
}

To use, you must extend all of your activities with TimeoutActivity (or TimeoutCompatActivity if you use AppCompat):

public class MainActivity extends TimeoutActivity {

}

//OR IF YOU USE APPCOMPAT,

public class MainActivity extends TimeoutCompatActivity {

}

Then, start the sensor and provide the duration (in minutes.):

//This will start the sensor to check for 15 minutes of inactivity.
TimeoutSensor.start(15);

You can also set the duration and call start separately:

TimeoutSensor.setTimeoutDuration(15);
TimeoutSensor.start();

You may stop the sensor at any time:

TimeoutSensor.stop();

The dialog fragment can be customized:

//set the Title
TimeoutSensor.setDialogTitle("ATTENTION:");

//set the Message
TimeoutSensor.setDialogMessage("Your session is about to expire.");

//set the Button Text
TimeoutSensor.setDialogButton("STAY SIGNED IN");

//set the TextView Text (this can take %s which will be replaced by the remaining seconds of the dialogs timer)
TimeoutSensor.setDialogTextview("Session will expire in: %s seconds.");

There is a sample APK available here: https://github.com/buradd/TimeoutSensor/blob/master/sample/app/TimeoutSensorSample.apk

That's it!