Skip to main content

POST (/serviceconfigs//sessiontemplates//batch)

Crée une requête par lot portant sur plusieurs ID d’utilisateur XBOX.
Important :
Cette méthode est utilisée par le multijoueur 2015 et s’applique uniquement à cette version multijoueur et aux versions ultérieures. Elle est destinée à être utilisée avec le contrat de modèle 104/105 ou ultérieur et nécessite un élément d’en-tête X-Xbl-Contract-Version: 104/105 ou ultérieur dans chaque requête.

Remarques

Cette méthode HTTP/REST crée des requêtes par lot portant sur plusieurs ID d’utilisateur XBOX au niveau du modèle de session. Cette méthode peut être encapsulée par Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsForUsersFilterAsync. Pour le multijoueur 2015, vous pouvez combiner de nombreuses requêtes en un seul appel si toutes les requêtes sont identiques, mais portent sur des ID d’utilisateur XBOX (XUID) différents, tels que représentés dans le paramètre de chaîne de requête xuid. Notez que les paramètres de chaîne de requête et les réponses sont les mêmes pour les requêtes ordinaires et les requêtes par lot. Pour une requête par lot, les sessions appartenant à chaque XUID sont écrites dans la réponse dans le même ordre que celui des paramètres xuid présentés dans la requête. Une même session peut apparaître plusieurs fois dans la réponse, une fois pour chaque xuid auquel elle correspond.

Paramètres d’URI

| Paramètre| Type| Description| | --- | --- | --- | --- | | scid| GUID| Identificateur de configuration de service (SCID). Partie 1 de l’identificateur de session.| | sessionTemplateName| chaîne| Nom de l’instance actuelle du modèle de session. Partie 2 de l’identificateur de session.|

Paramètres de chaîne de requête

Une requête peut être modifiée au moyen des paramètres de chaîne de requête du tableau suivant. | Paramètre| Type| Description| | --- | --- | --- | --- | --- | --- | --- | | keyword| chaîne| Un mot clé, par exemple « foo », qui doit se trouver dans les sessions ou les modèles pour que ceux-ci soient récupérés. | | xuid| entier non signé 64 bits| L’ID d’utilisateur XBOX, par exemple « 123 », des sessions à inclure dans la requête. Par défaut, l’utilisateur doit être actif dans la session pour que celle-ci soit incluse. | | reservations| booléen| True pour inclure les sessions pour lesquelles l’utilisateur est défini comme joueur réservé, mais ne s’est pas joint pour devenir un joueur actif. Ce paramètre est utilisé uniquement lors de l’interrogation de vos propres sessions, ou lors de l’interrogation de serveur à serveur des sessions d’un utilisateur précis. | | inactive| booléen| True pour inclure les sessions que l’utilisateur a acceptées, mais auxquelles il ne joue pas activement. Les sessions dans lesquelles l’utilisateur est « ready » (prêt), mais pas « active » (actif), sont considérées comme inactives. | | private| booléen| True pour inclure les sessions privées. Ce paramètre est utilisé uniquement lors de l’interrogation de vos propres sessions, ou lors de l’interrogation de serveur à serveur des sessions d’un utilisateur précis. | | visibility| chaîne| État de visibilité des sessions. Les valeurs possibles sont définies par MultiplayerSessionVisibility. Si ce paramètre est défini sur « open », la requête doit inclure uniquement les sessions ouvertes. S’il est défini sur « private », le paramètre private doit être défini sur true. | | version| entier signé 32 bits| La version de session maximale à inclure. Par exemple, une valeur de 2 indique que seules les sessions dont la version de session principale est 2 ou moins doivent être incluses. Le numéro de version doit être inférieur ou égal à la version de contrat de la requête modulo 100. | | take| entier signé 32 bits| Le nombre maximal de sessions à récupérer. Ce nombre doit être compris entre 0 et 100. | Définir private ou reservations sur true nécessite un accès de niveau serveur à la session. Sinon, ces paramètres exigent que la revendication XUID de l’appelant corresponde au filtre XUID de l’URI. Dans le cas contraire, le code d’état HTTP/403 est retourné, que de telles sessions existent ou non.

Codes d’état HTTP

Le service retourne un code d’état HTTP tel qu’il s’applique au MPSD.

Corps de la requête

Corps de la réponse

Cette méthode retourne un tableau JSON de références de session, avec certaines données de session incluses directement.

Voir aussi

Parent
/serviceconfigs//sessiontemplates//batch
Last modified on October 6, 2026