Nhận tin nhắn trong ứng dụng Apple

Sau khi ứng dụng khách của bạn được cài đặt trên thiết bị, ứng dụng đó có thể nhận tin nhắn thông qua giao diện FCM APN. Bạn có thể bắt đầu ngay lập tức gửi thông báo đến các phân khúc người dùng bằng trình tổng hợp Thông báo hoặc thông báo được tạo trên máy chủ ứng dụng của bạn.

Xử lý thông báo cảnh báo

FCM gửi tất cả các thông báo nhắm mục tiêu đến các ứng dụng của Apple thông qua APN. Để tìm hiểu thêm về cách nhận thông báo APN qua UNUserNotificationCenter, hãy xem tài liệu của Apple về Xử lý thông báo và Hành động liên quan đến thông báo .

Bạn phải đặt ủy quyền UNUserNotificationCenter và triển khai các phương pháp ủy quyền thích hợp để nhận thông báo hiển thị từ FCM.

Nhanh

@available(iOS 10, *)
extension AppDelegate: UNUserNotificationCenterDelegate {
  // Receive displayed notifications for iOS 10 devices.
  func userNotificationCenter(_ center: UNUserNotificationCenter,
                              willPresent notification: UNNotification,
                              withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions)
                                -> Void) {
    let userInfo = notification.request.content.userInfo

    // With swizzling disabled you must let Messaging know about the message, for Analytics
    // Messaging.messaging().appDidReceiveMessage(userInfo)

    // ...

    // Print full message.
    print(userInfo)

    // Change this to your preferred presentation option
    completionHandler([[.alert, .sound]])
  }

  func userNotificationCenter(_ center: UNUserNotificationCenter,
                              didReceive response: UNNotificationResponse,
                              withCompletionHandler completionHandler: @escaping () -> Void) {
    let userInfo = response.notification.request.content.userInfo

    // ...

    // With swizzling disabled you must let Messaging know about the message, for Analytics
    // Messaging.messaging().appDidReceiveMessage(userInfo)

    // Print full message.
    print(userInfo)

    completionHandler()
  }
}

Objective-C

// Receive displayed notifications for iOS 10 devices.
// Handle incoming notification messages while app is in the foreground.
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
       willPresentNotification:(UNNotification *)notification
         withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
  NSDictionary *userInfo = notification.request.content.userInfo;

  // With swizzling disabled you must let Messaging know about the message, for Analytics
  // [[FIRMessaging messaging] appDidReceiveMessage:userInfo];

  // ...

  // Print full message.
  NSLog(@"%@", userInfo);

  // Change this to your preferred presentation option
  completionHandler(UNNotificationPresentationOptionBadge | UNNotificationPresentationOptionAlert);
}

// Handle notification messages after display notification is tapped by the user.
- (void)userNotificationCenter:(UNUserNotificationCenter *)center
didReceiveNotificationResponse:(UNNotificationResponse *)response
         withCompletionHandler:(void(^)(void))completionHandler {
  NSDictionary *userInfo = response.notification.request.content.userInfo;
  if (userInfo[kGCMMessageIDKey]) {
    NSLog(@"Message ID: %@", userInfo[kGCMMessageIDKey]);
  }

  // With swizzling disabled you must let Messaging know about the message, for Analytics
  // [[FIRMessaging messaging] appDidReceiveMessage:userInfo];

  // Print full message.
  NSLog(@"%@", userInfo);

  completionHandler();
}

Nếu bạn muốn thêm hành động tùy chỉnh vào thông báo của mình, hãy đặt thông số click_action trong tải thông báo . Sử dụng giá trị mà bạn sẽ sử dụng cho khóa category trong trọng tải APN. Các hành động tùy chỉnh phải được đăng ký trước khi chúng có thể được sử dụng. Để biết thêm thông tin, hãy xem Hướng dẫn lập trình thông báo cục bộ và từ xa của Apple.

Để biết thông tin chi tiết về việc gửi tin nhắn tới ứng dụng của bạn, hãy xem trang tổng quan báo cáo FCM , ghi lại số lượng tin nhắn được gửi và mở trên các thiết bị Apple và Android, cùng với dữ liệu về "số lần hiển thị" (thông báo mà người dùng nhìn thấy) cho các ứng dụng Android.

Xử lý thông báo đẩy im lặng

Khi gửi tin nhắn bằng khóa content_available (tương đương với content-available của APN, tin nhắn sẽ được gửi dưới dạng thông báo im lặng, đánh thức ứng dụng của bạn trong nền cho các tác vụ như làm mới dữ liệu nền. Không giống như thông báo nền trước, các thông báo này phải được xử lý qua application(_:didReceiveRemoteNotification:fetchCompletionHandler:) phương thức.

Triển khai application(_:didReceiveRemoteNotification:fetchCompletionHandler:) như được hiển thị:

Nhanh

func application(_ application: UIApplication,
                 didReceiveRemoteNotification userInfo: [AnyHashable: Any],
                 fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult)
                   -> Void) {
  // If you are receiving a notification message while your app is in the background,
  // this callback will not be fired till the user taps on the notification launching the application.
  // TODO: Handle data of notification

  // With swizzling disabled you must let Messaging know about the message, for Analytics
  // Messaging.messaging().appDidReceiveMessage(userInfo)

  // Print message ID.
  if let messageID = userInfo[gcmMessageIDKey] {
    print("Message ID: \(messageID)")
  }

  // Print full message.
  print(userInfo)

  completionHandler(UIBackgroundFetchResult.newData)
}

