Skip to content

marcshilling/react-native-idle-timer

Folders and files

NameName
Last commit message
Last commit date
Mar 8, 2024
Mar 8, 2024
Oct 22, 2016
Apr 21, 2016
Apr 5, 2023
Apr 5, 2023
Feb 26, 2023
Mar 8, 2024
May 8, 2024

Repository files navigation

react-native-idle-timer

A cross-platform bridge that allows you to enable and disable the screen idle timer in your React Native app

Install

yarn add react-native-idle-timer

Link

Automatically

react-native link react-native-idle-timer

Manually

iOS
  1. In the XCode's "Project navigator", right click on your project's Libraries folder ➜ Add Files to <...>
  2. Go to node_modulesreact-native-idle-timerios ➜ select RNIdleTimer.xcodeproj
  3. Add libRNIdleTimer.a to Build Phases -> Link Binary With Libraries
Android
  1. in android/settings.gradle
...
include ':react-native-idle-timer'
project(':react-native-idle-timer').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-idle-timer/android')
  1. in android/app/build.gradle add:
dependencies {
  ...
  compile project(':react-native-idle-timer')
}
  1. and finally, in android/src/main/java/com/{YOUR_APP_NAME}/MainActivity.java add:
//...
import com.marcshilling.idletimer.IdleTimerPackage; // <--- This!

//...
@Override
protected List<ReactPackage> getPackages() {
  return Arrays.<ReactPackage>asList(
    new MainReactPackage(),
    new IdleTimerPackage() // <---- and This!
  );
}

Usage

In your React Native javascript code, bring in the native module:

import IdleTimerManager from 'react-native-idle-timer';

To disable the idle timer while a certain component is mounted:

Class component

componentWillMount() {
  IdleTimerManager.setIdleTimerDisabled(true);
}

componentWillUnmount() {
  IdleTimerManager.setIdleTimerDisabled(false);
}

Function component

useEffect(() => {
  IdleTimerManager.setIdleTimerDisabled(true);

  return () => IdleTimerManager.setIdleTimerDisabled(false);
}, [])

If you have multiple components that are responsible for interacting with the idle timer, you can pass a tag as the second parameter:

useEffect(() => {
  IdleTimerManager.setIdleTimerDisabled(true, "video");

  return () => IdleTimerManager.setIdleTimerDisabled(false, "video");
}, [])

If you need to interact from the native Android or iOS side:

Android

IdleTimerManager.activate(activity, "video");
IdleTimerManager.deactivate(activity, "video");

iOS

[IdleTimerManager activate:@"video"];
[IdleTimerManager deactivate:@"video"];

About

A cross-platform bridge that allows you to enable and disable the screen idle timer in your React Native app

Resources

License

Stars

Watchers

Forks

Packages

No packages published