Saltar al contenido principal
Este tema proporciona código de ejemplo para establecer el estado de presencia en línea de un usuario. La presencia enriquecida de los servicios XBOX proporciona características para anunciar la actividad actual de un jugador a otros jugadores. Para obtener más información, consulte Información general de la presencia enriquecida.

Actualización del estado de presencia en línea de un usuario

Este código de ejemplo establece el estado de presencia en línea de un usuario. En el ejemplo siguiente se usa la API plana de C.
Para obtener más información, consulte lo siguiente:

Actualización del estado de presencia enriquecida

En el ejemplo siguiente se establece la cadena de presencia enriquecida playingMap para el usuario. En este ejemplo, playingMap está configurada como una cadena estática sin tokens. xboxLiveContext es el XblContextHandle del usuario y queue es la cola de tareas del juego, o nullptr para usar la cola de tareas predeterminada del proceso.
Si la cadena de presencia configurada requiere cadenas de reemplazo explícitas, establezca presenceTokenIds en sus identificadores de cadena configurados en el orden de los marcadores de posición y establezca presenceTokenIdsCount en la longitud de la matriz. Si el miembro scid o presenceId está vacío, la solicitud solo incluye el estado activo o inactivo y no incluye ninguna cadena de presencia enriquecida. Para obtener más información, consulte lo siguiente:

Límites de velocidad y certificación

El servicio de presencia permite a cada usuario y título 3 escrituras en 15 segundos y 30 escrituras en 300 segundos. Actualice la presencia enriquecida cuando cambie la actividad del jugador y combine los cambios rápidos en una sola actualización. Si también actualiza la presencia enriquecida periódicamente, mantenga la velocidad combinada dentro de ambos límites. Si una llamada produce un error HTTP_E_STATUS_429_TOO_MANY_REQUESTS (XblErrorCondition::Http429TooManyRequests), no la reintente en un bucle. La respuesta del servicio incluye un encabezado Retry-After y XSAPI lo respeta. La prueba de certificación XR-132 rechaza un título cuya tasa de solicitudes es igual o superior a 10 veces el límite sostenido, es decir, 300 escrituras de presencia en 300 segundos. Este umbral no es un margen de funcionamiento seguro. Para obtener más información, consulte Limitación de velocidad específica.
Última modificación el 30 de octubre de 2026