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!