XblMultiplayerSessionMember
Représente une référence en lecture seule à un membre d’une session multijoueur.Syntaxe
Membres
MemberIdType : 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.
