TimeoutSensor

Additional

Language
Java
Version
1.8 (Apr 3, 2017)
Created
Mar 31, 2017
Updated
Apr 4, 2017 (Retired)
Owner
buradd
Contributors
android-dataticket
buradd
2
Activity
Badge
Generate
Download
Source code
APK file

Promotion

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!