chat_manager::add_remote_user
向本地 chat_manager 实例添加远程用户。语法
参数
xboxUserId _In_类型:PCWSTR 要添加的远程用户的 XBOX 用户 ID。 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 用户 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
