メッセージ¶
Hive チャット機能は、ユーザーが参加しているチャンネルにメッセージを送信するためのチャンネルメッセージ送信と、特定の個人に直接メッセージを送信するための1:1メッセージ送信をサポートしています。
チャンネルメッセージ送信¶
ユーザーが参加しているチャンネルにメッセージを送信するには、ChannelSendMessageParams
オブジェクトを作成し、それをChatクラスのsendMessage()
メソッドに引数として渡して呼び出します。
チャンネル送信メッセージパラメータ¶
フィールド名 | 説明 | タイプ | 必須 |
---|---|---|---|
channelId | チャンネルメッセージを送信するためのチャンネルID | string | Y |
message | チャンネルに送信するメッセージ (最大200文字) | string | Y |
これは、ユーザーが参加しているチャンネルにメッセージを送信する例のコードです。
#include "HiveChat.h"
FHiveChatChannelSendMessageParams ChannelSendMessageParams;
ChannelSendMessageParams.ChannelId = TEXT("CHANNEL_ID");
ChannelSendMessageParams.Message = TEXT("こんにちはハイブ");
FHiveChat::SendMessageWithChannelSendMessageParams(ChannelSendMessageParams, FHiveChatOnResultDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
if (Result.IsSuccess) {
// API Call Success
}
}));
チャンネルメッセージイベント管理¶
送信されたメッセージは、addChannelListener
イベントのonChannelMessage
イベントハンドラーによって受信されることができます。イベント処理の詳細については、イベント管理 > チャンネルイベントドキュメントを参照してください。
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("こんにちはハイブ");
FHiveChat::SendMessageWithDirectSendMessageParams(DirectSendMessageParams, FHiveChatOnResultDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
if (Result.IsSuccess) {
// API Call Success
}
}));
1:1 メッセージイベント管理¶
1:1メッセージ送信を通じて送信されたメッセージは、addDirectMessageListener
イベントハンドラーのonDirectMessage
イベントを介して受信できます。詳細なイベント処理メソッドについては、イベント管理 > 1:1メッセージイベントドキュメントを参照してください。