|
| 1 | +--- |
| 2 | +title: Push Notifications |
| 3 | +slug: /push-notifications |
| 4 | +sidebar_position: 3 |
| 5 | +description: Learn how to enable push notifications in the Stream Video Flutter SDK. |
| 6 | +--- |
| 7 | + |
| 8 | +Apart from the VoIP notifications for call ringing features, Stream Video Flutter SDK also supports standard push notifications. This guide will show you how to enable push notifications in your Flutter app using the Stream Video SDK. |
| 9 | + |
| 10 | +Push notifications are sent in the following scenarios: |
| 11 | +- you create a call with the `ring` value set to true. In this case, a notification that shows a ringing screen is sent. (covered in the [ringing documentation](https://getstream.io/video/docs/flutter/advanced/ringing_and_callkit/)) |
| 12 | +- you create a call with the `notify` value set to true. In this case, a regular push notification is sent. |
| 13 | +- you haven't answered a call. In this case, a missed call notification is sent (regular push notification). |
| 14 | + |
| 15 | +## Android and Firebase Cloud Messaging (FCM) |
| 16 | + |
| 17 | +For FCM the steps taken in [ringing documentation](https://getstream.io/video/docs/flutter/advanced/ringing_and_callkit/) are enough and will also handle standard push notifications. |
| 18 | + |
| 19 | +In case of missed call the notification will be shown using [flutter_callkit_incoming](https://pub.dev/packages/flutter_callkit_incoming) package. It can be configured by `pushParams` when initializing `StreamVideo`: |
| 20 | + |
| 21 | +```dart |
| 22 | +StreamVideo( |
| 23 | + apiKey, |
| 24 | + user: user, |
| 25 | + pushNotificationManagerProvider: StreamVideoPushNotificationManager.create( |
| 26 | + iosPushProvider: const StreamVideoPushProvider.apn( |
| 27 | + name: 'apn', |
| 28 | + ), |
| 29 | + androidPushProvider: const StreamVideoPushProvider.firebase( |
| 30 | + name: 'firebase', |
| 31 | + ), |
| 32 | + pushParams: const StreamVideoPushParams( |
| 33 | + appName: kAppName, |
| 34 | + ios: IOSParams(iconName: 'IconMask'), |
| 35 | + missedCallNotification: NotificationParams( |
| 36 | + showNotification: true, |
| 37 | + subtitle: 'Missed Call', |
| 38 | + callbackText: 'Call Back', |
| 39 | + ) |
| 40 | + ), |
| 41 | + ), |
| 42 | +); |
| 43 | +``` |
| 44 | + |
| 45 | +If you want to handle missed call notification differently or handle the notification about incoming call (when `notify` is set to true) use the existing `_handleRemoteMessage()` method (see [ringing documentation](https://getstream.io/video/docs/flutter/advanced/ringing_and_callkit/)): |
| 46 | + |
| 47 | +```dart |
| 48 | +Future<bool> _handleRemoteMessage(RemoteMessage message) async { |
| 49 | + final payload = message.data; |
| 50 | +
|
| 51 | + final sender = payload['sender'] as String?; |
| 52 | + final type = payload['type'] as String?; |
| 53 | +
|
| 54 | + if (sender == 'stream.video' && type == 'call.notification') { |
| 55 | + final callCid = payload['call_cid'] as String?; |
| 56 | + // Show notification, for example using `flutter_local_notifications` package |
| 57 | + } |
| 58 | +
|
| 59 | + final streamVideo = locator.get<StreamVideo>(); |
| 60 | + return streamVideo.handleVoipPushNotification( |
| 61 | + message.data, |
| 62 | + handleMissedCall: false, //<-- Add this flag if you dont want a default missed call notification handling |
| 63 | + ); |
| 64 | +} |
| 65 | +``` |
| 66 | + |
| 67 | +## iOS and Apple Push Notification Service (APNs) |
| 68 | + |
| 69 | +For APNs the standard push notifications have to be handled separately of VoIP notifications. When APN push provider is registered for iOS, both VoIP and standard push notifications are send using APN by Stream Video SDK. |
| 70 | + |
| 71 | +### Registering APN device token |
| 72 | + |
| 73 | +First you need to register APN device token as it is separate from the VoIP token (registered out-of-the-box by the Stream Video SDK). To do this just set `registerApnDeviceToken` to true when initializing `StreamVideo` instance: |
| 74 | + |
| 75 | +```dart |
| 76 | +StreamVideo( |
| 77 | + apiKey, |
| 78 | + user: user, |
| 79 | + pushNotificationManagerProvider: StreamVideoPushNotificationManager.create( |
| 80 | + iosPushProvider: const StreamVideoPushProvider.apn( |
| 81 | + name: 'flutter-apn', |
| 82 | + ), |
| 83 | + androidPushProvider: const StreamVideoPushProvider.firebase( |
| 84 | + name: 'flutter-firebase', |
| 85 | + ), |
| 86 | + pushParams: const StreamVideoPushParams( |
| 87 | + appName: kAppName, |
| 88 | + ios: StreamIOSParams(iconName: 'IconMask'), |
| 89 | + ), |
| 90 | + registerApnDeviceToken: true, // <--- Add this line |
| 91 | + ), |
| 92 | +); |
| 93 | +``` |
| 94 | + |
| 95 | +### Handling standard push notifications |
| 96 | + |
| 97 | +Next, you need to handle the push notifications in your app. |
| 98 | + |
| 99 | +To do this, you need to add the following code to your `AppDelegate.swift` file: |
| 100 | + |
| 101 | +```swift |
| 102 | +@objc class AppDelegate: FlutterAppDelegate { |
| 103 | +override func application( |
| 104 | + _ application: UIApplication, |
| 105 | + didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? |
| 106 | + ) -> Bool { |
| 107 | + GeneratedPluginRegistrant.register(with: self) |
| 108 | + |
| 109 | + // Register for push notifications. |
| 110 | + StreamVideoPKDelegateManager.shared.registerForPushNotifications() // <--- Add will only handle VoIP notifications |
| 111 | + UNUserNotificationCenter.current().delegate = self // <--- Add this line to handle standard push notifications |
| 112 | + |
| 113 | + return super.application(application, didFinishLaunchingWithOptions: launchOptions) |
| 114 | + } |
| 115 | + |
| 116 | +// This method will be called when notification is received |
| 117 | +override func userNotificationCenter(_ center: UNUserNotificationCenter, |
| 118 | + willPresent notification: UNNotification, |
| 119 | + withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) { |
| 120 | + let streamDict = notification.request.content.userInfo["stream"] as? [String: Any] |
| 121 | + if(streamDict?["sender"] as? String != "stream.video") { |
| 122 | + return completionHandler([]) |
| 123 | + } |
| 124 | + |
| 125 | + if #available(iOS 14.0, *) { |
| 126 | + completionHandler([.list, .banner, .sound]) |
| 127 | + } else { |
| 128 | + completionHandler([.alert]) |
| 129 | + } |
| 130 | +} |
| 131 | +} |
| 132 | +``` |
| 133 | + |
| 134 | +If you want to handle the notification tap event, for example to navigate to the call screen when you `notify` about it, you can add the following code to your `AppDelegate.swift` file: |
| 135 | + |
| 136 | +```swift |
| 137 | +// This method will be called when notification is tapped |
| 138 | +override func userNotificationCenter(_ center: UNUserNotificationCenter, |
| 139 | + didReceive response: UNNotificationResponse, |
| 140 | + withCompletionHandler completionHandler: @escaping () -> Void) { |
| 141 | + |
| 142 | + let streamDict = response.notification.request.content.userInfo["stream"] as? [String: Any] |
| 143 | + if(streamDict?["sender"] as? String != "stream.video") { |
| 144 | + return; |
| 145 | + } |
| 146 | + |
| 147 | + if(streamDict?["type"] as? String == "call.notification") { |
| 148 | + let callCid = streamDict?["call_cid"] as? String |
| 149 | + print("Call notification received with call cid: \(callCid)") |
| 150 | + //Navigate to call, for example implementing method channel |
| 151 | + } |
| 152 | + |
| 153 | + completionHandler() |
| 154 | +} |
| 155 | +``` |
| 156 | + |
| 157 | +### Push notification permission |
| 158 | + |
| 159 | +Remember, that in order to receive push notifications, you need to ask the user for relevant permission. One way of doing it is using [permission_handler](https://pub.dev/packages/permission_handler) plugin. |
| 160 | + |
| 161 | +```dart |
| 162 | +Permission.notification.request(); |
| 163 | +``` |
0 commit comments