chat_manager::add_remote_user
ローカル chat_manager インスタンスにリモート ユーザーを追加します。構文
パラメーター
xboxUserId _In_型: PCWSTR 追加するリモート ユーザーの XBOX ユーザー ID。 locallyUniqueEndpointIdentifier _In_
型: uint64_t リモート ユーザーがいるエンドポイントを参照するためにタイトルによって生成される識別子。エンドポイントとは、XBOX One や PC などのデバイスのことです。各エンドポイントは、Game Chat のローカル インスタンス内で一意の識別子を持つ必要があります。識別子はネットワーク全体でグローバルに一意である必要はありません。同じ XBOX One 上で 2 人のユーザーがプレイしている場合など、同じエンドポイント上のリモート ユーザーは、同じエンドポイント識別子で追加する必要があります。Game Chat は、この識別子を使用して game_chat_data_frame 構造体内でどのエンドポイントにデータを送信する必要があるかを示し、また、chat_manager::process_incoming_data() の中でデータがどのエンドポイントから来たかを示すためにタイトルで使用する必要があります。
戻り値
型: chat_user*解説
ローカルおよびリモート ユーザーの合計数が chat_manager::initialize() で指定された最大ユーザー数と等しくない限り、ユーザーは無条件に追加されます。戻り値は、このユーザーに関連付けられた chat_user オブジェクトへのポインターです。XBOX ユーザー ID が無効な場合、ユーザーの chat_indicator 値は game_chat_user_chat_indicator::platform_restricted になります。
要件
ヘッダー: GameChat2.h サポートされるプラットフォーム: Windows、XBOX One ファミリ本体および XBOX Series 本体関連項目
chat_managerchat_user
chat_manager::add_remote_user
chat_manager::remove_user
chat_manager::process_incoming_data
game_chat_data_frame