Información general sobre las tablas de clasificación basadas en eventos

Este tema describe cómo las tablas de clasificación comparan a los jugadores mostrando estadísticas seleccionadas de un juego. Las tablas de clasificación son una forma divertida de atraer a los jugadores y fomentar la competencia entre ellos. Los servicios XBOX proporcionan funcionalidad adecuada para los jugadores más exigentes (clasificación global frente a toda la población de XBOX) y para los jugadores ocasionales (clasificación social frente a los amigos de un jugador). Tiene a su disposición dos tipos de tablas de clasificación: globales y sociales. Tienen conceptos muy similares, pero presentan diferencias fundamentales en cuanto a configuración e intención.

​

Tablas de clasificación globales frente a sociales

​

Tablas de clasificación globales

• Una tabla de clasificación global clasifica a toda la base de usuarios de XBOX y debe configurarse.
• Una tabla de clasificación global es una vista predefinida que se configura en el servicio en el momento de la ingesta (ya sea antes del lanzamiento del título o en cualquier momento posterior).

​

Tablas de clasificación sociales

• Una tabla de clasificación social se genera dinámicamente y clasifica a los amigos del jugador.
• Una tabla de clasificación social solo incluye a los jugadores que están en el grafo social del jugador.
• Una tabla de clasificación social no necesita predefinirse en el momento de la ingesta, porque el servicio genera la tabla de clasificación dinámicamente en tiempo de ejecución, basándose en las estadísticas de usuario existentes.

​

Descripción de las tablas de clasificación

Las tablas de clasificación tienen dos componentes principales.

• Un valor con respecto al cual clasificar (en los servicios XBOX, siempre es una instancia de estadística del jugador).
• Un criterio de ordenación (los valores más altos o más bajos son mejores).

​

Estadísticas como valores de clasificación

Las tablas de clasificación se derivan de las estadísticas del jugador. Es fundamental tener definidas las reglas de estadísticas adecuadas para lo que necesite. Mientras diseña su juego, tenga presentes las tablas de clasificación en las que le gustaría que se clasificaran sus jugadores.

​

Tablas de clasificación globales

Las tablas de clasificación globales llevan el seguimiento de las mejores puntuaciones registradas por los jugadores de toda la comunidad de XBOX. La principal diferencia de las tablas de clasificación globales es que se predefinen en el momento de la ingesta especificando un nombre de identificación de la tabla de clasificación, la estadística clasificada y el criterio de ordenación (ascendente o descendente). Los títulos pueden definir un número ilimitado de tablas de clasificación globales y agregar más tablas de clasificación en cualquier momento mediante la configuración del servicio. El número máximo de registros por tabla de clasificación global está actualmente limitado a 10.000 entradas. Esto significa que, en el caso de los jugadores cuya “mejor” puntuación no está clasificada entre las 10.000 primeras, su puntuación no aparece en la tabla de clasificación. Es posible leer una “página” de hasta 100 entradas de la tabla de clasificación (XUID del jugador, gamertag, rango global y puntuación) cada vez y especificar el rango inicial de la página, o recuperar entradas de la tabla de clasificación centradas en torno a un gamertag especificado. Los resultados siempre abarcan todo el tiempo; todavía no se admiten las vistas por día, semana y mes. Se puede acceder a las tablas de clasificación globales a través de la API de servicios XBOX (XSAPI) o de nuestra API REST mediante GET (/scids/{scid}/leaderboards/{leaderboardname}). Esta es una captura de pantalla de cómo podría configurarse una tabla de clasificación de ejemplo para un juego de carreras.

​

Tablas de clasificación sociales

Las tablas de clasificación sociales son un gran incentivo para que los jugadores ocasionales se comparen y se clasifiquen frente a sus amigos. Aunque no estén en los rangos más altos de la comunidad, pueden sentirse motivados para superar a jugadores que conocen. Las tablas de clasificación sociales se crean dinámicamente a partir de cualquier estadística de usuario existente. Por lo tanto, no necesitan predefinirse en el momento de la ingesta y contienen solo a los jugadores del grafo social de un jugador específico. La principal ventaja de las tablas de clasificación sociales es que no están predefinidas. Puede crear una tabla de clasificación social para cualquier estadística de su juego. El autor de la llamada puede especificar dos cosas al solicitar una tabla de clasificación social: la instancia de estadística y el criterio de ordenación (el valor predeterminado es descendente por valoración). Los resultados siempre abarcan todo el tiempo; no se admiten las vistas por día, semana y mes. Al igual que con las tablas de clasificación globales, un autor de llamada puede leer una “página” de hasta 100 entradas de la tabla de clasificación (XUID del jugador, gamertag, rango global y puntuación) cada vez y especificar el rango inicial de la página. Se accede a las tablas de clasificación sociales a través de XSAPI o de nuestra API REST mediante GET (/users/xuid({xuid})/scids/{scid}/stats/{statname)/people/{all|favorite}).

​

Tablas de clasificación globales con vista social

