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 la chaîne d’invitation personnalisée.
Cet ID de chaîne est défini dans la configuration du 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écédée de ”///”. Passez une chaîne vide si vous ne voulez pas qu’une chaîne personnalisée soit ajoutée à l’invitation. customActivationContext _In_opt_
Type : char* Le contexte d’activation personnalisé qui est accessible à la personne invitée dans l’URI d’activation d’une invitation. La chaîne du 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 fera passer votre jeu en mode limité. En mode limité, votre titre recevra moins de ressources système pendant qu’il se trouve en arrière-plan de l’interface utilisateur appelée. Pour en savoir plus sur le mode limité 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)