Skip to main content

game_chat_transcribed_chat_received_state_change

game_chat_state_change_type::transcribed_chat_received 状態変更に固有の情報を表します。

構文

メンバー

speaker  
Type: 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
speaker オブジェクトに関連付けられたユーザーのオーディオを文字起こしすることで生成されたテキスト文字列へのポインター。文字列は、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::transcribed_chat_received 状態変更に関する追加情報を提供します。この状態変更は、リモート プレイヤーの音声コミュニケーションが文字起こしされ、1 人以上のローカル ユーザーに表示する必要があるときに発生します。 この状態変更が発生すると、この構造体は、アプリが 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 メンバー
最終更新日 2026年8月24日