訊息¶
Hive 聊天功能支持 頻道消息發送,以向用戶參與的頻道發送消息,以及 1:1 消息發送,以直接向特定個人發送消息。
頻道消息發送¶
要向用户参与的频道发送消息,请创建一个 ChannelSendMessageParams
对象,然后将其作为参数传递给 Chat 类的 sendMessage()
方法以调用它。
Channelsendmessageparams¶
欄位名稱 | 描述 | 類型 | 必填 |
---|---|---|---|
channelId | 發送頻道訊息的頻道 ID | 字串 | 是 |
message | 要發送到頻道的訊息 (最多 200 個字元) | 字串 | 是 |
這是一段示範代碼,用於向用戶參與的頻道發送消息。
#include "HiveChat.h"
FHiveChatChannelSendMessageParams ChannelSendMessageParams;
ChannelSendMessageParams.ChannelId = TEXT("CHANNEL_ID");
ChannelSendMessageParams.Message = TEXT("你好 Hive");
FHiveChat::SendMessageWithChannelSendMessageParams(ChannelSendMessageParams, FHiveChatOnResultDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
if (Result.IsSuccess) {
// API Call Success
}
}));
頻道消息事件管理¶
發送的消息可以被onChannelMessage
事件處理程序接收,該程序是addChannelListener
事件的一部分。 有關事件處理的更多詳細信息,請參閱事件管理 > 通道事件文檔。
1:1 訊息發送¶
要向特定收件人發送直接消息,用戶創建一個 DirectSendMessageParams
對象,然後將其作為參數傳遞給 Chat 類的 sendMessage()
方法。
直接發送消息參數¶
欄位名稱 | 描述 | 類型 | 必填 |
---|---|---|---|
toPlayerId | 目標用戶的 Hive 玩家 ID | long | Y |
message | 要發送到頻道的消息 (最多 200 個字符) | string | Y |
以下是用戶向特定收件人發送直接消息的示例代碼。
#include "HiveChat.h"
FHiveChatDirectSendMessageParams DirectSendMessageParams = FHiveChatDirectSendMessageParams();
DirectSendMessageParams.ToPlayerId = 12345678l;
DirectSendMessageParams.Message = TEXT("你好 Hive");
FHiveChat::SendMessageWithDirectSendMessageParams(DirectSendMessageParams, FHiveChatOnResultDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
if (Result.IsSuccess) {
// API 呼叫成功
}
}));
1:1 訊息事件管理¶
透過 1:1 訊息傳輸發送的訊息可以通過 addDirectMessageListener
事件處理程序 onDirectMessage
事件接收。詳細的事件處理方法,請參考 事件管理 > 1:1 訊息事件 文件。