一個APP在規劃的時候可能覺得主要功能就只有這一兩個,實作起來應該不難,卻忘了現代人的胃口已經越養越大,很多不在你預期內但對於使用者來說卻是很基本的功能;另一種是商店上架或是第三方要求的必要功能。
如果你還沒有閱讀過「
APP誕生全紀錄」,建議可以先看一下,至少知道哪些可能是容易忽略的必要功能,今天這篇文章內容會比較偏向技術層面,我們先來探討其中重要的一項:
推播〔Push Notification〕。
簡介
推播現在已經是手機中不可或缺的一個功能,無論是用來接收新的通知或是提醒,甚至是開發者想要對使用者傳遞的任何即時消息,都可以使用推播,這是個提升APP存在感並且增加留存率的實用工具。如果你今天開發出一款APP,在某些使用情境下,使用者直覺認為應該要收到提醒推播,但實際卻沒有任何通知跳出的話,那對於APP的留存率可是一大硬傷。今天我們就來介紹一下這個舉足輕重的功能,在Android中叫FCM,在iOS裡叫APNs,這兩個都是遠端推播,另外有一種是本地推播 (補充在最後),以上所有項目在本文章內都統稱推播。
設定
Android
在AndroidManifest.xml中加入service描述(如果使用的Flutter Version >= 1.12可以不用設定這一部分)
<service
android:name=".java.MyFirebaseMessagingService"
android:exported="false">
<intent-filter>
<action android:name="com.google.firebase.MESSAGING_EVENT" />
</intent-filter>
</service>
(Optional) 可選擇自訂的icon和顏色
<meta-data
android:name="com.google.firebase.messaging.default_notification_icon"
android:resource="@drawable/ic_stat_ic_notification" />
<meta-data
android:name="com.google.firebase.messaging.default_notification_color"
android:resource="@color/colorAccent" />
iOS
- 在 Firebase 控制台的項目中,選擇齒輪圖標,選擇Project Settings ,然後選擇Cloud Messaging選項卡。
- 在iOS app configuration下的APNs authentication key中,單擊Upload按鈕。
- 瀏覽到您保存密鑰的位置,選擇它,然後單擊打開。添加密鑰的密鑰 ID,然後單擊Upload 。。
- 在XCode中勾選Push Notification和背景監聽
安裝套件
在Flutter專案的pubspec.yaml中加入
dependencies:
firebase_messaging: ^12.0.2
取得TOKEN
首先在啟動時我們需要先要求權限,並且儲存一下設備的Token,可以把這個token想成是使用者設備的地址,之後後台發送推播就是使用這組地址來發送指定的推播。
class PushNotification {
init() async {
//要求權限
NotificationSettings settings =
await messaging.requestPermission(
alert: true,
announcement: false,
badge: true,
carPlay: false,
criticalAlert: false,
provisional: false,
sound: true,
);
if (settings.authorizationStatus == AuthorizationStatus.authorized ||
settings.authorizationStatus == AuthorizationStatus.provisional) {
//如果權限有被使用者允許,拿一下Token地址吧!
messaging.getToken().then((value) => _token = value);
}
}
}
推播監聽
接下來我們要在啟動時加入各種情境的監聽函式,總共有四種情境要處理。
- 程式在前景模式運作中
- 程式在背景模式
- 程式在背景模式點擊推播打開後
- 程式被關閉的狀態點擊推播打開後
// 背景模式收到推播後的處理函式註冊
// 這裡要注意的是此callback必須是個top-level的static function
FirebaseMessaging.onBackgroundMessage(messageOnBackground);
// 關閉的狀態點擊推播打開後的處理函式註冊
messaging
.getInitialMessage()
.then((message) => messageOpenedOnTerminated(message));
// 前景模式收到推播後的處理函式註冊
FirebaseMessaging.onMessage
.listen((message) => messageOnForeground(message));
// 背景模式中使用者點擊推播後的處理函式註冊
FirebaseMessaging.onMessageOpenedApp
.listen((message) => messageOpenedOnBackground(message));
註冊的callback函式都會傳入一個結構體RemoteMessage,這個就是推播的結構體,我們通常最主要處理的會有title、body、和data。title會是推播顯示中的主標題,body會是推播顯示中的描述文字,而data就會是設計者想要傳遞給使用端的自訂結構。
就是這麼簡單!
最後你只要把收到推播資料的處理寫在對應的callback內就可以囉!
這裡要注意一下前景模式收到推播時,不會再另外跳出預設的通知訊息視窗,如果你想要跟背景模式下收到時一樣會跳出推播的提示視窗,必須另外使用Local Notification來發佈自訂的通知。
進階本地通知
補充說明一下本地通知,在兩種情況下會需要用到。一種是前面提到過的,當收到遠端推播資料時,APP正在前景模式的狀況下,不會跳出推播視窗;另一種是APP內觸發的推播,例如定時鬧鐘。
<meta-data
android:name="com.google.firebase.messaging.default_notification_channel_id"
android:value="bible_seed_channel" />
要使用前初始化一下
final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin =
FlutterLocalNotificationsPlugin();
final AndroidNotificationChannel channel = AndroidNotificationChannel(
'bible_seed_channel', // id
'BibleSeed Notifications', // title
description: 'This channel is used for important notifications.', // description
importance: Importance.max,
);
final InitializationSettings initializationSettings =
InitializationSettings(
android: AndroidInitializationSettings("@mipmap/ic_launcher"),
iOS: IOSInitializationSettings(),
);
await flutterLocalNotificationsPlugin.initialize(initializationSettings);
await flutterLocalNotificationsPlugin
.resolvePlatformSpecificImplementation<
AndroidFlutterLocalNotificationsPlugin>()
?.createNotificationChannel(channel);
//iOS前景顯示選項設定
await FirebaseMessaging.instance
.setForegroundNotificationPresentationOptions(
alert: true,
badge: true,
sound: true,
);
需要推播時呼叫流程如下
final NotificationDetails notificationDetails = NotificationDetails(
android: AndroidNotificationDetails(
'bible_seed_channel', // id
'High Importance Notifications', // name
channelDescription: 'This channel is used for BibleSeed important notifications.',
importance: Importance.max,
priority: Priority.high,
icon: '@mipmap/ic_launcher',
),
iOS: IOSNotificationDetails(),
);
final id = DateTime.now().millisecondsSinceEpoch ~/ 1000;
flutterLocalNotificationsPlugin.show(id, title,
body, notificationDetails);
在這個套件中,還可以設定各種定時的推播,詳細內容就請參閱相關文件囉。
結論
今天我們先介紹了第一種容易被忽略卻非常必要的一個APP功能,不知道你看完後是不是想要立馬加上這功能了呢?!期待後續有機會繼續介紹其他的重要功能,趕緊訂閱一下,不要錯過任何一篇精彩文章囉!!