SMKitUI Flutter Plugin (v1.2.9) #

A Flutter plugin for integrating Sency's SMKitUI SDK, supporting both iOS and Android. Easily run fitness, body360, strength, cardio, and custom assessments and workouts, with unified user data and summary options.

⚠️ Breaking Changes in v1.2.8 #

Important: Preference setter methods (setSessionLanguage, setCounterPreferences, setEndExercisePreferences) no longer need to be awaited. Remove await from these calls to prevent hanging issues.

// ❌ Old way (v1.2.7 and earlier) - causes hanging
await _smkitUiFlutterPlugin.setSessionLanguage(language: SMKitLanguage.english);

// ✅ New way (v1.2.8+) - fire-and-forget
_smkitUiFlutterPlugin.setSessionLanguage(language: SMKitLanguage.english);

Features #

• Start Sency assessments and custom workouts from Flutter
• Unified user data input (gender, birthday)
• Configurable showSummary option for assessment results
• Android/iOS platform alignment for arguments
• Example app with dropdown for assessment type and summary toggle
• Android 15 Support: Full compatibility with Android 15 and 16KB page size requirements

Getting Started #

1. Configure the Plugin #

final _smkitUiFlutterPlugin = SmkitUiFlutterPlugin();
await _smkitUiFlutterPlugin.configure(key: apiPublicKey);

2. Set Preferences (Optional) #

// Fire-and-forget calls - no need to await
_smkitUiFlutterPlugin.setSessionLanguage(language: SMKitLanguage.english);
_smkitUiFlutterPlugin.setCounterPreferences(counterPreferences: SMKitCounterPreferences.perfectOnly);
_smkitUiFlutterPlugin.setEndExercisePreferences(endExercisePrefernces: SMKitEndExercisePreferences.targetBased);

3. Start an Assessment #

_smkitUiFlutterPlugin.startAssessment(
	type: selectedAssessmentType, // AssessmentTypes.fitness, body360, strength, cardio, custom
	userData: {
		'gender': 'male', // or 'female', 'idle' (case-insensitive)
		'birthday': DateTime(1990, 1, 1).millisecondsSinceEpoch,
		'email': '[email protected]', // optional
	},
	showSummary: showSummary, // bool
	assessmentID: assessmentId, // for custom assessments
	onHandle: (status) {
		// Handle status updates and results
	},
);

4. Start a Customized Workout or Assessment #

_smkitUiFlutterPlugin.startCustomaizedWorkout(
	workout: workout,
	onHandle: (status) {
		// Handle workout status
	},
);

_smkitUiFlutterPlugin.startCustomizedAssessment(
	assessment: assessment,
	onHandle: (status) {
		// Handle assessment status
	},
);

Example UI (from example app) #

// Dropdown for assessment type
DropdownButton<AssessmentTypes>(
	value: selectedAssessmentType,
	items: AssessmentTypes.values.map((type) {
		return DropdownMenuItem(
			value: type,
			child: Text(type.name),
		);
	}).toList(),
	onChanged: (type) {
		if (type != null) {
			setState(() {
				selectedAssessmentType = type;
			});
		}
	},
),

// Toggle for showSummary
Switch(
	value: showSummary,
	onChanged: (val) {
		setState(() {
			showSummary = val;
		});
	},
),

Migration Guide #

From v1.2.7 to v1.2.8 #

1. Remove await from preference setters to prevent hanging:

   // Before (v1.2.7)
   await _smkitUiFlutterPlugin.setSessionLanguage(language: SMKitLanguage.english);
      
   // After (v1.2.8)
   _smkitUiFlutterPlugin.setSessionLanguage(language: SMKitLanguage.english);
   

2. Benefits of this change:

   • Eliminates timeout issues during assessment startup
   • Faster assessment initialization
   • More reliable custom assessment launching
   • Better error handling and debugging

Platform Details #

• Android: Converts birthday to age, maps gender string to enum, supports both lowercase and capitalized values.
• iOS: Uses gender and birthday directly for native SDK.
• Both: Accept showSummary argument from Flutter.

Changelog #

See CHANGELOG.md for details.

License #

MIT For help getting started with Flutter development, view the online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.