Objective-C

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo
    fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
  // If you are receiving a notification message while your app is in the background,
  // this callback will not be fired till the user taps on the notification launching the application.
  // TODO: Handle data of notification

  // With swizzling disabled you must let Messaging know about the message, for Analytics
  // [[FIRMessaging messaging] appDidReceiveMessage:userInfo];

  // ...

  // Print full message.
  NSLog(@"%@", userInfo);

  completionHandler(UIBackgroundFetchResultNewData);
}

Các nền tảng của Apple không đảm bảo cung cấp các thông báo nền. Để tìm hiểu về các điều kiện có thể khiến thông báo nền không thành công, hãy xem tài liệu của Apple về Đẩy cập nhật nền cho ứng dụng của bạn .

Diễn giải thông báo thông báo trọng tải

Khối lượng của các tin nhắn thông báo là một từ điển của các khóa và giá trị. Tin nhắn thông báo được gửi qua APN tuân theo định dạng tải trọng APN như sau:

  {
    "aps" : {
      "alert" : {
        "body" : "great match!",
        "title" : "Portugal vs. Denmark",
      },
      "badge" : 1,
    },
    "customKey" : "customValue"
  }

Xử lý tin nhắn với phương pháp swizzling bị vô hiệu hóa

Theo mặc định, nếu bạn chỉ định lớp đại biểu ứng dụng của mình cho thuộc tính đại biểu UNUserNotificationCenterMessaging , FCM sẽ thay đổi lớp đại biểu ứng dụng của bạn để tự động liên kết mã thông báo FCM của bạn với mã thông báo APN của thiết bị và chuyển các sự kiện nhận được thông báo đến Analytics. Nếu bạn vô hiệu hóa phương thức swizzling một cách rõ ràng hoặc sử dụng một lớp riêng biệt cho một trong hai đại biểu, bạn sẽ cần thực hiện cả hai tác vụ này theo cách thủ công.

Để liên kết mã thông báo FCM với mã thông báo APN của thiết bị, hãy chuyển mã thông báo APN vào lớp Messaging trong trình xử lý làm mới mã thông báo của đại biểu ứng dụng của bạn thông qua thuộc tính apnsToken .

Nhanh

func application(_ application: UIApplication,
    didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
  Messaging.messaging().apnsToken = deviceToken;
}
 

Objective-C

- (void)application:(UIApplication *)application
    didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
  [FIRMessaging messaging].APNSToken = deviceToken;
}

Để chuyển thông tin nhận thông báo đến Analytics, hãy sử dụng phương thức appDidReceiveMessage(_:) .

Nhanh

func userNotificationCenter(_ center: UNUserNotificationCenter,
                            willPresent notification: UNNotification,
  withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
  let userInfo = notification.request.content.userInfo

  Messaging.messaging().appDidReceiveMessage(userInfo)

  // Change this to your preferred presentation option
  completionHandler([[.alert, .sound]])
}

func userNotificationCenter(_ center: UNUserNotificationCenter,
                            didReceive response: UNNotificationResponse,
                            withCompletionHandler completionHandler: @escaping () -> Void) {
  let userInfo = response.notification.request.content.userInfo

  Messaging.messaging().appDidReceiveMessage(userInfo)

  completionHandler()
}

func application(_ application: UIApplication,
didReceiveRemoteNotification userInfo: [AnyHashable : Any],
   fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
  Messaging.messaging().appDidReceiveMessage(userInfo)
  completionHandler(.noData)
}

Objective-C

- (void)userNotificationCenter:(UNUserNotificationCenter *)center
       willPresentNotification:(UNNotification *)notification
         withCompletionHandler:(void (^)(UNNotificationPresentationOptions))completionHandler {
  NSDictionary *userInfo = notification.request.content.userInfo;

  [[FIRMessaging messaging] appDidReceiveMessage:userInfo];

  // Change this to your preferred presentation option
  completionHandler(UNNotificationPresentationOptionBadge | UNNotificationPresentationOptionAlert);
}

- (void)userNotificationCenter:(UNUserNotificationCenter *)center
didReceiveNotificationResponse:(UNNotificationResponse *)response
         withCompletionHandler:(void(^)(void))completionHandler {
  NSDictionary *userInfo = response.notification.request.content.userInfo;

  [[FIRMessaging messaging] appDidReceiveMessage:userInfo];

  completionHandler();
}

- (void)application:(UIApplication *)application
didReceiveRemoteNotification:(NSDictionary *)userInfo
fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler {
  [[FIRMessaging messaging] appDidReceiveMessage:userInfo];
  completionHandler(UIBackgroundFetchResultNoData);
}