gpg::MessageListenerHelper

#include <message_listener_helper.h>

定義可用來向 SDK 提供 IMessageListener 回呼的輔助程式，但不需定義完整的 IMessageListener 介面。

摘要

系統會叫用針對這個物件設定的回呼，如鄰近連線 API 所述。未明確設定的回呼不會執行任何動作。

建構函式和解構函式
MessageListenerHelper()
MessageListenerHelper(std::shared_ptr< MessageListenerHelperImpl > impl)
將 MessageListenerHelper 從 shared_ptr 建構至 MessageListenerHelperImpl。

公開類型
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。

公開函式
SetOnDisconnectedCallback(OnDisconnectedCallback callback)
設定 OnConnectededCallback。
SetOnMessageReceivedCallback(OnMessageReceivedCallback callback)
設定 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()

MessageListenerHelper

 MessageListenerHelper(
  std::shared_ptr< MessageListenerHelperImpl > impl
)

將 MessageListenerHelper 從 shared_ptr 建構至 MessageListenerHelperImpl。

適用於 API 的內部使用。

SetOnDisconnectedCallback

MessageListenerHelper & SetOnDisconnectedCallback(
  OnDisconnectedCallback callback
)

設定 OnConnectededCallback。

SetOnMessageReceivedCallback

MessageListenerHelper & SetOnMessageReceivedCallback(
  OnMessageReceivedCallback callback
)

設定 OnMessageReceivedCallback。