Inicio de sesión en Partner Center
Los ejemplos siguientes usan Partner Center para configurar experiencias de juego de XBOX. Después de que su empresa tenga un acuerdo para crear productos para XBOX, configure su contenido en Partner Center. Si su empresa aún no tiene acceso a Partner Center y está desarrollando un juego, póngase en contacto con su administrador de cuentas de Microsoft. Si está desarrollando una aplicación, póngase en contacto con XBOX App Partner Requests (xboxapps@microsoft.com). Si está trabajando con el programa ID@XBOX, póngase en contacto con ID Setup (idsetup@microsoft.com). El programa ID@XBOX permite a los desarrolladores de juegos cualificados de todos los tamaños dar rienda suelta a su creatividad mediante la autopublicación de juegos digitales en XBOX One (o posterior). Esto proporciona a los estudios las herramientas y el soporte que necesitan para ayudar a maximizar su éxito. Para obtener más información, vaya a https://www.xbox.com/Developers. Después de tener acceso a Partner Center, necesitará que Microsoft cree un grupo de productos para su juego. Su administrador de cuentas de Microsoft puede ayudarle con este proceso. Después de que Microsoft haya creado un grupo de productos para su juego, use Partner Center para configurar los servicios de XBOX para su juego. La configuración de los servicios de XBOX para su juego también se denomina su configuración de servicios. Siga estos pasos para ir a la ubicación de Partner Center donde puede agregar los eventos, las estadísticas, los logros y las tablas de clasificación de su juego.- Inicie sesión en su cuenta en Partner Center.
- Seleccione el grupo de productos que contiene o contendrá su juego.
- En la página Product Group, seleccione su juego o seleccione Add New Product para crear una nueva entrada.
- Si está creando un producto nuevo, escriba un nombre para el producto.
- Para el acceso a recursos, seleccione Exclusive Resource Access (ERA).
- Elija si necesita producir medios físicos para el juego o si solo será una descarga digital.
- Seleccione Create Product.
- En la parte inferior del panel izquierdo, expanda el sandbox en el que se creó su producto. Las configuraciones de servicios se definen en el nivel de sandbox. Si exporta su producto a otro sandbox, también debe exportar su configuración de servicios.
- En el submenú del sandbox, seleccione Service Configuration. Use esta página para configurar los servicios de XBOX para su título en el sandbox actual.
Identificación y definición de los eventos para sus escenarios
En Partner Center, antes de poder definir las reglas que implementan las experiencias de jugador que queremos lograr, debemos identificar y definir los eventos que impulsarán esas experiencias. En el modelo basado en eventos, los logros y las tablas de clasificación se basan en estadísticas de jugador. Por lo tanto, podemos observar las estadísticas que definiremos para ver qué eventos deberá enviar nuestro título. Para impulsar las experiencias que definiremos en este ejemplo, usaremos un evento que enviamos al final de cada vuelta en una carrera. Llamemos a este eventoLapCompleted. Usaremos este evento para impulsar nuestras experiencias personalizadas. Para impulsar esas experiencias, también definiremos los campos siguientes como parte de nuestro evento LapCompleted.
- LapTime: un campo que indica el tiempo en minutos para completar una vuelta.
- CarModel: un campo de cadena que indica el modelo del coche que se usa para completar la vuelta.
- WeatherCondition: un campo de cadena que identifica la condición meteorológica de la pista cuando se completó la vuelta.
- TrackId: el identificador de la pista en la que se completó la vuelta.
- En Partner Center, en el panel izquierdo, seleccione Test Sandbox > Service Configuration > Events & Stat Rules.
-
Seleccione New para crear un evento nuevo. Aparece el cuadro de diálogo Add New Event, que se muestra a continuación.

- Seleccione Base en Base Event.
- Escriba LapCompleted en Event Name.
- Opcionalmente, escriba una descripción para el evento en Description.
- Seleccione Add Event Field.
-
Escriba LapTime en Field Name y, a continuación, especifique el Type como Double, como se muestra a continuación.

- Seleccione Add Event Field.
-
Repita el proceso para agregar los campos de evento siguientes.
- CarModel: UnicodeString
- WeatherCondition: UnicodeString
- TrackId: Int32

- Seleccione Save Event para guardar el evento en su sandbox.
Diseño de reglas de estadísticas
Ahora que hemos definido las experiencias de jugador, podemos empezar a crear las reglas de estadísticas que implementan esas experiencias. Dado que usamosLapTime para los tres escenarios (estadísticas destacadas, logros y tablas de clasificación), lo configuraremos primero.
Esta estadística se mostrará como una estadística destacada (también conocida como estadística principal) y también se usará para una tabla de clasificación global con metadatos adicionales.
El juego desencadena eventos en el juego cuando ocurren determinadas acciones en él y se consideran los datos sin procesar para crear estadísticas. Cada evento debe crear o actualizar al menos una estadística.
(Para obtener más información sobre cómo generar varias estadísticas en un único evento, consulte Información general sobre las estadísticas basadas en eventos).
- En la página Events & Stat Rules, seleccione el evento LapCompleted en la lista de eventos.
-
Seleccione New (a la derecha de Stat Rules) para crear una nueva regla de estadística. Se basará en el evento seleccionado. Aparece el cuadro de diálogo Add Stat Rule, que se muestra a continuación.

