repository·master·Indexed 20 days ago
https://github.com/carp-dk/flutter-pluginsA collection of first-party Flutter plugins maintained by the Copenhagen Research Platform (CARP) for accessing platform-specific sensors and APIs. Included plugins provide functionality for activity recognition, air quality data retrieval via aqicn.org, Android app usage statistics, PCM audio streaming via audio_streamer, and background location tracking.
The plugin maps the Empatica Android API almost 1:1 but uses Dart Streams instead of callbacks to follow Flutter's reactive architecture.
Key concepts:
EmpaticaPlugin: The main class used to manage all device operations.statusEventSink: A stream used to monitor the state of the device manager (e.g., UpdateStatus, DiscoverDevice).dataEventSink: A stream that emits physiological data once a device is connected.Important Lifecycle Rule: You must start listening to statusEventSink and dataEventSink before initiating connection or scanning to ensure you don't miss events.
The plugin follows a hierarchical Bluetooth GATT structure:
MovisensDevice: The top-level object representing the sensor.MovisensService: A collection of related data categories (e.g., ambientService, hrvService) belonging to the device.MovisensBluetoothCharacteristic: The individual data types within a service. These are either:SensorTemperatureEvents.setDeleteData().The esense_flutter plugin uses a reactive programming model based on Dart Streams. Instead of traditional listeners, you interact with the ESenseManager by listening to specific streams for different types of data:
connectionEvents: Provides ConnectionEvent updates. You should start listening to this stream before calling connect() to ensure you capture the connection status.sensorEvents: Provides a stream of SensorEvent data. You can control the sampling rate using setSamplingRate() when not actively listening.eSenseEvents: Used for asynchronous property reading. When you call a method like getDeviceName(), the result is emitted as an ESenseEvent through this stream.Important: Audio playing and recording are performed via Bluetooth Classic and are not supported by this specific library.
// 1. Initialize
ESenseManager eSenseManager = ESenseManager('eSense-0332');
// 2. Listen to connection status BEFORE connecting
eSenseManager.connectionEvents.listen((event) {
print('CONNECTION event: $event');
});
// 3. Initiate connection
bool connecting = await eSenseManager.connect();The plugin uses a hierarchical model to derive features from raw GPS data:
Derived Metrics:
The plugin requires iOS 10 or later. Ensure your ios/Podfile is set to:
platform :ios, '10.0'Add the following keys to your ios/Runner/Info.plist to allow Bluetooth usage and background modes:
<key>NSBluetoothAlwaysUsageDescription</key>
<string>Uses bluetooth to connect to the eSense device</string>
<key>UIBackgroundModes</key>
<array>
<string>bluetooth-central</string>
<string>bluetooth-peripheral</string>
<string>audio</string>
<string>external-accessory</string>
<string>fetch</string>
</array>app_usage_example project serves as a demonstration application for the app_usage plugin. It provides a functional Flutter application template to help you understand how to integrate and use the app_usage plugin in a real-world scenario.To use the Pedometer plugin, you must configure platform-specific permissions to access motion and activity data. Note that on some devices, users may still need to manually grant these permissions in the system Settings.
For Android 10 and above, add the following permission to your AndroidManifest.xml:
Add the following keys to your Info.plist file within the Runner Xcode project:
<!-- Android: AndroidManifest.xml -->
<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" />
<!-- iOS: Info.plist -->
<key>NSMotionUsageDescription</key>
<string>This application tracks your steps</string>
<key>UIBackgroundModes</key>
<array>
<string>processing</string>
</array>mdslib-x.x.x-release.aar from the movesense-mobile-lib repository..aar file in your app's android/libs folder.android/build.gradle file to include the libs directory in your repositories.For Groovy:
allprojects {
repositories {
...
flatDir{
dirs "$rootDir/libs"
}
}
}For Kotlin:
Use dirs("$rootDir/libs") within the repositories block.
Add light as a dependency in your pubspec.yaml file to use the plugin for collecting ambient light data on Android and iOS.
dependencies:
light: ^latest_versionTo use the notifications plugin, add it as a dependency in your pubspec.yaml file.
Additionally, you must register the notification listener service in your Android configuration. Add the following <service> block inside the <application> tag of your android/app/src/main/AndroidManifest.xml file:
<service
android:label="notifications"
android:name="dk.cachet.notifications.NotificationListener"
android:permission="android.permission.BIND_NOTIFICATION_LISTENER_SERVICE">
<intent-filter>
<action android:name="android.service.notification.NotificationListenerService" />
</intent-filter>
</service>To use the noise meter on iOS, follow these three steps:
Info.plist file and add an entry for Privacy - Microphone Usage Description.Podfile to include the microphone permission in the post_install block so the permission handler recognizes it.post_install do |installer|
installer.pods_project.targets.each do |target|
flutter_additional_ios_build_settings(target)
target.build_configurations.each do |config|
config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
'$(inherited)',
'PERMISSION_MICROPHONE=1',]
end
end
end