Passer au contenu principal
Cette rubrique fournit un exemple de code pour définir l’état de présence en ligne d’un utilisateur. La présence enrichie des services XBOX fournit des fonctionnalités permettant d’indiquer l’activité en cours d’un joueur aux autres joueurs. Pour plus d’informations, consultez Vue d’ensemble de la présence enrichie.

Mise à jour de l’état de présence en ligne d’un utilisateur

Cet exemple de code définit l’état de présence en ligne d’un utilisateur. L’exemple suivant utilise l’API C plate.
Pour plus d’informations, consultez les rubriques suivantes :

Mise à jour de l’état de présence enrichie

L’exemple suivant définit la chaîne de présence enrichie playingMap pour l’utilisateur. Dans cet exemple, playingMap est configurée comme une chaîne statique sans jeton. xboxLiveContext est le XblContextHandle de l’utilisateur, et queue est la file d’attente de tâches de votre jeu, ou nullptr pour utiliser la file d’attente de tâches par défaut du processus.
Si la chaîne de présence configurée nécessite des chaînes de remplacement explicites, définissez presenceTokenIds sur leurs ID de chaîne configurés dans l’ordre des espaces réservés, et définissez presenceTokenIdsCount sur la longueur du tableau. Si le membre scid ou presenceId est vide, la requête inclut uniquement l’état actif ou inactif et n’inclut pas de chaîne de présence enrichie. Pour plus d’informations, consultez les rubriques suivantes :

Limites de débit et certification

Le service de présence autorise, pour chaque utilisateur et chaque titre, 3 écritures en 15 secondes et 30 écritures en 300 secondes. Mettez à jour la présence enrichie lorsque l’activité du joueur change, et regroupez les changements rapides en une seule mise à jour. Si vous actualisez également la présence enrichie périodiquement, maintenez le débit combiné dans les deux limites. Si un appel échoue avec HTTP_E_STATUS_429_TOO_MANY_REQUESTS (XblErrorCondition::Http429TooManyRequests), ne réessayez pas en boucle. La réponse du service inclut un en-tête Retry-After, que XSAPI respecte. Le test de certification XR-132 fait échouer un titre dont le débit de requêtes est supérieur ou égal à 10 fois la limite soutenue, soit 300 écritures de présence en 300 secondes. Ce seuil ne constitue pas une marge de fonctionnement sûre. Pour plus d’informations, consultez Limitation du débit précise.
Dernière modification le 30 octobre 2026