Skip to main content

XblMultiplayerSessionMember

Representa una referencia de solo lectura a un miembro de una sesión multijugador.

Sintaxis

Miembros

MemberId
Tipo: uint32_t
Id. de este miembro. Único dentro del contexto de la sesión de la que forma parte este miembro. TeamId
Tipo: const char*
Id. del equipo de este miembro en un torneo. EN DESUSO. Se quitará en una versión futura. InitialTeam
Tipo: const char*
Asignación de equipo inicial de SmartMatch. ArbitrationStatus
Tipo: XblTournamentArbitrationStatus
Estado de arbitraje de un miembro en un torneo. EN DESUSO. Se quitará en una versión futura. Xuid
Tipo: uint64_t
Identificador de usuario de XBOX del miembro. Solo se conoce si el miembro ha aceptado. CustomConstantsJson
Tipo: const char*
Cadena JSON que especifica las constantes personalizadas del miembro. SecureDeviceBaseAddress64
Tipo: const char*
La dirección de dispositivo segura del miembro codificada en base64. (Opcional) Roles
Tipo: const XblMultiplayerSessionMemberRole*
Una matriz de roles de este miembro. (Opcional) RolesCount
Tipo: size_t
Número de entradas de la matriz Roles. CustomPropertiesJson
Tipo: const char*
Cadena JSON que especifica las propiedades personalizadas del miembro. Gamertag
Tipo: char[XBL_GAMERTAG_CHAR_SIZE]
El gamertag del miembro. (Opcional) Solo se conoce si el miembro ha aceptado. Status
Tipo: XblMultiplayerSessionMemberStatus
El estado de este miembro. IsTurnAvailable
Tipo: bool
Solo es true si este miembro está listo para su turno. IsCurrentUser
Tipo: bool
Indica si este MultiplayerSessionMember corresponde al usuario actual. InitializeRequested
Tipo: bool
Indica que se debe ejecutar la inicialización de QoS para este usuario. El valor predeterminado es false. Se omite si no hay una sección “memberInitialization” para la sesión. MatchmakingResultServerMeasurementsJson
Tipo: const char*
Cuando el emparejamiento agrega un usuario a una sesión, puede proporcionar cierto contexto sobre cómo y por qué se le emparejó en la sesión. Se trata de una copia de los serverMeasurements del usuario de la sesión de emparejamiento. ServerMeasurementsJson
Tipo: const char*
Mediciones de QoS por cadena de conexión del servidor de juego. Como todos los campos, “serverMeasurements” debe actualizarse como un todo, por lo que debe establecerse una vez cuando se complete la medición. Si está vacío, significa que ninguna de las mediciones se completó dentro del “serverMeasurementTimeout”. MembersInGroupIds
Tipo: const uint32_t*
Una colección de memberIds de mi grupo. Si se establece una lista “initializationGroup”, el índice del propio miembro siempre se agregará si aún no está presente. Durante la inicialización administrada, si algún miembro de la lista falla, este miembro también fallará. MembersInGroupCount
Tipo: size_t
El número de entradas de la matriz MembersInGroupIds. QosMeasurementsJson
Tipo: const char*
Mediciones de QoS por dirección de dispositivo segura. Como todos los campos, “measurements” debe actualizarse como un todo. Debe establecerse una vez cuando se complete la medición, no de forma incremental. Si se establece un objeto “measurements”, no puede contener una entrada para la propia dirección del miembro. DeviceToken
Tipo: XblDeviceToken
Se establece cuando el miembro carga una dirección de dispositivo segura. Es una cadena que no distingue mayúsculas de minúsculas y que se puede usar para comparaciones de igualdad. Nat
Tipo: XblNetworkAddressTranslationSetting
Es la configuración de NAT del dispositivo cuando el miembro carga una dirección de dispositivo segura. ActiveTitleId
Tipo: uint32_t
Si el miembro está activo, este es el identificador del título en el que está activo. InitializationEpisode
Tipo: uint32_t
Este valor solo es útil de leer cuando el título administra manualmente su propia QoS. Si la sección “memberInitialization” está establecida y el miembro se agregó con “initialize”:true, se establece en el episodio de inicialización en el que participará el miembro; de lo contrario, es 0. Los usuarios se unen a las sesiones por lotes. El número de episodio de inicialización indica un conjunto de usuarios con respecto a los cuales se debe realizar la QoS. El episodio de inicialización 1 es un valor especial que se usa para los miembros agregados a una sesión nueva en el momento de la creación. JoinTime
Tipo: time_t
La hora en la que el usuario se unió a la sesión. Si “reserved” es true, esta es la hora en la que se realizó la reserva. InitializationFailureCause
Tipo: XblMultiplayerMeasurementFailure
La causa por la que falló la inicialización, o XblMultiplayerMeasurementFailure::None si no hubo ningún error. Se establece al salir de la fase “joining” o “measuring” si este miembro no la supera. Groups
Tipo: const char**
Una matriz de nombres de grupo del usuario actual que indica de qué grupos formó parte ese usuario durante una sesión multijugador. GroupsCount
Tipo: size_t
El número de elementos de la matriz Groups. Encounters
Tipo: const char**
Obtiene una lista de nombres de grupo del usuario actual que indica con qué grupos se encontró ese usuario durante una sesión multijugador. EncountersCount
Tipo: size_t
El número de elementos de la matriz Groups. TournamentTeamSessionReference
Tipo: XblMultiplayerSessionReference
La referencia de sesión del equipo del torneo. EN DESUSO. Se quitará en una versión futura. Internal
Tipo: void*
Solo para uso interno.

Requisitos

Encabezado: multiplayer_c.h

Consulte también

multiplayer_c
Última modificación el 28 de agosto de 2026