XGameUiShowSendGameInviteAsync
Cette méthode affiche une interface utilisateur de sélection remplie à partir de la liste d’amis et de la liste d’amis suggérés du joueur sélectionné, afin d’envoyer des invitations de jeu.Syntaxe
Paramètres
async _In_Type : XAsyncBlock* Pointeur vers le XAsyncBlock qui est passé à XAsyncRun. requestingUser _In_
Type : XUserHandle Handle de l’utilisateur qui envoie les invitations. sessionConfigurationId _In_
Type : char* Spécifie une chaîne qui indique l’ID de configuration de service du titre. sessionTemplateName _In_
Type : char* Spécifie une chaîne qui indique le nom du modèle de session multijoueur. sessionId _In_
Type : char* Spécifie une chaîne qui indique l’ID de la session multijoueur à laquelle inviter des personnes. invitationText _In_opt_
Type : char* Spécifie une chaîne qui indique l’ID de chaîne d’invitation personnalisée.
Cet ID de chaîne est défini dans la configuration de service XBOX Live pour identifier le texte d’invitation qui s’ajoute au texte d’invitation standard. La chaîne d’ID doit être préfixée par ”///”. Passez une chaîne vide si vous ne souhaitez pas ajouter de chaîne personnalisée à l’invitation. customActivationContext _In_opt_
Type : char* Contexte d’activation personnalisé mis à la disposition de la personne invitée dans l’URI d’activation d’une invitation. La chaîne de contexte d’activation personnalisé doit être compatible avec les URL, et le contenu binaire doit être encodé avec un encodage base64 compatible avec les URL. La longueur maximale est de 160 caractères.
Valeur de retour
Type : HRESULT Code de réussite ou d’erreur HRESULT de l’appel asynchrone.Remarques
Une fois la liste remplie, des joueurs peuvent être sélectionnés. Le joueur peut envoyer une invitation à jouer à un jeu et/ou à une conversation de groupe pour une session de jeu spécifiée aux personnes sélectionnées dans l’interface utilisateur de sélection. L’appel d’une interface utilisateur fait passer votre jeu en mode contraint. En mode contraint, votre titre reçoit moins de ressources système lorsqu’il se trouve en arrière-plan de l’interface utilisateur appelée. Pour en savoir plus sur le mode contraint et les autres modes de fonctionnement de votre titre, consultez Cycle de vie des jeux XBOX (rubrique sous NDA).Configuration requise
En-tête : XGameUI.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, Steam Deck, consoles de la famille XBOX One et consoles XBOX SeriesDocumentation conceptuelle
Voir aussi
XGameUIXGameUiShowSendGameInviteResult
Cycle de vie des jeux XBOX (rubrique sous NDA)