activity_recognition_flutter 3.0.1

Activity recognition plugin for Android and iOS.

activity_recognition_flutter

Important

This package uses the Android Embedding API v2. In order to use this in pre-Flutter 1.12 projects, you need to follow this guide: https://github.com/flutter/flutter/wiki/Upgrading-pre-1.12-Android-projects Activity recognition plugin for Android and iOS. Only working while App is running (= not terminated by the user or OS).

Getting Started

Check out the example directory for a sample app using activity recognition.

Android Permissions

Add permission to your Android Manifest, for Android 10 (API 29 and later), use:

<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" />

For Android 9 (API 28 and earlier), use:

<uses-permission android:name="com.google.android.gms.permission.ACTIVITY_RECOGNITION" />

Note: If you update from SDK <=28 to >=29 remember to run flutter clean (see e.g. this post)

Next, add the plugin's service inside the <application> tags:

<service android:name="dk.cachet.activity_recognition_flutter.activity.ActivityRecognizedService" />

iOS Permissions

An iOS app linked on or after iOS 10.0 must include usage description keys in its Info.plist file for the types of data it needs. Failure to include these keys will cause the app to crash. To access motion and fitness data specifically, it must include NSMotionUsageDescription, see example below.

<key>NSMotionUsageDescription</key>
<string>Detects human activity</string>

Flutter Usage

To use this plugin, you need to also use the permission handler plugin (https://pub.dev/packages/permission_handler)

See the example. NB, you should not use the permission handler plugin for requesting activity recognition on iOS, since it is not needed and will make your iOS app crash.

void _init() async {
  /// Android requires explicitly asking permission
  if (Platform.isAndroid) {
    if (await Permission.activityRecognition.request().isGranted) {
      _startTracking();
    }
  }

  /// iOS does not
  else {
    _startTracking();
  }
}

void _startTracking() {
  activityStream =
      activityRecognition.startStream(runForegroundService: true);
  activityStream.listen(onData);
}

Data types

• IN_VEHICLE
• ON_BICYCLE
• ON_FOOT
• RUNNING
• STILL
• TILTING
• UNKNOWN
• WALKING
• INVALID (used for parsing errors)