Skip to main content

XblMultiplayerActivitySetActivityAsync

Définit ou met à jour l’activité multijoueur d’un utilisateur local.

Syntaxe

Paramètres

xblContext   _In_
Type : XblContextHandle
Contexte XBOX Live de l’utilisateur local. activityInfo   _In_
Type : XblMultiplayerActivityInfo*
Informations sur l’activité. Les champs maxPlayers et currentPlayers sont facultatifs ; ils sont ignorés s’ils sont définis sur 0. La valeur du champ platform est ignorée ; XSAPI définit automatiquement l’activité sur la plateforme locale appropriée. allowCrossPlatformJoin   _In_
Type : bool
True si l’activité doit pouvoir être rejointe sur les autres plateformes prises en charge par le titre. async   _In_
Type : XAsyncBlock*
XAsyncBlock pour cette opération.

Valeur de retour

Type : HRESULT Code de retour HRESULT pour cette opération d’API.

Remarques

Lorsqu’un titre démarre ou rejoint une expérience multijoueur, il doit créer une activité. Cela permet à l’interpréteur de commandes et aux autres joueurs de votre titre de voir l’activité du joueur. Votre titre peut permettre à d’autres joueurs de rejoindre la partie en cours. Si un joueur souhaite rejoindre une activité de votre titre alors que celui-ci n’est pas en cours d’exécution, le titre est activé et la chaîne de connexion lui est transmise.

Pour voir comment cette fonction est utilisée, consultez « Définition d’une activité » dans la section Activités de l’Exemple de code pour Multiplayer Activity.

Appel REST

Appelle PUT /titles//users//activites

Configuration requise

En-tête : multiplayer_activity_c.h Bibliothèque : Microsoft.Xbox.Services.14x.GDK.C.lib

Voir aussi

multiplayer_activity_c
Last modified on October 6, 2026