Gestion d'un changement de présence de titre

Cet article fournit un exemple de code qui utilise l’API des services XBOX (XSAPI) pour gérer les changements de présence de titre. Pour recevoir les notifications de présence de titre, inscrivez d’abord un gestionnaire, puis suivez les utilisateurs et les titres qui vous intéressent. Lorsque vous n’avez plus besoin des notifications, arrêtez le suivi des utilisateurs et des titres et supprimez le gestionnaire. Dans les exemples, xboxLiveContext est un XblContextHandle pour l’utilisateur local connecté, state est un objet défini par le titre qui stocke le jeton du gestionnaire et LogToFile est une fonction de journalisation définie par le titre. Remplacez 123 par l’ID utilisateur XBOX (XUID) d’un utilisateur dont vous voulez suivre la présence, et remplacez otherTitleId par l’ID de titre d’un autre titre que vous voulez suivre.

XblPresenceSubscribeToTitlePresenceChange et XblPresenceUnsubscribeFromTitlePresenceChange sont dépréciées. Ne les utilisez pas dans du nouveau code. XSAPI gère les abonnements Real-Time Activity (RTA) pour vous lorsque vous suivez des utilisateurs avec XblPresenceTrackUsers et des titres avec XblPresenceTrackAdditionalTitles.

Ajout d’un gestionnaire de changement de présence de titre

Inscrivez le gestionnaire avant de suivre des utilisateurs et des titres. La fonction retourne 0 si xblContextHandle ou handler est null.

state.titlePresenceChangedHandlerToken = XblPresenceAddTitlePresenceChangedHandler(
    xboxLiveContext,
    [](void* context, uint64_t xuid, uint32_t titleId, XblPresenceTitleState titleState)
    {
        UNREFERENCED_PARAMETER(context);
        LogToFile("Title presence change notification received:");
        LogToFile("Xuid = %llu, titleId = %u, titleState = %u",
            static_cast<unsigned long long>(xuid),
            titleId,
            static_cast<uint32_t>(titleState));
    },
    nullptr
);

if (state.titlePresenceChangedHandlerToken == 0)
{
    // The handler wasn't registered.
}

Pour plus d’informations, consultez XblPresenceTitleState.

Suivi des utilisateurs et des titres

Les gestionnaires de changement de présence de titre reçoivent des notifications uniquement pour les utilisateurs que vous suivez avec XblPresenceTrackUsers et pour les titres que vous suivez. Le titre actuel est suivi par défaut; appelez donc XblPresenceTrackAdditionalTitles uniquement pour les autres titres. Chaque appel s’ajoute à la liste existante. Vérifiez le résultat de chaque appel.

uint64_t xuids[]{ 123 };
uint32_t titleIds[]{ otherTitleId };

HRESULT hr = XblPresenceTrackUsers(
    xboxLiveContext,
    xuids,
    _countof(xuids)
);

if (SUCCEEDED(hr))
{
    hr = XblPresenceTrackAdditionalTitles(
        xboxLiveContext,
        titleIds,
        _countof(titleIds)
    );
}

Le suivi utilise un décompte de références. Effectuez un appel d’arrêt correspondant pour chaque appel de suivi réussi. La liste des utilisateurs suivis s’applique aux notifications de présence d’appareil et de présence de titre.

Arrêt du suivi des utilisateurs et des titres

Lorsque vous n’avez plus besoin des mises à jour de présence de titre, arrêtez le suivi des titres et des utilisateurs que vous suiviez, et vérifiez chaque résultat. XblPresenceStopTrackingAdditionalTitles n’arrête pas le suivi du titre actuel.

HRESULT hr = XblPresenceStopTrackingAdditionalTitles(
    xboxLiveContext,
    titleIds,
    _countof(titleIds)
);

HRESULT hrUsers = XblPresenceStopTrackingUsers(
    xboxLiveContext,
    xuids,
    _countof(xuids)
);

Suppression d’un gestionnaire de changement de présence de titre

Supprimez le gestionnaire en passant le jeton retourné par XblPresenceAddTitlePresenceChangedHandler. Effacez le jeton stocké seulement après la réussite de l’appel.

HRESULT hr = XblPresenceRemoveTitlePresenceChangedHandler(
    xboxLiveContext,
    state.titlePresenceChangedHandlerToken
);

if (SUCCEEDED(hr))
{
    state.titlePresenceChangedHandlerToken = 0;
}

Voir aussi

XblPresenceAddTitlePresenceChangedHandler XblPresenceRemoveTitlePresenceChangedHandler XblPresenceTrackUsers XblPresenceTrackAdditionalTitles XblPresenceStopTrackingAdditionalTitles Gestion d’un changement de présence d’appareil

XBOX Services

PlayFab

Ajout d’un gestionnaire de changement de présence de titre

Suivi des utilisateurs et des titres

Arrêt du suivi des utilisateurs et des titres

Suppression d’un gestionnaire de changement de présence de titre

Voir aussi

​Ajout d’un gestionnaire de changement de présence de titre

​Suivi des utilisateurs et des titres

​Arrêt du suivi des utilisateurs et des titres

​Suppression d’un gestionnaire de changement de présence de titre

​Voir aussi

Ajout d’un gestionnaire de changement de présence de titre

Suivi des utilisateurs et des titres

Arrêt du suivi des utilisateurs et des titres

Suppression d’un gestionnaire de changement de présence de titre

Voir aussi