Control de un cambio de presencia de dispositivo

Este artículo proporciona código de ejemplo que usa la API de servicios de XBOX (XSAPI) para controlar los cambios de presencia de dispositivo. Para recibir notificaciones de presencia de dispositivo, registre un controlador y realice el seguimiento de los usuarios que le interesen. Cuando ya no necesite las notificaciones, detenga el seguimiento de los usuarios y quite el controlador. En los ejemplos, xboxLiveContext es un XblContextHandle del usuario local que inició sesión, state es un objeto definido por el título que almacena el token del controlador y LogToFile es una función de registro definida por el título. Reemplace 123 por el identificador de usuario de XBOX (XUID) de un usuario cuya presencia quiera seguir.

XblPresenceSubscribeToDevicePresenceChange y XblPresenceUnsubscribeFromDevicePresenceChange están en desuso. No las use en código nuevo. XSAPI administra automáticamente las suscripciones de Real-Time Activity (RTA) cuando realiza el seguimiento de usuarios con XblPresenceTrackUsers y lo detiene con XblPresenceStopTrackingUsers.

Adición de un controlador de cambio de presencia de dispositivo

Registre un controlador al que XSAPI llama cuando cambia la presencia de dispositivo de un usuario del que se realiza el seguimiento. La función devuelve 0 si xblContextHandle o handler es NULL.

state.devicePresenceChangedHandlerToken = XblPresenceAddDevicePresenceChangedHandler(
    xboxLiveContext,
    [](void* context, uint64_t xuid, XblPresenceDeviceType deviceType, bool isUserLoggedOnDevice)
    {
        UNREFERENCED_PARAMETER(context);
        LogToFile("Device presence change notification received:");
        LogToFile("Xuid = %llu, deviceType = %u, isUserLoggedOnDevice = %u",
            static_cast<unsigned long long>(xuid),
            static_cast<uint32_t>(deviceType),
            static_cast<uint32_t>(isUserLoggedOnDevice));
    },
    nullptr
);

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

Para obtener más información, consulte XblPresenceDeviceType.

Seguimiento de usuarios para cambios de presencia de dispositivo

Los controladores de cambio de presencia de dispositivo solo reciben notificaciones de los usuarios de los que realiza el seguimiento con XblPresenceTrackUsers. Cada llamada agrega usuarios a la lista existente de usuarios con seguimiento. Puede actualizar la lista de usuarios con seguimiento independientemente de los controladores.

uint64_t xuids[]{ 123 };

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

El seguimiento usa recuento de referencias. Si realiza el seguimiento del mismo usuario más de una vez, haga una llamada a XblPresenceStopTrackingUsers correspondiente por cada llamada correcta a XblPresenceTrackUsers. La lista de usuarios con seguimiento se aplica tanto a las notificaciones de presencia de dispositivo como a las de presencia de título.

Detención del seguimiento de usuarios

Cuando ya no necesite actualizaciones de presencia de un usuario, detenga su seguimiento.

uint64_t xuids[]{ 123 };

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

Eliminación de un controlador de cambio de presencia de dispositivo

Quite el controlador pasando el token que devolvió XblPresenceAddDevicePresenceChangedHandler. Borre el token almacenado solo después de que la llamada se realice correctamente.

HRESULT hr = XblPresenceRemoveDevicePresenceChangedHandler(
    xboxLiveContext,
    state.devicePresenceChangedHandlerToken
);

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

Consulte también

XblPresenceAddDevicePresenceChangedHandler XblPresenceRemoveDevicePresenceChangedHandler XblPresenceTrackUsers XblPresenceStopTrackingUsers Control de un cambio de presencia de título

XBOX Services

PlayFab

Adición de un controlador de cambio de presencia de dispositivo

Seguimiento de usuarios para cambios de presencia de dispositivo

Detención del seguimiento de usuarios

Eliminación de un controlador de cambio de presencia de dispositivo

Consulte también

​Adición de un controlador de cambio de presencia de dispositivo

​Seguimiento de usuarios para cambios de presencia de dispositivo

​Detención del seguimiento de usuarios

​Eliminación de un controlador de cambio de presencia de dispositivo

​Consulte también

Adición de un controlador de cambio de presencia de dispositivo

Seguimiento de usuarios para cambios de presencia de dispositivo

Detención del seguimiento de usuarios

Eliminación de un controlador de cambio de presencia de dispositivo

Consulte también