vivanta_connect_flutter

Description:

vivanta connect flutter

Vivanta Connect for Flutter #
Plugin to integrate Vivanta Connect in Flutter Projects
How to implement Vivanta Connect Flow #

Add the import of Vivanta Connect

import 'package:vivanta_connect_flutter/views/start_vivanta_connect.dart';
copied to clipboard

Create a route to open Vivanta Connect. For example:

Navigator.of(context).push(
MaterialPageRoute(
builder: (context) => VivantaConnectFlutter(
apiKey: apiKey, // Required
customerId: customerId, // Required
externalUserId: externalUserId, // Required
companyId: companyId, // Optional
),
),
);
copied to clipboard
Optional use with a JWT Token obtained by the /users/auth endpoint:
Navigator.of(context).push(
MaterialPageRoute(
builder: (context) => VivantaConnectFlutter(
token: token, // Required
),
),
);
copied to clipboard

Vivanta Connect will start and automatically set the language based on the configuration of the device.

Note: Vivanta Connect requires a valid API Key and the associated Customer ID to fully function.
How to implement Embedded Graphs #

Create a route to open an Embedded Graph

Navigator.of(context).push(
MaterialPageRoute(
builder: (context) => EmbeddedGraph(
apiKey: apiKey, // Required
customerId: customerId, // Required
externalUserId: externalUserId, // Required
graphType: graphType, // Required (Sleep, Active Time, Activity)
brandId: brandId, // Optional, only for users with more than 1 brand connected
),
),
);
copied to clipboard
Only for Apple Health integrations (iOS) #

Add this code at the start of your user's session for obtaining and syncing Apple Health data.

import 'package:vivanta_connect_flutter/helpers/vivanta_sync.dart';

final vivantaSyncData = VivantaSync(
apiKey: apiKey, // Required
customerId: customerId, // Required
externalUserId: externalUserId, // Required
);
vivantaSyncData.executeAll(); // This process gets data from HealthKit and uploads to Vivanta
);
copied to clipboard
Optional use with a JWT Token obtained by the /users/auth endpoint:
import 'package:vivanta_connect_flutter/helpers/vivanta_sync.dart';

final vivantaSyncData = VivantaSync(
token: token, // Required
);
vivantaSyncData.executeAll(); // This process gets data from HealthKit and uploads to Vivanta
);
copied to clipboard

Add the following elements in the Info.plist file.

<key>NSHealthShareUsageDescription</key>
<string>[Add here the purpose for reading from Apple Health]</string>
<key>NSHealthUpdateUsageDescription</key>
<string>[Add here the purpose for writing to Apple Health]</string>
copied to clipboard
Only for Google Health Connect integrations (Android) #

Add the following code in your AndroidManifest.xml, inside the root node:

<queries>
<package android:name="com.google.android.apps.healthdata" />
<package android:name="com.google.android.apps.fitness" />
</queries>
copied to clipboard

Add the following code in your main <activity> node:

<intent-filter>
<action android:name="androidx.health.ACTION_SHOW_PERMISSIONS_RATIONALE" />
</intent-filter>
copied to clipboard

Add at least one of the permissions that your app will have access, in your AndroidManifest.xml inside the root node. The complete list of permissions is in this link: https://developer.android.com/health-and-fitness/guides/health-connect/plan/data-types#alpha10. For example:

<uses-permission android:name="android.permission.health.READ_STEPS"/>
copied to clipboard

In your gradle.properties file, replace this values:

org.gradle.jvmargs=-Xmx1536M
android.enableJetifier=true
android.useAndroidX=true
copied to clipboard

Add this code at the start of your user's session for obtaining and syncing Google Health Connect data.

import 'package:vivanta_connect_flutter/helpers/vivanta_sync.dart';

final vivantaSyncData = VivantaSync(
apiKey: apiKey, // Required
customerId: customerId, // Required
externalUserId: externalUserId, // Required
);
vivantaSyncData.executeAll(); // This process gets data from HealthKit and uploads to Vivanta
);
copied to clipboard
Optional use with a JWT Token obtained by the /users/auth endpoint:
import 'package:vivanta_connect_flutter/helpers/vivanta_sync.dart';

final vivantaSyncData = VivantaSync(
token: token, // Required
);
vivantaSyncData.executeAll(); // This process gets data from HealthKit and uploads to Vivanta
);
copied to clipboard