Live Activities
A Flutter plugin to use iOS 16.1+ Live Activities & iPhone 14 Pro Dynamic Island features.
🧐
What is it ?
This plugin use iOS ActivityKit API.
live_activities can be used to show dynamic live notification & implement dynamic island feature on the iPhone 14 Pro / Max
⚠️ live_activities is only intended to use with iOS 16.1+ ! It will simply do nothing on other platform & < iOS 16.1
👻
Getting started
Due to some technical restriction, it's not currently possible to only use Flutter 🫣.
You need to implement in your Flutter iOS project a Widget Extension & develop in Swift/Objective-C your own Live Activity / Dynamic Island design.
ℹ️ You can check into the example repository for a full example app using Live Activities & Dynamic Island
🧵
Native
-
📱 Create natively your Live Activity view tutorial-
⚫️ (Opt.) Create natively a Dynamic Island tutorial
-
-
🛎 Enable push notification capabilities.
-
⛹️ Enable live activities for both your app & widget extension.
💙
Flutter
-
🔌 Import the plugin.
import 'package:live_activities/live_activities.dart';
-
📣 Create your dynamic activity.
final Map<String, String> activityModel = {
'name': 'Margherita',
'ingredient': 'tomato, mozzarella, basil',
'quantity': '1',
};
_liveActivitiesPlugin.createActivity(activityModel.toMap());
⚠️ For now you can only pass values asString
.
📘
Documentation
Name | Description | Returned value |
---|---|---|
.createActivity() |
Create an iOS live activity, | String The activity identifier |
.updateActivity() |
Update the live activity data by using the activityId provided |
Future When the activity was updated |
.endActivity() |
End the live activity by using the activityId provided |
Future When the activity was ended |
🎯
Roadmap
- Support multiple type instead of
String
(Date, Number etc.). - Inject a Widget inside the notification with Flutter Engine ?