Nhận thông báo trên ứng dụng C++

Để nhận các thông báo đơn giản truyền từ máy chủ xuống, mỗi ứng dụng khách cần triển khai các phương thức trên API firebase::messaging::Listener.

Khởi chạy FCM

Trước khi bạn có thể dùng FCM để truy cập vào mã thông báo đăng ký hoặc nhận thông báo, bạn phải khởi chạy mã thông báo đó.

Để khởi chạy FCM, hãy gọi ::firebase::messaging::Initialize và cung cấp cho đối tượng ::firebase::App cũng như một phương thức triển khai của lớp ::firebase::messaging::Listener.

MyListener my_listener_implementation;
::firebase::messaging::Initialize(app, &my_listener_implementation);

Truy cập vào mã thông báo đăng ký

Khi khởi động ứng dụng lần đầu, SDK FCM sẽ tạo mã thông báo đăng ký cho phiên bản ứng dụng khách. Nếu muốn nhắm đến các thiết bị riêng lẻ hoặc tạo nhóm thiết bị cho FCM, bạn sẽ cần truy cập vào mã thông báo này.

Bạn có thể truy cập vào giá trị của mã thông báo thông qua hàm ảo ::firebase::messaging::Listener::OnTokenReceived.

void OnTokenReceived(const char* token) {
  LogMessage("The registration token is `%s`", token);

  // TODO: If necessary send token to application server.
}

Nhận và xử lý thông báo

Để nhận tin nhắn, lớp Trình nghe phải triển khai hàm ảo OnMessage.

Ghi đè OnMessage

Bằng cách ghi đè phương thức ::firebase::messaging::Listener::OnMessage, bạn có thể thực hiện các thao tác dựa trên thông báo đã nhận và lấy dữ liệu thông báo:

void OnMessage(const ::firebase::messaging::Message& message) {
  LogMessage(TAG, "From: %s", message.from.c_str());
  LogMessage(TAG, "Message ID: %s", message.message_id.c_str());
}

Thông báo có thể biểu thị nhiều loại dữ liệu đến. Thông thường, các thông báo được gửi đến ứng dụng sau khi nhà phát triển bắt đầu. Các thông báo cũng được gửi đến ứng dụng của bạn để biểu thị các sự kiện đã gửi thông báo, sự kiện lỗi gửi thông báo và sự kiện đã xoá thông báo. Bạn có thể phân biệt các sự kiện đặc biệt này bằng cách kiểm tra trường Message::message_type.

Đã xoá tin nhắn

Được gửi đến ứng dụng của bạn khi máy chủ FCM xoá các tin nhắn đang chờ xử lý. Message::message_type sẽ là "deleted_messages". Tin nhắn có thể bị xoá do:

  1. Có quá nhiều thư được lưu trữ trên máy chủ FCM.

    Điều này có thể xảy ra khi máy chủ của một ứng dụng gửi hàng loạt thông báo không thu gọn đến các máy chủ FCM trong khi thiết bị đang ở chế độ ngoại tuyến.

  2. Thiết bị đã không kết nối trong một thời gian dài và máy chủ ứng dụng gần đây (trong vòng 4 tuần qua) đã gửi một thông báo đến ứng dụng trên thiết bị đó.

    Bạn nên để ứng dụng đồng bộ hoá hoàn toàn với máy chủ ứng dụng sau khi nhận được lệnh gọi này.