使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
gpg::MessageListenerHelper
#include <message_listener_helper.h>
定义了一个帮助程序,可用于向 SDK 提供 IMessageListener 回调,而无需定义完整的 IMessageListener 接口。
摘要
系统会调用在此对象上配置的回调,如 Nearby Connections API 中所述。未明确设置的回调将不执行任何操作。
公共类型
|
OnDisconnectedCallback
|
typedef
std::function< void(int64_t client_id, const std::string &remote_endpoint_id)>
当远程端点断开连接时,系统会调用 OnDisconnectedCallback 。 |
OnMessageReceivedCallback
|
typedef
std::function< void(int64_t client_id, const std::string &remote_endpoint_id, const std::vector< uint8_t > &payload, bool is_reliable)>
当从远程端点收到消息时,系统会调用 OnMessageReceivedCallback 。 |
公共类型
OnDisconnectedCallback
std::function< void(int64_t client_id, const std::string &remote_endpoint_id)> OnDisconnectedCallback
当远程端点断开连接时,系统会调用 OnDisconnectedCallback
。
client_id
是接收断开连接消息的 NearbyConnections 实例的 ID。remote_endpoint_id
是断开连接的远程端点的 ID。
OnMessageReceivedCallback
std::function< void(int64_t client_id, const std::string &remote_endpoint_id, const std::vector< uint8_t > &payload, bool is_reliable)> OnMessageReceivedCallback
当从远程端点收到消息时,系统会调用 OnMessageReceivedCallback
。
client_id
是收到此消息的 NearbyConnections 实例的 ID。remote_endpoint_id
是发送消息的远程端点的 ID。payload
包含消息的字节。如果消息已可靠发送,则 is_reliable
为 true;否则为 false。
公共函数
MessageListenerHelper
MessageListenerHelper()
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-27。
[null,null,["最后更新时间 (UTC):2025-07-27。"],[],[],null,["# gpg::MessageListenerHelper Class Reference\n\ngpg::MessageListenerHelper\n==========================\n\n`#include \u003cmessage_listener_helper.h\u003e`\n\nDefines a helper which can be used to provide [IMessageListener](/games/services/cpp/api/class/gpg/i-message-listener#classgpg_1_1_i_message_listener) callbacks to the SDK without defining the full [IMessageListener](/games/services/cpp/api/class/gpg/i-message-listener#classgpg_1_1_i_message_listener) interface.\n\nSummary\n-------\n\nCallbacks configured on this object will be invoked as described in the nearby connections API. Callbacks not explicitly set will do nothing.\n\n| ### Constructors and Destructors ||\n|---|---|\n| [MessageListenerHelper](#classgpg_1_1_message_listener_helper_1a1a0f7e5058bb0643907a39fa5bd61359)`()` ||\n| [MessageListenerHelper](#classgpg_1_1_message_listener_helper_1ae7d21da925a410f09068f0c662da5b0a)`(std::shared_ptr\u003c `[MessageListenerHelperImpl](/games/services/cpp/api/class/gpg/message-listener-helper#classgpg_1_1_message_listener_helper_1a8a1607bb0294cf8ed5df88cc63637a27)` \u003e impl)` Constructs a [MessageListenerHelper](/games/services/cpp/api/class/gpg/message-listener-helper#classgpg_1_1_message_listener_helper) from a `shared_ptr` to a `MessageListenerHelperImpl`. ||\n\n| ### Public types ||\n|-------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [OnDisconnectedCallback](#classgpg_1_1_message_listener_helper_1a7b743b43edec615e74e557c30854f4b5) | typedef `std::function\u003c void(int64_t client_id, const std::string &remote_endpoint_id)\u003e` `OnDisconnectedCallback` is called when a remote endpoint disconnects. |\n| [OnMessageReceivedCallback](#classgpg_1_1_message_listener_helper_1a5f501c5153160b0be39b1015e4d4f05d) | typedef `std::function\u003c void(int64_t client_id, const std::string &remote_endpoint_id, const std::vector\u003c uint8_t \u003e &payload, bool is_reliable)\u003e` `OnMessageReceivedCallback` is called when a message is received from a remote endpoint. |\n\n| ### Public functions ||\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [SetOnDisconnectedCallback](#classgpg_1_1_message_listener_helper_1abd29867a01f436524bea566327a14671)`(`[OnDisconnectedCallback](/games/services/cpp/api/class/gpg/message-listener-helper#classgpg_1_1_message_listener_helper_1a7b743b43edec615e74e557c30854f4b5)` callback)` | [MessageListenerHelper](/games/services/cpp/api/class/gpg/message-listener-helper#classgpg_1_1_message_listener_helper)` &` Set the OnDisconnectedCallback. |\n| [SetOnMessageReceivedCallback](#classgpg_1_1_message_listener_helper_1a82c81d521883dbe58e6195643a4c7b15)`(`[OnMessageReceivedCallback](/games/services/cpp/api/class/gpg/message-listener-helper#classgpg_1_1_message_listener_helper_1a5f501c5153160b0be39b1015e4d4f05d)` callback)` | [MessageListenerHelper](/games/services/cpp/api/class/gpg/message-listener-helper#classgpg_1_1_message_listener_helper)` &` Set the OnMessageReceivedCallback. |\n\nPublic types\n------------\n\n### OnDisconnectedCallback\n\n```c++\nstd::function\u003c void(int64_t client_id, const std::string &remote_endpoint_id)\u003e OnDisconnectedCallback\n``` \n`OnDisconnectedCallback` is called when a remote endpoint disconnects.\n\n`client_id` is the ID of the [NearbyConnections](/games/services/cpp/api/class/gpg/nearby-connections#classgpg_1_1_nearby_connections) instance that received the disconnect message. `remote_endpoint_id` is the ID of the remote endpoint that disconnected. \n\n### OnMessageReceivedCallback\n\n```c++\nstd::function\u003c void(int64_t client_id, const std::string &remote_endpoint_id, const std::vector\u003c uint8_t \u003e &payload, bool is_reliable)\u003e OnMessageReceivedCallback\n``` \n`OnMessageReceivedCallback` is called when a message is received from a remote endpoint.\n\n`client_id` is the ID of the [NearbyConnections](/games/services/cpp/api/class/gpg/nearby-connections#classgpg_1_1_nearby_connections) instance that received this message. `remote_endpoint_id` is the ID of the remote endpoint that sent the message. `payload` contains the bytes of the message. `is_reliable` is true if the message was sent reliably, false otherwise.\n\nPublic functions\n----------------\n\n### MessageListenerHelper\n\n```c++\n MessageListenerHelper()\n``` \n\n### MessageListenerHelper\n\n```c++\n MessageListenerHelper(\n std::shared_ptr\u003c MessageListenerHelperImpl \u003e impl\n)\n``` \nConstructs a [MessageListenerHelper](/games/services/cpp/api/class/gpg/message-listener-helper#classgpg_1_1_message_listener_helper) from a `shared_ptr` to a `MessageListenerHelperImpl`.\n\nIntended for internal use by the API. \n\n### SetOnDisconnectedCallback\n\n```c++\nMessageListenerHelper & SetOnDisconnectedCallback(\n OnDisconnectedCallback callback\n)\n``` \nSet the OnDisconnectedCallback. \n\n### SetOnMessageReceivedCallback\n\n```c++\nMessageListenerHelper & SetOnMessageReceivedCallback(\n OnMessageReceivedCallback callback\n)\n``` \nSet the OnMessageReceivedCallback."]]