Skip to main content

chat_manager::add_remote_user

Adiciona um usuário remoto à instância local de chat_manager.

Sintaxe

Parâmetros

xboxUserId   _In_
Tipo: PCWSTR
A ID de usuário do XBOX do usuário remoto a ser adicionado. locallyUniqueEndpointIdentifier   _In_
Tipo: uint64_t
Um identificador gerado pelo título usado para se referir ao ponto de extremidade em que o usuário remoto está. Um ponto de extremidade é um dispositivo, como um XBOX One ou um PC. Cada ponto de extremidade deve ter um identificador exclusivo na instância local do Game Chat; o identificador não precisa ser globalmente exclusivo na rede. Usuários remotos no mesmo ponto de extremidade, como dois usuários jogando no mesmo XBOX One, devem ser adicionados com o mesmo identificador de ponto de extremidade. O Game Chat usará esse identificador para indicar, na estrutura game_chat_data_frame, para quais pontos de extremidade os dados devem ser enviados, e ele deve ser usado pelo título para indicar, em chat_manager::process_incoming_data(), de qual ponto de extremidade os dados vieram.

Valor retornado

Tipo: chat_user*

Comentários

O usuário será adicionado incondicionalmente, a menos que o número total de usuários locais e remotos seja igual à contagem máxima de usuários indicada em chat_manager::initialize().

O valor retornado é um ponteiro para o objeto chat_user associado a esse usuário. Se a ID de usuário do XBOX for inválida, o valor de chat_indicator do usuário será game_chat_user_chat_indicator::platform_restricted.

Requisitos

Cabeçalho: GameChat2.h Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

chat_manager
chat_user
chat_manager::add_remote_user
chat_manager::remove_user
chat_manager::process_incoming_data
game_chat_data_frame
Last modified on October 6, 2026