chat_manager::add_remote_user
將遠端使用者新增至本機 chat_manager 執行個體。語法
參數
xboxUserId _In_類型：PCWSTR 要新增之遠端使用者的 XBOX 使用者識別碼。 locallyUniqueEndpointIdentifier _In_
類型：uint64_t 由遊戲產生的識別碼，用來參照遠端使用者所在的端點。端點是一個裝置，例如 XBOX One 或 PC。每個端點在本機 Game Chat 執行個體中都必須具有唯一的識別碼；此識別碼不需要在整個網路中全域唯一。位於同一端點的遠端使用者 (例如在同一部 XBOX One 上遊玩的兩位使用者) 必須以相同的端點識別碼新增。Game Chat 會使用此識別碼在 game_chat_data_frame 結構中指出必須將資料傳送至哪些端點，而遊戲必須在 chat_manager::process_incoming_data() 中使用此識別碼來指出資料來自哪個端點。
傳回值
類型：chat_user*備註
除非本機與遠端使用者的總數等於在 chat_manager::initialize() 中指定的最大使用者數目，否則使用者會無條件新增。傳回值是指向與此使用者相關聯之 chat_user 物件的指標。如果 XBOX 使用者識別碼無效，使用者的 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