game_chat_text_chat_received_state_change
game_chat_state_change_type::text_chat_received 状態変更に固有の情報を表します。構文
メンバー
senderType: chat_user* テキスト メッセージを送信した
chat_user オブジェクトへのポインター。
chat_user オブジェクトのポインターは、chat_manager::remove_user メソッドによってユーザーがローカル chat_manager インスタンスから削除されるまで有効です。
receiver_count Type: uint32_t receivers 内の配列要素の数。 receivers _Field_size_(receiver_count)
Type: chat_user_array テキスト メッセージが宛てられている 1 人以上のローカル宛先プレイヤーへの
chat_user ポインターの配列。
chat_user_array オブジェクトのメモリは、このオブジェクトが chat_manager::finish_processing_state_changes を呼び出して返されるまで有効です。個々の chat_user オブジェクト ポインターは、chat_manager::remove_user メソッドによってユーザーがローカル chat_manager インスタンスから削除されるまで有効です。
message Type: PCWSTR chat_user_local::send_chat_text を呼び出すことで送信されたテキスト文字列へのポインター。文字列は、null 終端文字を除いて最大
c_maxChatTextMessageLength 文字の長さになります。
c_maxChatTextMessageLength は、値が 1023 の constexpr uint16_t です。chat_manager::finish_processing_state_changes を呼び出して返されるまで有効です。アプリは、Game Chat コミュニケーション ポリシー ガイド ドキュメントで説明されている方法および期間でテキストを表示するために、テキストのコピーを作成する必要があります。
解説
この構造体は、Game Chat 2 の game_chat_state_change_type::text_chat_received 状態変更に関する追加情報を提供します。この状態変更は、プレイヤー間のテキスト コミュニケーションが到着したときに発生します。 この状態変更が発生すると、この構造体は、アプリが chat_manager::start_processing_state_changes を呼び出したときに取得される game_chat_state_change_array 配列内の game_chat_state_change 要素として返されます。そのgame_chat_state_change 要素の state_change_type メンバーの値を確認して状態変更の種類を確認した後、その要素をこの構造体にキャストできます。その後、この構造体を使用して状態変更に関する詳細情報を取得し、chat_manager::finish_processing_state_changes を呼び出してアプリから Game Chat 2 に配列が返される前に状態変更を処理できます。
状態変更の処理の詳細については、「Game Chat 2 C++ API の使用」を参照してください。
要件
ヘッダー: GameChat2.h サポートされているプラットフォーム: Windows、XBOX One ファミリ本体および XBOX Series 本体概念ドキュメント
関連項目
Game Chat 2 の概要chat_manager
GameChat2 メンバー