使用OneSignal 3.3.0实现Android/iOS通知弹窗的方案咨询

问题背景 #

当前使用OneSignal 3.3.0版本，仅能收到提醒样式通知，无弹窗效果，2.x版本的解决方案已不适用，需针对3.x版本配置实现弹窗式通知（示例样式：）

Android 端实现步骤 #

1. 配置通知权限与高优先级渠道

   • 在AndroidManifest.xml中添加Android 13+必填的通知权限：

     <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
     

   • 初始化OneSignal后创建高优先级渠道（Android 8.0+要求通过渠道控制通知行为）：

     import OneSignal from 'react-native-onesignal';
     
     // 初始化
     OneSignal.setAppId('你的AppKey');
     // 创建弹窗专用高优先级渠道
     OneSignal.createNotificationChannel({
       id: 'popup_notification_channel',
       name: '弹窗通知渠道',
       importance: 4, // 对应Android的IMPORTANCE_HIGH，强制触发弹窗
       description: '用于展示弹窗式通知',
       sound: 'default',
     });
     

2. 前台通知处理

   • 覆盖前台通知默认静默行为，确保弹窗正常展示：

     OneSignal.setNotificationWillShowInForegroundHandler(notificationReceivedEvent => {
       const notification = notificationReceivedEvent.getNotification();
       // 直接完成处理，保留通知的弹窗样式
       notificationReceivedEvent.complete(notification);
     });
     

iOS 端实现步骤 #

1. 申请通知权限

   • 在Info.plist中添加权限说明文案：

     <key>NSUserNotificationUsageDescription</key>
     <string>需要向您发送重要通知</string>
     <key>NSAlertUsageDescription</key>
     <string>需要展示通知弹窗</string>
     

   • 初始化时主动申请包含弹窗权限的推送权限：

     import OneSignal from 'react-native-onesignal';
     
     OneSignal.setAppId('你的AppKey');
     // 触发系统权限弹窗，申请推送权限
     OneSignal.promptForPushNotificationsWithUserResponse(accepted => {
       console.log('用户是否允许通知:', accepted);
     });
     

2. 前台弹窗配置

   • 强制前台通知以弹窗样式展示：

     OneSignal.setNotificationWillShowInForegroundHandler(notificationReceivedEvent => {
       const notification = notificationReceivedEvent.getNotification();
       // 设置通知展示类型为弹窗
       notification.displayType = 1;
       notificationReceivedEvent.complete(notification);
     });
     

控制台推送补充配置 #

在OneSignal后台发送通知时：

• Android端需选择上述创建的高优先级渠道
• iOS端需选择Alert类型通知，可按需开启Sound和Badge选项

内容的提问来源于stack exchange，提问作者Vaibhav Shah