Skip to main content

XblMultiplayerSessionMember

Représente une référence en lecture seule à un membre d’une session multijoueur.

Syntaxe

Membres

MemberId
Type : uint32_t
ID de ce membre. Unique dans le contexte de la session dont ce membre fait partie. TeamId
Type : const char*
ID de l’équipe de ce membre dans un tournoi. DÉPRÉCIÉ. Il sera supprimé dans une version ultérieure InitialTeam
Type : const char*
Affectation d’équipe initiale de SmartMatch. ArbitrationStatus
Type : XblTournamentArbitrationStatus
État d’arbitrage d’un membre dans un tournoi. DÉPRÉCIÉ. Il sera supprimé dans une version ultérieure Xuid
Type : uint64_t
ID utilisateur XBOX du membre. Connu uniquement si le membre a accepté. CustomConstantsJson
Type : const char*
Chaîne JSON qui spécifie les constantes personnalisées du membre. SecureDeviceBaseAddress64
Type : const char*
Adresse d’appareil sécurisée du membre, encodée en base64. (Facultatif) Roles
Type : const XblMultiplayerSessionMemberRole*
Tableau de rôles pour ce membre. (Facultatif) RolesCount
Type : size_t
Nombre d’entrées dans le tableau Roles. CustomPropertiesJson
Type : const char*
Chaîne JSON qui spécifie les propriétés personnalisées du membre. Gamertag
Type : char[XBL_GAMERTAG_CHAR_SIZE]
Gamertag du membre. (Facultatif) Connu uniquement si le membre a accepté. Status
Type : XblMultiplayerSessionMemberStatus
État de ce membre. IsTurnAvailable
Type : bool
A la valeur true uniquement si ce membre est prêt pour son tour. IsCurrentUser
Type : bool
Indique si ce MultiplayerSessionMember correspond à l’utilisateur actuel. InitializeRequested
Type : bool
Indique qu’il faut exécuter l’initialisation QoS pour cet utilisateur. La valeur par défaut est false. Ignoré s’il n’existe pas de section “memberInitialization” pour la session. MatchmakingResultServerMeasurementsJson
Type : const char*
Lorsque le service de matchmaking ajoute un utilisateur à une session, il peut fournir du contexte sur la manière dont il a été associé à la session et la raison. Il s’agit d’une copie des serverMeasurements de l’utilisateur provenant de la session de matchmaking. ServerMeasurementsJson
Type : const char*
Mesures QoS par chaîne de connexion de serveur de jeu. Comme tous les champs, “serverMeasurements” doit être mis à jour dans son ensemble ; il doit donc être défini une seule fois lorsque la mesure est terminée. S’il est vide, cela signifie qu’aucune des mesures ne s’est terminée dans le délai “serverMeasurementTimeout”. MembersInGroupIds
Type : const uint32_t*
Collection de memberIds de mon groupe. Si une liste “initializationGroup” est définie, l’index du membre lui-même est toujours ajouté s’il n’est pas déjà présent. Pendant l’initialisation gérée, si l’un des membres de la liste échoue, ce membre échoue également. MembersInGroupCount
Type : size_t
Nombre d’entrées dans le tableau MembersInGroupIds. QosMeasurementsJson
Type : const char*
Mesures QoS par adresse d’appareil sécurisée. Comme tous les champs, “measurements” doit être mis à jour dans son ensemble. Il doit être défini une seule fois lorsque la mesure est terminée, et non de manière incrémentielle. Si un objet “measurements” est défini, il ne peut pas contenir d’entrée pour l’adresse du membre lui-même. DeviceToken
Type : XblDeviceToken
Défini lorsque le membre charge une adresse d’appareil sécurisée. Il s’agit d’une chaîne qui ne respecte pas la casse et qui peut être utilisée pour les comparaisons d’égalité. Nat
Type : XblNetworkAddressTranslationSetting
Paramètre NAT de l’appareil lorsque le membre charge une adresse d’appareil sécurisée. ActiveTitleId
Type : uint32_t
Si le membre est actif, il s’agit de l’ID du titre dans lequel il est actif. InitializationEpisode
Type : uint32_t
Cette valeur n’est utile à lire que lorsque le titre gère manuellement sa propre QoS. Si la section “memberInitialization” est définie et que le membre a été ajouté avec “initialize”:true, elle correspond à l’épisode d’initialisation auquel le membre participera ; sinon, elle vaut 0. Les utilisateurs rejoignent les sessions par lots. Le numéro d’épisode d’initialisation indique un ensemble d’utilisateurs sur lesquels la QoS doit être effectuée. L’épisode d’initialisation 1 est une valeur spéciale utilisée pour les membres ajoutés à une nouvelle session lors de sa création. JoinTime
Type : time_t
Heure à laquelle l’utilisateur a rejoint la session. Si “reserved” a la valeur true, il s’agit de l’heure à laquelle la réservation a été effectuée. InitializationFailureCause
Type : XblMultiplayerMeasurementFailure
Cause de l’échec de l’initialisation, ou XblMultiplayerMeasurementFailure::None en l’absence d’échec. Défini lors de la sortie de l’étape “joining” ou “measuring” si ce membre ne la réussit pas. Groups
Type : const char**
Tableau de noms de groupes pour l’utilisateur actuel, indiquant les groupes dont cet utilisateur faisait partie pendant une session multijoueur. GroupsCount
Type : size_t
Nombre d’éléments dans le tableau Groups. Encounters
Type : const char**
Obtient une liste de noms de groupes pour l’utilisateur actuel, indiquant les groupes que cet utilisateur a rencontrés pendant une session multijoueur. EncountersCount
Type : size_t
Nombre d’éléments dans le tableau Groups. TournamentTeamSessionReference
Type : XblMultiplayerSessionReference
Référence de session de l’équipe du tournoi. DÉPRÉCIÉ. Elle sera supprimée dans une version ultérieure Internal
Type : void*
Usage interne uniquement.

Configuration requise

En-tête : multiplayer_c.h

Voir aussi

multiplayer_c
Last modified on October 6, 2026