react-native-ba-activity-monitor

Native Activity Monitor for RN apps

Installation

yarn add react-native-ba-activity-monitor

Android

Add this to the bottommost part of your manifest <application> tag.

<service android:name="com.reactnativebaactivitymonitor.DetectedActivityService" />
<receiver
    android:name="com.reactnativebaactivitymonitor.TransitionsReceiver"
    android:exported="false"
    android:permission="com.google.android.gms.permission.ACTIVITY_RECOGNITION">
    <intent-filter>
      <action android:name="action.TRANSITIONS_DATA" />
    </intent-filter>
</receiver>

iOS

Important

To use this API, you must include the NSMotionUsageDescription key in your app’s Info.plist file and provide a usage description string for this key. The usage description appears in the prompt that the user must accept the first time the system asks the user to access motion data for your app. If you don’t include a usage description string, your app crashes when you call this API.

Usage

import ActivityMonitor from 'react-native-ba-activity-monitor';

// ...

useEffect(() => {
  async function startReceivingActivities() {
    const permission = await ActivityMonitor.askPermission();
    if (permission === 'granted') {
      await ActivityMonitor.start();
      const unregisterCallback = ActivityMonitor.onActivities((activities) => {
        console.debug(
          '[ActivityMonitor] activities: ' + JSON.stringify(activities)
        );
      });
    }
  }

  startReceivingActivities();
  return () => {
    ActivityMonitor.stop();
    // or simply unregister your callback calling the function returned by `.onActivities` to stop 
    // receiving events on the registered callback without entirely stopping the native service.
  }
}, []);

// ...

Considerations

Fully typed with TypeScript. Feel free to aknowledge all the types on the index.tsx file and import them as needed in your project.

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

Unlicensed code. For exclusive usage of BetaAcid LLC.

---

Boostraped with create-react-native-library