🗑️ PushNotificationIOS

已弃用

请改用社区包之一。

仅限原生代码的项目

以下部分仅适用于公开了原生代码的项目。如果您使用的是托管的 Expo 工作流程，请参阅 Expo 文档中关于通知的指南，以获取适当的替代方案。

处理应用的通知，包括调度和权限。

---

入门

要启用推送通知，请使用 Apple 和您的服务器端系统配置通知。

然后，在您的项目中启用远程通知。这将自动启用所需的设置。

启用对 register 事件的支持

在您的 AppDelegate.m 中，添加

objectivec

#import <React/RCTPushNotificationManager.h>

然后实现以下内容以处理远程通知注册事件

objectivec

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
 // This will trigger 'register' events on PushNotificationIOS
 [RCTPushNotificationManager didRegisterForRemoteNotificationsWithDeviceToken:deviceToken];
}
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error
{
 // This will trigger 'registrationError' events on PushNotificationIOS
 [RCTPushNotificationManager didFailToRegisterForRemoteNotificationsWithError:error];
}

处理通知

您需要在 AppDelegate 中实现 UNUserNotificationCenterDelegate

objectivec

#import <UserNotifications/UserNotifications.h>

@interface YourAppDelegate () <UNUserNotificationCenterDelegate>
@end

在应用启动时设置代理

objectivec

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  ...
  UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
  center.delegate = self;

  return YES;
}

前台通知

实现 userNotificationCenter:willPresentNotification:withCompletionHandler: 以处理应用在前台时收到的通知。使用 completionHandler 确定是否向用户显示通知，并相应地通知 RCTPushNotificationManager

objectivec

// Called when a notification is delivered to a foreground app.
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
       willPresentNotification:(UNNotification *)notification
         withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler
{
  // This will trigger 'notification' and 'localNotification' events on PushNotificationIOS
  [RCTPushNotificationManager didReceiveNotification:notification];
  // Decide if and how the notification will be shown to the user
  completionHandler(UNNotificationPresentationOptionNone);
}

后台通知

实现 userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler: 以处理点击通知的情况，通常用于用户点击以打开应用的后台通知。但是，如果您已将前台通知设置为在 userNotificationCenter:willPresentNotification:withCompletionHandler: 中显示，则当点击前台通知时，此方法也将被调用。在这种情况下，您应该只在这些回调中的一个中通知 RCTPushNotificationManager。

如果点击的通知导致应用启动，请调用 setInitialNotification:。如果通知之前未由 userNotificationCenter:willPresentNotification:withCompletionHandler: 处理，也请调用 didReceiveNotification:

objectivec

- (void)  userNotificationCenter:(UNUserNotificationCenter *)center
  didReceiveNotificationResponse:(UNNotificationResponse *)response
           withCompletionHandler:(void (^)(void))completionHandler
{
  // This condition passes if the notification was tapped to launch the app
  if ([response.actionIdentifier isEqualToString:UNNotificationDefaultActionIdentifier]) {
    // Allow the notification to be retrieved on the JS side using getInitialNotification()
    [RCTPushNotificationManager setInitialNotification:response.notification];
  }
  // This will trigger 'notification' and 'localNotification' events on PushNotificationIOS
  [RCTPushNotificationManager didReceiveNotification:response.notification];
  completionHandler();
}

---

参考

方法

presentLocalNotification()

tsx

static presentLocalNotification(details: PresentLocalNotificationDetails);

调度本地通知以立即呈现。

参数

姓名	类型	必需	描述
详情	对象	是	见下文。

details 是一个包含以下内容的对象

• alertTitle：显示为通知警报标题的文本。
• alertBody：通知警报中显示的消息。
• userInfo：包含附加通知数据的对象（可选）。
• category：此通知的类别，对于可操作通知是必需的（可选）。例如，带有“回复”或“赞”等附加操作的通知。
• applicationIconBadgeNumber 要显示为应用图标徽章的数字。此属性的默认值为 0，表示不显示徽章（可选）。
• isSilent：如果为 true，通知将无声出现（可选）。
• soundName：通知触发时播放的声音（可选）。
• alertAction：已弃用。这用于 iOS 的旧版 UILocalNotification。

---

scheduleLocalNotification()

tsx

static scheduleLocalNotification(details: ScheduleLocalNotificationDetails);

