vital_devices 1.9.0 vital_devices: ^1.9.0 copied to clipboard
The Vital Devices package allowing health devices to connect to the phone.
vital_devices #
Introduction #
The Vital SDK is split into three main components: vital_core
, vital_health
and vital_devices
.
- vital_core holds common
components to both
vital_health
andvital_devices
. Among other things, it has the network layer that allows us to send data from a device to a server. - vital_health is an abstraction over HealthKit an Health Connect(coming soon)
- vital_devices is an abstraction over a set of Bluetooth devices.
Getting Started #
iOS #
Add the following to your Info.plist
file:
<key>NSBluetoothAlwaysUsageDescription</key>
<string>Our app uses bluetooth to find, connect and transfer data between different devices</string>
You will have to request the bluetooth permission in your app before using the SDK.
Android #
Add the following to your AndroidManifest.xml
:
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation"/>
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<!-- Request legacy Bluetooth permissions on older devices. -->
<uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" android:maxSdkVersion="30"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30"/>
You will have to request the appropriate permissions at in your app before you can call the Vital Devices SDK.
Usage #
First you have to scan for one of the supported devices. You can find the list of supported devices by
calling DeviceManager().devices
.
vitalDevices.scanForDevices(deviceModel).listen((device) {
// now you have the device you were looking for
});
Depending on the type of device you are connecting to, you will have to call different methods to connect to it.
Blood pressure monitor #
vitalDevices.readBloodPressureData(scannedDevice).listen((bloodPressureSamples) {
// you will receive a list of blood pressure samples
});
Glucose meter #
vitalDevices.readGlucoseMeterData(scannedDevice).listen((glucoseSamples) {
// you will receive a list of glucose samples
});
After you have received samples depending on the type of device you might need to star scanning again to receive the next set of samples.
Documentation #
For more example usage run the sample app with your API key and Region set in main.dart
.
Please refer to the official Vital docs provide a full reference on using
this library.
License #
vital-flutter is available under the AGPLv3 license. See the LICENSE file for more info. VitalDevices is under
the Adept Labs Enterprise Edition (EE) license (the “EE License”)
. Please refer to its license inside its folder.