Nhận thông báo bằng Giải pháp gửi thông báo qua đám mây của Firebase

Hướng dẫn này mô tả cách thiết lập Firebase Cloud Messaging trong ứng dụng di động và ứng dụng web để bạn có thể nhận tin nhắn một cách đáng tin cậy.

Để nhận được thông báo truyền 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ể sử dụng FCM để truy cập vào mã thông báo đăng ký hoặc nhận tin nhắn, 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 của bạn 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ể đại diện cho 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. 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 một loạt thông báo không thu gọn đến máy chủ FCM trong khi thiết bị đang ở trạng thái ngoại tuyến.

  2. Thiết bị đã không kết nối trong một thời gian dài và gần đây (trong vòng 4 tuần qua), máy chủ ứng dụng đã 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.