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ÉCONSEILLÉ. Sera supprimé dans une version ultérieure InitialTeam
Type : const char*
Affectation d’équipe initiale provenant de SmartMatch. ArbitrationStatus
Type : XblTournamentArbitrationStatus
État d’arbitrage d’un membre dans un tournoi. DÉCONSEILLÉ. Sera supprimé dans une version ultérieure Xuid
Type : uint64_t
ID d’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*
L’adresse d’appareil sécurisée du membre, encodée en base64. (Facultatif) Roles
Type : const XblMultiplayerSessionMemberRole*
Un 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]
Le gamertag du membre. (Facultatif) Connu uniquement si le membre a accepté. Status
Type : XblMultiplayerSessionMemberStatus
L’état de ce membre. IsTurnAvailable
Type : bool
Est 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 s’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 jumelage ajoute un utilisateur à une session, il peut fournir du contexte sur la manière dont l’utilisateur a été jumelé à la session et pourquoi. Il s’agit d’une copie des serverMeasurements de l’utilisateur provenant de la session de jumelage. 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*
Une collection de memberIds de mon groupe. Si une liste « initializationGroup » est définie, l’index du membre lui-même y est toujours ajouté s’il n’est pas déjà présent. Pendant l’initialisation gérée, si un membre de la liste échoue, ce membre échoue également. MembersInGroupCount
Type : size_t
Le 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 téléverse 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
Il s’agit du paramètre NAT de l’appareil lorsque le membre téléverse 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
Il n’est utile de lire cette valeur 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, cette valeur est définie sur l’épisode d’initialisation auquel le membre participera; sinon, elle est 0. Les utilisateurs rejoignent les sessions par lots. Le numéro d’épisode d’initialisation indique un ensemble d’utilisateurs pour 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 au moment de sa création. JoinTime
Type : time_t
L’heure à laquelle l’utilisateur a rejoint la session. Si « reserved » est true, il s’agit de l’heure à laquelle la réservation a été effectuée. InitializationFailureCause
Type : XblMultiplayerMeasurementFailure
La raison de l’échec de l’initialisation, ou XblMultiplayerMeasurementFailure::None s’il n’y a eu aucun échec. Défini lors de la sortie de l’étape « joining » ou « measuring » si ce membre ne réussit pas. Groups
Type : const char**
Un tableau de noms de groupes pour l’utilisateur actuel indiquant les groupes dont cet utilisateur a fait partie pendant une session multijoueur. GroupsCount
Type : size_t
Le 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
Le nombre d’éléments dans le tableau Groups. TournamentTeamSessionReference
Type : XblMultiplayerSessionReference
La référence de session d’équipe de tournoi. DÉCONSEILLÉ. Sera supprimé 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