Skip to main content

XblMultiplayerSessionMember

Representa uma referência somente leitura a um membro de uma sessão multijogador.

Sintaxe

Membros

MemberId
Tipo: uint32_t
ID deste membro. Exclusiva no contexto da sessão da qual este membro faz parte. TeamId
Tipo: const char*
ID da equipe deste membro em um torneio. PRETERIDO. Será removido em uma versão futura InitialTeam
Tipo: const char*
Atribuição de equipe inicial do SmartMatch. ArbitrationStatus
Tipo: XblTournamentArbitrationStatus
Status de arbitragem de um membro em um torneio. PRETERIDO. Será removido em uma versão futura Xuid
Tipo: uint64_t
ID de usuário do XBOX do membro. Conhecida somente se o membro tiver aceitado. CustomConstantsJson
Tipo: const char*
Cadeia de caracteres JSON que especifica as constantes personalizadas do membro. SecureDeviceBaseAddress64
Tipo: const char*
O endereço de dispositivo seguro do membro, codificado em base64. (Opcional) Roles
Tipo: const XblMultiplayerSessionMemberRole*
Uma matriz de funções para este membro. (Opcional) RolesCount
Tipo: size_t
Número de entradas na matriz Roles. CustomPropertiesJson
Tipo: const char*
Cadeia de caracteres JSON que especifica as propriedades personalizadas do membro. Gamertag
Tipo: char[XBL_GAMERTAG_CHAR_SIZE]
O gamertag do membro. (Opcional) Conhecido somente se o membro tiver aceitado. Status
Tipo: XblMultiplayerSessionMemberStatus
O status deste membro. IsTurnAvailable
Tipo: bool
True somente se este membro estiver pronto para o turno. IsCurrentUser
Tipo: bool
Indica se este MultiplayerSessionMember é do usuário atual. InitializeRequested
Tipo: bool
Indica que a inicialização de QoS deve ser executada para este usuário. O padrão é false. Ignorado se não houver uma seção “memberInitialization” para a sessão. MatchmakingResultServerMeasurementsJson
Tipo: const char*
Quando o match adiciona um usuário a uma sessão, ele pode fornecer algum contexto sobre como e por que o usuário foi combinado na sessão. Esta é uma cópia das serverMeasurements do usuário provenientes da sessão de matchmaking. ServerMeasurementsJson
Tipo: const char*
Medições de QoS por cadeia de conexão do servidor de jogo. Como todos os campos, “serverMeasurements” deve ser atualizado como um todo, portanto, deve ser definido uma vez quando a medição for concluída. Se estiver vazio, significa que nenhuma das medições foi concluída dentro do “serverMeasurementTimeout”. MembersInGroupIds
Tipo: const uint32_t*
Uma coleção de memberIds no meu grupo. Se uma lista “initializationGroup” estiver definida, o próprio índice do membro sempre será adicionado, caso ainda não esteja presente. Durante a inicialização gerenciada, se algum membro da lista falhar, este membro também falhará. MembersInGroupCount
Tipo: size_t
O número de entradas na matriz MembersInGroupIds. QosMeasurementsJson
Tipo: const char*
Medições de QoS por endereço de dispositivo seguro. Como todos os campos, “measurements” deve ser atualizado como um todo. Ele deve ser definido uma vez quando a medição for concluída, não de forma incremental. Se um objeto “measurements” estiver definido, ele não poderá conter uma entrada para o próprio endereço do membro. DeviceToken
Tipo: XblDeviceToken
Definido quando o membro carrega um endereço de dispositivo seguro. É uma cadeia de caracteres que não diferencia maiúsculas de minúsculas e pode ser usada em comparações de igualdade. Nat
Tipo: XblNetworkAddressTranslationSetting
Esta é a configuração de NAT do dispositivo quando o membro carrega um endereço de dispositivo seguro. ActiveTitleId
Tipo: uint32_t
Se o membro estiver ativo, esta é a ID do título no qual ele está ativo. InitializationEpisode
Tipo: uint32_t
Esse valor só é útil para leitura quando o título está gerenciando manualmente sua própria QoS. Se a seção “memberInitialization” estiver definida e o membro tiver sido adicionado com “initialize”:true, este valor será definido como o episódio de inicialização do qual o membro participará; caso contrário, será 0. Os usuários ingressam nas sessões em lotes. O número do episódio de inicialização indica um conjunto de usuários em relação aos quais a QoS precisa ser executada. O episódio de inicialização 1 é um valor especial usado para os membros adicionados a uma nova sessão no momento da criação. JoinTime
Tipo: time_t
A hora em que o usuário ingressou na sessão. Se “reserved” for true, esta é a hora em que a reserva foi feita. InitializationFailureCause
Tipo: XblMultiplayerMeasurementFailure
A causa da falha da inicialização, ou XblMultiplayerMeasurementFailure::None se não houve falha. Definido ao sair do estágio “joining” ou “measuring” se este membro não for aprovado. Groups
Tipo: const char**
Uma matriz de nomes de grupos do usuário atual que indica de quais grupos esse usuário fez parte durante uma sessão multijogador. GroupsCount
Tipo: size_t
O número de itens na matriz Groups. Encounters
Tipo: const char**
Obtém uma lista de nomes de grupos do usuário atual que indica quais grupos esse usuário encontrou durante uma sessão multijogador. EncountersCount
Tipo: size_t
O número de itens na matriz Groups. TournamentTeamSessionReference
Tipo: XblMultiplayerSessionReference
A referência da sessão da equipe do torneio. PRETERIDO. Será removido em uma versão futura Internal
Tipo: void*
Somente para uso interno.

Requisitos

Cabeçalho: multiplayer_c.h

Confira também

multiplayer_c
Last modified on October 6, 2026