Conceptos básicos
RTA usa sesiones de WebSocket para crear una conexión persistente con el cliente. Así es como el servicio le entrega las estadísticas. Cuando un cliente envía una solicitud de conexión autenticada, RTA usa el token proporcionado para comprobar que la conexión puede establecerse y, a continuación, la establece. Una vez establecida la conexión, la aplicación puede realizar solicitudes para suscribirse a estadísticas específicas. Si la suscripción se realiza correctamente, RTA devuelve el valor actual y algunos metadatos adicionales, como el tipo de estadística, como parte de la carga de la respuesta. RTA reenvía cualquier actualización de estadísticas que se produzca mientras el cliente está suscrito. Cuando el título no requiere actualizaciones en tiempo real de una estadística, deja de realizar el seguimiento de esa estadística.Desconexión
Cuando el token de autenticación de un usuario expira, el servicio finaliza la sesión. El título debe actuar en consecuencia cuando esto ocurra. Las conexiones de RTA se cierran después de dos horas por diseño, lo que obliga al cliente a reconectarse. Esto se debe a que el token de autenticación de la conexión se almacena en caché para ahorrar ancho de banda de mensajes. Con el tiempo, ese token expira. Al cerrar la conexión y obligar al cliente a reconectarse, el cliente actualiza el token de autenticación. La API de los servicios XBOX (XSAPI) se encarga de la actualización del token de autenticación para el título reconectándose proactivamente a RTA y volviendo a enviar las suscripciones después de 90 minutos. Un cliente puede desconectarse debido a problemas con el ISP del usuario, o cuando el proceso del título se suspende. En cada uno de estos casos, si el título se ha registrado para los eventos de cambio de estado de conexión de RTA, se genera un evento de desconexión.En general, no se requiere ninguna acción por parte del título tras la desconexión, pero es posible que el título quiera actualizar la interfaz de usuario para reflejar que se ha perdido la conectividad con RTA.
Si un cliente usa RTA para sesiones multijugador y se desconecta durante 30 segundos, el Multiplayer Session Directory (MPSD) detecta que la sesión de RTA está cerrada y expulsa al usuario de la sesión. XSAPI restablece automáticamente la conexión de RTA, pero es responsabilidad del título reescribir sus sesiones de MPSD una vez restablecida la suscripción a RTA.
Cancelación de suscripciones
No se recomienda realizar el seguimiento de estadísticas cuyas actualizaciones en tiempo real no sean necesarias. Cada estadística de la que se realiza seguimiento corresponde a una suscripción de RTA, y el servicio limita el número de suscripciones que un usuario puede tener por título. Si se suscribe a todo, podría alcanzar ese límite, lo que impide la posibilidad de suscribirse a estadísticas importantes. Por ejemplo, es posible que el título solo necesite actualizaciones de una estadística dentro de una escena determinada. Cuando el usuario entra en esa escena, el título debe realizar el seguimiento de esa estadística. Cuando el usuario sale de esa escena, el título debe dejar de realizar el seguimiento de esa estadística. De forma similar, si las estadísticas cambian, las notificaciones no son necesarias. Al quitar todos los controladores de cambio de estadísticas, XSAPI desmonta automáticamente las suscripciones de RTA relacionadas. Para obtener más información sobre los límites de suscripción, consulte la sección Límites más adelante en este tema.Tenga en cuenta los elementos latentes en la cola
Al cancelar la suscripción a una estadística, es posible que haya una actualización de la estadística que todavía esté en proceso de llegar al cliente. Por lo tanto, aunque el título acabe de cancelar la suscripción a una estadística, tenga en cuenta que todavía puede recibir una o dos actualizaciones relacionadas con esa estadística. Se recomienda ignorar las actualizaciones de estadísticas cuando no se reconozca el identificador de suscripción.Ignore los mensajes que no entienda
El protocolo de mensajes puede actualizarse. Para mantener la aplicación independiente de cualquier mensaje nuevo, se recomienda que el título descarte los tipos de mensaje desconocidos.Límites
RTA aplica un límite deUserStats de 1000 y un límite de Presence de 2500.
Si un cliente alcanza el límite, recibe un error como parte de una llamada de suscripción o de cancelación de suscripción, o bien se desconecta.
En cualquiera de los casos, junto con el mensaje de error o de desconexión, el cliente dispone de más información sobre la limitación que se ha alcanzado.
Al desarrollar el título, tenga en cuenta estos conceptos. Si hace algo extremo,
la experiencia de la aplicación puede degradarse porque el servicio puede limitar sus llamadas.
En la versión actual de RTA, puede tener 1000 suscripciones a estadísticas por instancia de una aplicación.
Además, una instancia de una aplicación también puede suscribirse a la longitud completa de la lista de amigos de un usuario para las actualizaciones de presencia.
Este número podría cambiar en versiones futuras.