- Escriba FastestLap en Stat Rule Name.
- Dado que queremos que otras aplicaciones y títulos accedan a las estadísticas creadas por esta regla, active la casilla Open read access to any title. Las reglas de estadísticas tienen una lógica que define cómo el evento crea o actualiza la estadística. Dado que queremos hacer un seguimiento de la vuelta más rápida, solo queremos actualizar el valor de la estadística si el nuevo tiempo de vuelta es inferior al tiempo de vuelta más rápido existente.
-
Para ello, seleccione Min en Operator y LapTime en Parameter, como se muestra a continuación.

- Para agregar el campo a los metadatos, seleccione CarModel y, a continuación, seleccione Add Event Field.
-
Repita esto para los campos WeatherCondition y TrackId, como se muestra a continuación.

- Seleccione Add Stat Rule para crear la regla de estadística.
Configuración de estadísticas destacadas, tablas de clasificación y logros
Estadísticas destacadas
Ahora que la regla de estadística está completa, queremos que la estadística aparezca en la pestaña de logros de GameHub. Por lo tanto, debemos configurar una estadística destacada (conocida como estadística principal, o hero stat, en Partner Center).- En Partner Center, en el panel izquierdo, seleccione Test Sandbox > Service Configuration > Hero Stats.
- Seleccione New para agregar una nueva estadística destacada/principal.
- Escriba Fastest Lap en Hero Stat Display Name.
- Seleccione ShortTimespan en Display Format. Seleccione Seconds en Display Units.
- Seleccione Best en Display Semantic. Esto indica a las aplicaciones complementarias que el valor representa la mejor puntuación de la estadística.
-
Seleccione Select an Instance y, a continuación, seleccione FastestLap en Stat Instance. Esto indica que la estadística destacada se basa en el valor de la estadística
FastestLap. - Escriba 1 en Ordinal. Esto indica que esta estadística destacada debe mostrarse en primer lugar al enumerar las estadísticas destacadas.
-
Seleccione Ascending en Sort Order. Esto indica que los valores más bajos son mejores que los más altos, como se muestra a continuación.

- Seleccione Add New Hero Stat para crear la estadística destacada/principal.
Tabla de clasificación global
Con la misma estadística de tiempo de vuelta, podemos configurar una tabla de clasificación para que cada jugador pueda ver cómo se clasifica su tiempo de vuelta frente a todos los demás jugadores del mundo.- En Partner Center, en el panel izquierdo, seleccione Test Sandbox > Service Configuration > Leaderboards.
- Seleccione New para crear una nueva tabla de clasificación global.
- Escriba FastestLap en Leaderboard ID.
- Seleccione Select an Instance, seleccione la regla de estadística FastestLap que creamos anteriormente y, a continuación, seleccione Add Stat Instance.
-
Seleccione Ascending en Sort, como se muestra a continuación. Esta selección indica que los tiempos más bajos son mejores.

- Seleccione Add New Leaderboard para crear una nueva tabla de clasificación global.
Logros basados en eventos
Se recomienda usar logros administrados por el título. Sin embargo, para los títulos que todavía usan logros basados en eventos, puede usar eventos para impulsar el desbloqueo de logros en el servicio, como se indica a continuación. Para usar eventos para desbloquear logros basados en eventos- En Partner Center, en el panel izquierdo, seleccione Test Sandbox > Service Configuration > Achievements & Challenges.
- Seleccione New para agregar un logro nuevo.
- Escriba Under 60 seconds en Achievement Name.
- Escriba Completed a lap in under 60 seconds en Description. Esta descripción se muestra a los jugadores cuando se desbloquea el logro.
- Escriba Complete a lap in under 60 seconds en Not Achieved Description. Esta descripción se muestra a los jugadores cuando el logro todavía está bloqueado.
-
Cargue un archivo .png de 1920 × 1080 píxeles que sirva como Achievement Icon, como se muestra a continuación.

- Seleccione Add Achievement para crear el logro.
- Asegúrese de que el logro Under 60 seconds esté seleccionado en la lista de logros. Seleccione New a la derecha de Rewards para dar al jugador una recompensa por desbloquear el logro.
- Dé al jugador 20 puntos de gamerscore por desbloquear este logro. En Reward Type, seleccione Gamerscore.
-
Escriba 20 en Value, como se muestra a continuación.

- Seleccione Add Reward.
- Asegúrese de que el logro Under 60 seconds siga seleccionado en la lista de logros. Seleccione New a la derecha de Rules para definir las condiciones que desbloquean el logro.
- Escriba Under 60 seconds rule en Rule Name. El jugador no ve este valor, por lo que puede llamarlo como quiera.
- Seleccione Min en Action. Esto indica que el logro se desbloquea cuando la instancia de estadística seleccionada es menor o igual que el valor de umbral.
- Escriba 60 en Threshold.
- Seleccione Select an Instance, seleccione la regla de estadística FastestLap y, a continuación, seleccione Add Stat Instance.
-
Seleccione Add Rule para crear la regla para el logro, como se muestra a continuación.

Adición de código para enviar el evento desde su juego
Ahora que hemos definido el eventoLapCompleted que los servicios de XBOX usarán para actualizar nuestros escenarios de jugador, debemos agregar código al juego para enviar el evento cuando un jugador complete una vuelta de carrera en el juego.
Para escribir un evento, llame a la función XblEventsWriteInGameEvent con el nombre de evento LapCompleted.
API de C plana
