XblMultiplayerSessionProperties
Un ensemble de propriétés associées à cette session. N’importe quel joueur peut modifier ces propriétés.Syntaxe
Membres
KeywordsType : const char** Une collection de mots clés associés à la session (facultatif, peut être vide). KeywordCount
Type : size_t Le nombre de mots clés. JoinRestriction
Type : XblMultiplayerSessionRestriction Limite les utilisateurs qui peuvent rejoindre les sessions « open ». (N’a aucun effet sur les réservations, ce qui signifie qu’il n’a aucune incidence sur les sessions « private » et « visible ».) La valeur par défaut est « none ». Si la valeur est « local », seuls les utilisateurs dont le DeviceId du jeton correspond à celui d’une autre personne déjà dans la session avec “active”: true. Si la valeur est « followed », seuls les utilisateurs locaux (tels que définis ci-dessus) et les utilisateurs suivis par un membre existant (non réservé) de la session peuvent la rejoindre sans réservation. ReadRestriction
Type : XblMultiplayerSessionRestriction Limite les utilisateurs qui peuvent lire les sessions « open ». (N’a aucun effet sur les réservations, ce qui signifie qu’il n’a aucune incidence sur les sessions « private » et « visible ».) La valeur par défaut est « none ». Si la valeur est « local », seuls les utilisateurs dont le DeviceId du jeton correspond à celui d’une autre personne déjà dans la session avec “active”: true. Si la valeur est « followed », seuls les utilisateurs locaux (tels que définis ci-dessus) et les utilisateurs suivis par un membre existant (non réservé) de la session peuvent la lire sans réservation. La restriction de lecture s’applique aux sessions dont la visibilité est « open » ou « visible » et détermine qui peut lire la session sans invitation. La restriction de lecture doit être au moins aussi permissive que la restriction de participation, c.-à-d. que ‘joinRestriction’ ne peut pas être défini sur « followed » sans que ‘readRestriction’ soit également défini. TurnCollection
Type : uint32_t* Une collection de MemberIds de session indiquant à qui c’est le tour. TurnCollectionCount
Type : size_t Le nombre d’entrées dans le tableau TurnCollection. MatchmakingTargetSessionConstantsJson
Type : const char* Une chaîne JSON représentant les constantes de la session cible. SessionCustomPropertiesJson
Type : const char* Chaîne JSON qui spécifie les propriétés personnalisées de la session. Celles-ci peuvent être modifiées à tout moment. Lors d’une modification, appelez multiplayer_service::write_session pour écrire les modifications dans le service. MatchmakingServerConnectionString
Type : const char* Force l’utilisation d’une chaîne de connexion spécifique. Utile dans les scénarios où l’on rejoint une session en cours. ServerConnectionStringCandidates
Type : const char** La liste ordonnée des chaînes de connexion que la session pourrait utiliser pour se connecter à un serveur de jeu. En général, les titres doivent utiliser la première de la liste, mais des titres plus élaborés pourraient utiliser un mécanisme personnalisé pour en choisir une autre (par exemple, en fonction de la charge). ServerConnectionStringCandidatesCount
Type : size_t Le nombre d’entrées dans le tableau ServerConnectionStringCandidates. SessionOwnerMemberIds
Type : uint32_t* MemberIds de session des propriétaires de la session. SessionOwnerMemberIdsCount
Type : size_t Le nombre d’entrées dans le tableau SessionOwnerMemberIds. HostDeviceToken
Type : XblDeviceToken Jeton d’appareil de l’hôte. Doit correspondre au « deviceToken » d’au moins un membre, sinon ce champ est supprimé. Si « peerToHostRequirements » et « host » sont définis, l’étape de mesure suppose que l’hôte indiqué est le bon hôte et ne mesure que les métriques vers cet hôte. Closed
Type : bool Détermine si une session peut être rejointe, indépendamment de la visibilité, de la restriction de participation et de l’espace disponible dans la session. N’affecte pas les réservations. La valeur par défaut est false. Locked
Type : bool Si la valeur est true, permet de verrouiller les membres de la session, de sorte qu’un utilisateur qui quitte la session puisse y revenir, mais qu’aucun autre utilisateur ne puisse prendre sa place. La valeur par défaut est false. AllocateCloudCompute
Type : bool La définition de cette valeur sur true par un client déclenche une tentative d’allocation XBOX Live Compute par MPSD. La valeur par défaut est false. MatchmakingResubmit
Type : bool True si la partie trouvée n’a pas fonctionné et doit être soumise de nouveau. Définissez sur false pour signaler que la partie a fonctionné et que le service de jumelage peut libérer la session.