XblMultiplayerSessionProperties
Ensemble de propriétés associées à cette session. N’importe quel joueur peut modifier ces propriétés.Syntaxe
Membres
KeywordsType : const char** Collection de mots clés associés à la session (facultatif, peut être vide). KeywordCount
Type : size_t 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 que cela n’a aucun impact sur les sessions “private” et “visible”.) La valeur par défaut est “none”. Si “local”, seuls les utilisateurs dont le DeviceId du jeton correspond à celui d’une autre personne déjà présente dans la session avec “active”: true. Si “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 que cela n’a aucun impact sur les sessions “private” et “visible”.) La valeur par défaut est “none”. Si “local”, seuls les utilisateurs dont le DeviceId du jeton correspond à celui d’une autre personne déjà présente dans la session avec “active”: true. Si “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 d’accès ; autrement dit, ‘joinRestriction’ ne peut pas être défini sur “followed” sans définir également ‘readRestriction’.” TurnCollection
Type : uint32_t* Collection de MemberIds de session indiquant à qui c’est le tour. TurnCollectionCount
Type : size_t Nombre d’entrées dans le tableau TurnCollection. MatchmakingTargetSessionConstantsJson
Type : const char* 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. En cas de 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** 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 peuvent utiliser un mécanisme personnalisé pour choisir l’une des autres (par exemple en fonction de la charge). ServerConnectionStringCandidatesCount
Type : size_t 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 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 considère que l’hôte indiqué est le bon et ne mesure les métriques que vers cet hôte. Closed
Type : bool Détermine si une session peut être rejointe, indépendamment de la visibilité, de la restriction d’accès 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, les membres de la session peuvent être verrouillés, de sorte qu’un utilisateur qui quitte la session peut y revenir, mais qu’aucun autre utilisateur ne peut prendre sa place. La valeur par défaut est false. AllocateCloudCompute
Type : bool La définition 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 correspondance trouvée n’a pas fonctionné et doit être soumise à nouveau. Définissez sur false pour signaler que la correspondance a fonctionné et que le service de matchmaking peut libérer la session.