Como las tablas de clasificación sociales se crean dinámicamente, recuperar una tabla de clasificación social tarda más que recuperar una tabla de clasificación global. En escenarios en los que el título recupera con frecuencia una tabla de clasificación social basada en un conjunto común de criterios, puede crear una tabla de clasificación global y recuperar solo las entradas de la tabla de clasificación que pertenecen al grafo social del jugador. Esto da como resultado un tiempo de recuperación más rápido que el de las tablas de clasificación sociales, porque la tabla de clasificación ya existe en los servidores de los servicios XBOX. También produce una carga más pequeña, porque los resultados se limitan al grafo social del usuario. Este tipo de tabla de clasificación es una tabla de clasificación global. Por lo tanto, debe definirse en la configuración del servicio del título. Se accede a las tablas de clasificación globales con vista social mediante la solicitud normal de tabla de clasificación global, GET (/scids/{scid}/leaderboards/{leaderboardname}), anexando la siguiente consulta a la dirección URL: &viewTarget=people&view=people. Para admitir vistas de tablas de clasificación de varias columnas, se pueden usar los metadatos de estadísticas. Un título puede definir campos de metadatos para una estadística de tabla de clasificación, que pueden devolverse al consultar los rangos de la tabla de clasificación. Un título no debe usar el URI por lotes de estadísticas de usuario para lograr el mismo comportamiento, porque la configuración de privacidad podría impedir el acceso a las estadísticas.

​

Tablas de clasificación de varias columnas

Habrá casos en los que necesite más columnas en una tabla de clasificación para dar más información a la estadística. Por ejemplo, para una tabla de clasificación de más enemigos derrotados, quizá quiera agregar el arma que usó el jugador, el mapa donde ocurrió, el tipo de enemigos más derrotados y la proporción de muertes causadas/sufridas. Las tablas de clasificación de XBOX tienen compatibilidad integrada con varias columnas. Puede obtener fácilmente estos tipos de clasificaciones. El único requisito previo es que la estadística usada para la tabla de clasificación tenga definido un contexto de estadística. Es lo que se usará como metadatos adicionales. Por ejemplo, para una estadística FastestLap, quizá quiera configurar estas propiedades adicionales como contexto de estadística. Esta es una captura de pantalla de cómo podrían verse. Ahora que la estadística se conservará con contexto, si recupera la tabla de clasificación de varias columnas, tendría un aspecto parecido al de la tabla siguiente. Las tablas de clasificación de varias columnas se admiten actualmente en las tablas de clasificación globales y en las tablas de clasificación globales con vista social. Sin embargo, si quiere crear una tabla de clasificación social de varias columnas, puede usar la llamada por lotes de estadísticas de usuario para obtener todas las estadísticas con su contexto y luego crear manualmente la tabla de clasificación. Solo se accede a las tablas de clasificación de varias columnas a través de nuestra API REST mediante la solicitud normal de tabla de clasificación global, GET (/scids/{scid}/leaderboards/{leaderboardname}), anexando la siguiente consulta a la dirección URL: &include=valuemetadata.

​

Dónde aparecen las tablas de clasificación con estadísticas destacadas

Las tablas de clasificación comparan a los jugadores mostrando estadísticas seleccionadas de un juego. Las tablas de clasificación son una excelente manera de fomentar la competencia entre sus jugadores. Las tablas de clasificación mantienen a los jugadores interesados en intentar superar su mejor puntuación anterior y las puntuaciones de sus amigos.

• Las tablas de clasificación de estadísticas destacadas siempre se muestran en el club oficial de un título.
• Las tablas de clasificación de estadísticas destacadas a veces se muestran en otras experiencias de XBOX, como la vista de logros de un jugador en su perfil.
• También puede usar sus estadísticas destacadas configuradas para crear tablas de clasificación dentro de su título.

​

Elección de buenas tablas de clasificación

Una tabla de clasificación corresponde a una estadística que haya definido. Debe elegir tablas de clasificación que correspondan a un logro que el jugador pueda esforzarse por mejorar. Por ejemplo, el mejor tiempo de vuelta en un juego de carreras es una buena tabla de clasificación, porque los jugadores quieren esforzarse por mejorar su mejor tiempo de vuelta. Otros ejemplos son la proporción de muertes causadas/sufridas en los juegos de disparos o el tamaño máximo de combo en un juego de lucha.

​

Cuándo mostrar las tablas de clasificación

Puede mostrar tablas de clasificación en cualquier momento en su título. Debe elegir un momento en el que la tabla de clasificación no interfiera con la jugabilidad ni con el flujo de su título. Por ejemplo, entre rondas y después de las partidas son buenos momentos para mostrar tablas de clasificación.

​

Guía de programación

Hay varias API de tablas de clasificación que puede usar para obtener el estado actual de una tabla de clasificación. Todas las API son asincrónicas y no se bloquean. Realice una solicitud para obtener los datos de la tabla de clasificación y continúe con el procesamiento habitual del juego. Cuando el servicio devuelva los resultados de la tabla de clasificación, puede mostrarlos en el momento adecuado. Solicite los datos de la tabla de clasificación al servicio con algo de antelación respecto al momento en que quiera mostrarlos. Esto evita que los jugadores queden bloqueados mientras esperan a que se muestre la tabla de clasificación.

​

Consulte también

Estadísticas basadas en eventos frente a estadísticas administradas por el título.