Wix React Native Notifications 本地通知功能详解

Wix React Native Notifications 本地通知功能详解

react-native-notifications React Native Notifications 项目地址: https://gitcode.com/gh_mirrors/re/react-native-notifications

什么是本地通知

本地通知(Local Notifications)是指由应用程序自身触发并显示在设备通知中心的消息提醒，与远程推送通知不同，它不需要通过服务器发送。Wix React Native Notifications库提供了跨平台的本地通知实现方案。

iOS平台实现

基本使用

在iOS平台上，可以通过postLocalNotification方法触发本地通知，支持立即显示或定时显示：

let localNotification = Notifications.postLocalNotification({
  body: "本地通知内容",
  title: "通知标题",
  sound: "chime.aiff",  // 可选，使用应用内的音频文件
  silent: false,       // 是否静音
  category: "消息分类",  // 用于交互式通知
  userInfo: { key: "value" }, // 附加数据
  fireDate: new Date(), // 触发时间，不设置则立即显示
});

通知对象属性详解

• fireDate: 设置通知触发时间，不设置则立即显示
• body: 通知主体内容
• title: 通知标题
• alertAction: 锁屏界面显示的操作提示(如"滑动解锁")
• sound: 通知音效文件(需包含在应用包内)
• silent: 是否静音
• category: 通知分类，用于交互式通知
• userInfo: 附加的自定义数据

取消通知

1. 取消单个预定通知

// 保存通知ID
const notificationId = Notifications.postLocalNotification({...});

// 取消特定通知
Notifications.cancelLocalNotification(notificationId);

2. 取消所有本地通知(iOS专有)

Notifications.ios.cancelAllLocalNotifications();

3. 移除已显示的通知(iOS 10+)

// 移除特定已显示通知
Notifications.ios.removeDeliveredNotifications([notificationId]);

// 移除所有已显示通知(包括推送通知)
Notifications.ios.removeAllDeliveredNotifications();

Android平台实现

Android平台的实现更为简洁，目前不支持定时通知：

Notifications.postLocalNotification({
  title: "本地通知标题",
  body: "这是由应用生成的通知内容",
  extra: "附加数据"  // 会随通知一起传递
});

注意事项

1. Android平台暂不支持定时通知功能
2. 通知点击后，所有数据字段会原样传递给应用
3. 音效和图标等需要按照Android规范进行配置

最佳实践

1. 用户权限：确保在iOS上已请求通知权限
2. 测试不同场景：测试应用在前台、后台和关闭状态下的通知表现
3. 数据传递：合理使用userInfo传递必要数据
4. 错误处理：对可能出现的异常情况进行处理
5. 平台差异：注意iOS和Android在通知表现上的差异

通过Wix React Native Notifications库，开发者可以方便地实现跨平台的本地通知功能，为用户提供及时的消息提醒体验。

react-native-notifications React Native Notifications 项目地址: https://gitcode.com/gh_mirrors/re/react-native-notifications