在 C++ 客户端应用上接收消息

要接收简单的下行消息,每个客户端应用均需要实现 firebase::messaging::Listener API 中的方法。

初始化 FCM

您必须先初始化 FCM,然后才能使用 FCM 获取您的注册令牌或接收消息。

要初始化 FCM,请调用 ::firebase::messaging::Initialize,然后向其提供您的 ::firebase::App 对象并实现 ::firebase::messaging::Listener 类。

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

获取注册令牌

您的应用初次启动时,FCM SDK 会为客户端应用实例生成一个注册令牌。如果您希望为 FCM 定位单一设备或者创建设备组,您将需要获取此令牌。

您可以通过 ::firebase::messaging::Listener::OnTokenReceived 虚函数获取令牌的值。

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

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

接收和处理消息

要接收消息,您的侦听器类必须实现 OnMessage 虚函数。

重写 OnMessage

通过重写 ::firebase::messaging::Listener::OnMessage 方法,您可以根据收到的消息执行操作并获取消息数据:

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());
}

消息可用于表示不同种类的传入数据。在大多数情况下,消息会在开发者发起后发送至应用。此外,您的应用还会收到用于表示消息已发送事件、消息发送错误事件及消息已删除事件的消息。您可以通过检查 Message::message_type 字段来区分这些特殊事件。

消息已删除

当 FCM 服务器删除待处理消息时发送至您的应用。 Message::message_type 将为 "deleted_messages"。删除消息的原因可能是:

  1. FCM 服务器上存储的消息过多。

    如果应用服务器在设备离线时向 FCM 服务器发送大量不可折叠消息,则可能会出现这种情况。

  2. 设备长时间未连接,且应用服务器近期(过去 4 周内)向该设备上的应用发送了一条消息。

    建议在收到此调用后为应用执行与应用服务器的完全同步。

发送事件

当上行消息成功发送至 FCM 连接服务器时调用。Message::message_type 将为 "send_event"

发送错误

当发送上行消息出错时调用。 Message::message_type 将为 "send_error"

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面