调度本地通知以供将来呈现。

参数

姓名	类型	必需	描述
详情	对象	是	见下文。

details 是一个包含以下内容的对象

• alertTitle：显示为通知警报标题的文本。
• alertBody：通知警报中显示的消息。
• fireDate：通知何时触发。使用 fireDate 或 fireIntervalSeconds 调度通知，fireDate 优先。
• fireIntervalSeconds：从现在开始显示通知的秒数。
• userInfo：包含附加通知数据的对象（可选）。
• category：此通知的类别，对于可操作通知是必需的（可选）。例如，带有“回复”或“赞”等附加操作的通知。
• applicationIconBadgeNumber 要显示为应用图标徽章的数字。此属性的默认值为 0，表示不显示徽章（可选）。
• isSilent：如果为 true，通知将无声出现（可选）。
• soundName：通知触发时播放的声音（可选）。
• alertAction：已弃用。这用于 iOS 的旧版 UILocalNotification。
• repeatInterval：已弃用。请改用 fireDate 或 fireIntervalSeconds。

---

cancelAllLocalNotifications()

tsx

static cancelAllLocalNotifications();

取消所有已调度的本地通知。

---

removeAllDeliveredNotifications()

tsx

static removeAllDeliveredNotifications();

从通知中心删除所有已送达的通知。

---

getDeliveredNotifications()

tsx

static getDeliveredNotifications(callback: (notifications: Object[]) => void);

提供当前显示在通知中心的应用通知列表。

参数

姓名	类型	必需	描述
callback	函数	是	接收已送达通知数组的函数。

已送达通知是一个包含以下内容的对象

• identifier：此通知的标识符。
• title：此通知的标题。
• body：此通知的正文。
• category：此通知的类别（可选）。
• userInfo：包含附加通知数据的对象（可选）。
• thread-id：此通知的线程标识符，如果有的话。

---

removeDeliveredNotifications()

tsx

static removeDeliveredNotifications(identifiers: string[]);

从通知中心删除指定的通知。

参数

姓名	类型	必需	描述
标识符	数组	是	通知标识符数组。

---

setApplicationIconBadgeNumber()

tsx

static setApplicationIconBadgeNumber(num: number);

设置主屏幕上应用图标的徽章数字。

参数

姓名	类型	必需	描述
数字	数字	是	应用图标的徽章数字。

---

getApplicationIconBadgeNumber()

tsx

static getApplicationIconBadgeNumber(callback: (num: number) => void);

获取主屏幕上应用图标的当前徽章数字。

参数

姓名	类型	必需	描述
callback	函数	是	处理当前徽章数字的函数。

---

cancelLocalNotifications()

tsx

static cancelLocalNotifications(userInfo: Object);

取消与提供的 userInfo 中的字段匹配的任何已调度的本地通知。

参数

姓名	类型	必需	描述
userInfo	对象	否

---

getScheduledLocalNotifications()

tsx

static getScheduledLocalNotifications(
  callback: (notifications: ScheduleLocalNotificationDetails[]) => void,
);

获取当前已调度的本地通知列表。

参数

姓名	类型	必需	描述
callback	函数	是	处理描述本地通知的对象数组的函数。

---

addEventListener()

tsx

static addEventListener(
  type: PushNotificationEventName,
  handler:
    | ((notification: PushNotification) => void)
    | ((deviceToken: string) => void)
    | ((error: {message: string; code: number; details: any}) => void),
);

附加一个监听器到通知事件，包括本地通知、远程通知和通知注册结果。

参数

姓名	类型	必需	描述
类型	字符串	是	要监听的事件类型。见下文。
处理程序	函数	是	监听器。

有效的事件类型包括

• notification：当收到远程通知时触发。处理程序将使用 PushNotificationIOS 实例调用。这将处理在前台收到或点击以从后台打开应用的通知。
• localNotification：当收到本地通知时触发。处理程序将使用 PushNotificationIOS 实例调用。这将处理在前台收到或点击以从后台打开应用的通知。
• register：当用户成功注册远程通知时触发。处理程序将使用表示 deviceToken 的十六进制字符串调用。
• registrationError：当用户未能注册远程通知时触发。通常由于 APNS 问题或设备是模拟器而发生。处理程序将使用 {message: string, code: number, details: any} 调用。

---

removeEventListener()

tsx

static removeEventListener(
  type: PushNotificationEventName,
);

移除事件监听器。请在 componentWillUnmount 中执行此操作以防止内存泄漏。

参数

姓名	类型	必需	描述
类型	字符串	是	事件类型。有关选项，请参阅 addEventListener()。

---

requestPermissions()

tsx

static requestPermissions(permissions?: PushNotificationPermissions[]);

从 iOS 请求通知权限，通过对话框提示用户。默认情况下，这将请求所有通知权限，但您可以选择指定要请求的权限。支持以下权限

• alert
• 徽章
• 声音

如果向方法提供了映射，则只请求具有真值的权限。

此方法返回一个 Promise，该 Promise 在用户接受或拒绝请求时，或者如果权限之前已被拒绝时解析。该 Promise 解析为请求完成后权限的状态。

参数

姓名	类型	必需	描述
权限	数组	否	警报、徽章或声音

---

abandonPermissions()

tsx

static abandonPermissions();

取消注册通过 Apple 推送通知服务接收的所有远程通知。

您只应在极少数情况下调用此方法，例如当应用的新版本取消支持所有类型的远程通知时。用户可以通过“设置”应用暂时阻止应用接收远程通知。通过此方法取消注册的应用可以随时重新注册。

---

checkPermissions()

tsx

static checkPermissions(
  callback: (permissions: PushNotificationPermissions) => void,
);

检查当前已启用哪些推送权限。

参数

姓名	类型	必需	描述
callback	函数	是	见下文。

callback 将使用 permissions 对象调用

• alert: 布尔值
• badge: 布尔值
• sound: 布尔值

---

getInitialNotification()

tsx

static getInitialNotification(): Promise<PushNotification | null>;

此方法返回一个 Promise。如果应用是通过推送通知启动的，则此 Promise 解析为所点击通知的 PushNotificationIOS 类型对象。否则，它解析为 null。

---

getAuthorizationStatus()

tsx

static getAuthorizationStatus(): Promise<number>;

此方法返回一个 Promise，该 Promise 解析为当前的通知授权状态。有关可能的值，请参阅UNAuthorizationStatus。

---

finish()

tsx

finish(result: string);

此方法适用于通过 application:didReceiveRemoteNotification:fetchCompletionHandler: 接收的远程通知。但是，如果同时实现了 application:didReceiveRemoteNotification:fetchCompletionHandler: 和 UNUserNotificationCenterDelegate 中较新的处理程序，则此方法将被 UNUserNotificationCenterDelegate 取代，并且不再被调用。

如果出于某种原因您仍然依赖 application:didReceiveRemoteNotification:fetchCompletionHandler:，则需要在 iOS 端设置事件处理

objectivec

- (void)           application:(UIApplication *)application
  didReceiveRemoteNotification:(NSDictionary *)userInfo
        fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))handler
{
  [RCTPushNotificationManager didReceiveRemoteNotification:userInfo fetchCompletionHandler:handler];
}

在 JS 端处理完通知后，调用 finish() 以执行原生完成处理程序。调用此块时，传入最能描述操作结果的获取结果值。有关可能值的列表，请参阅 PushNotificationIOS.FetchResult。

如果您正在使用 application:didReceiveRemoteNotification:fetchCompletionHandler:，则您_必须_调用此处理程序，并且应尽快执行此操作。有关更多详细信息，请参阅官方文档。

---

getMessage()

tsx

getMessage(): string | Object;

getAlert 的别名，用于获取通知的主消息字符串。

---

getSound()

tsx

getSound(): string;

从 aps 对象获取声音字符串。对于本地通知，这将是 null。

---

getCategory()

tsx

getCategory(): string;

从 aps 对象获取类别字符串。

---

getAlert()

tsx

getAlert(): string | Object;

从 aps 对象获取通知的主消息。另请参阅别名：getMessage()。

---

getContentAvailable()

tsx

getContentAvailable(): number;

从 aps 对象获取 content-available 数字。

---

getBadgeCount()

tsx

getBadgeCount(): number;

从 aps 对象获取徽章计数数字。

---

getData()

tsx

getData(): Object;

获取通知上的数据对象。

---

getThreadID()

tsx

getThreadID();

获取通知上的线程 ID。