Skip to main content
Este artículo describe cómo se configuran las cadenas de presencia enriquecida.

Cadenas

Para sus cadenas de presencia enriquecida, debe definir los conjuntos de cadenas. Se recomienda dar a cada conjunto de cadenas un nombre descriptivo para usarlo como identificador. Cada conjunto de cadenas que cree debe contener un grupo de cadenas localizadas adecuadamente para las configuraciones regionales en las que se publicará el juego. Además de las cadenas localizadas, también debe proporcionar una cadena neutra respecto a la referencia cultural. Esta cadena se usa si se realiza una solicitud para una configuración regional que no está presente. Cada conjunto de cadenas también puede usar datos del juego mediante la parametrización de las cadenas para mejorarlas aún más. Un conjunto de cadenas puede tener tantos parámetros como desee si las cadenas resultantes no superan los límites de caracteres. Para obtener más información, consulte Directivas y límites para las cadenas de presencia enriquecida.

Enumeraciones

Las enumeraciones que se describen a continuación se definen mediante los eventos de los datos de jugador de XBOX.

Estadísticas

Puede usar valores estadísticos numéricos basados en eventos en sus cadenas de presencia enriquecida. Por ejemplo, en un juego de disparos, es posible que desee que la cadena de presencia enriquecida muestre cuántas bajas tiene el jugador actualmente. La configuración debe mostrar que el parámetro se sustituye por la estadística “Kill Count”. Se creó mediante el sistema de eventos de esquema común y se pasa o reenvía al servicio de estadísticas de jugador de XBOX para convertirse en datos de jugador. La estadística debe definirse mediante la configuración de estadísticas. Cuando otro jugador lee la cadena, el servicio de presencia enriquecida recupera el valor más actualizado de la estadística “Kill Count”. Como resultado, la cadena siempre está actualizada. Las cadenas de presencia enriquecida con variables solo son compatibles con estadísticas numéricas basadas en eventos, no con estadísticas administradas por el título.

Estado

También puede optar por usar estadísticas que representen valores de estado reales en sus cadenas de presencia enriquecida. Por ejemplo, en un juego de carreras, podría usar una cadena de presencia enriquecida para mostrar qué coche está conduciendo actualmente el jugador o en qué mapa o circuito está corriendo. Para configurar la información de estado
  1. Defina enumeraciones para cualquier cadena del juego. Por ejemplo, si tiene cinco mapas en su juego y quiere que esos mapas formen parte de sus cadenas de presencia enriquecida, los cinco mapas también deben enumerarse en cadenas localizadas.
  2. Vincule las enumeraciones a las estadísticas. El servicio de presencia enriquecida vuelve a recuperar el valor más actualizado de los datos de jugador consultando el valor de la estadística. A continuación, el servicio determina a qué valor de enumeración se traduce la estadística.

Juego de ejemplo

Para el resto del ejemplo, suponga que está trabajando en el último juego de patear cubos. Quiere crear una estadística para cada tipo de cubo pateado y, a continuación, mostrar las estadísticas mediante cadenas de presencia enriquecida. Suponga que las reglas del juego son las siguientes:
  • Los tipos de cubo son de madera, plata y oro.
  • Las ubicaciones son las montañas, el desierto y la playa.
  • Cuando se patea un cubo, este se rompe. El jugador siempre debe buscar más cubos.
  • Algunos cubos requieren equipamiento especial para patearlos con éxito. Por ejemplo, una bota debe ser lo suficientemente fuerte como para resistir una patada.
  • El juego tiene un modo multijugador. Si hay suficientes jugadores intentando patear un cubo al mismo tiempo, no se necesita una bota concreta.
La configuración de las cadenas de presencia enriquecida para este juego es la siguiente.

Configuración de estadísticas para la presencia enriquecida

Para usar una estadística generada por los datos de jugador de XBOX en sus cadenas de presencia enriquecida, proporcione los nombres del servicio de presencia enriquecida.

Ejemplo de configuración de enumeraciones

Este es un ejemplo de definición de un par de enumeraciones.
  1. Cree una enumeración para los mapas del juego. El juego tiene tres mapas. Cada uno recibe un nombre descriptivo para poder hacer referencia a ellos fácilmente.
  2. Para cada configuración regional, cree una cadena localizada para ese nombre de mapa. Observe que hay una localización predeterminada general y una neutra respecto a la referencia cultural.
  3. Considere las tres armas del juego. Tienen nombres descriptivos y cadenas localizadas. Esto se aplica a todas las enumeraciones.

Ejemplo de configuración de cadenas

Ahora que se han definido las enumeraciones y las estadísticas, cree sus cadenas. En la siguiente tabla de ejemplo, la primera columna es un nombre descriptivo que ayuda a hacer referencia a un conjunto de cadenas frente a otro. En este ejemplo, la cadena “playingMap” se usa para el primer conjunto de cadenas, “totalKicked” para el segundo y “multiplayer” para el tercero.

Pares de configuración regional y cadena

Las dos columnas siguientes van juntas. Son los pares de configuración regional y cadena de la cadena de presencia enriquecida. En el primer ejemplo, se usa la cadena “Playing on ” en inglés. El token se sustituye por un valor. A continuación, la cadena se localiza para otras configuraciones regionales. Al igual que en las enumeraciones, debe haber una cadena predeterminada y cadenas neutras respecto a la referencia cultural. Se usan cuando un jugador emplea una configuración regional para la que no se ha especificado un par de configuración regional y cadena. Las configuraciones regionales que se usan para las enumeraciones deben coincidir con las configuraciones regionales de sus cadenas.

Parámetros para construir una cadena

La última columna es para los parámetros que se usan para rellenar los espacios en blanco de la cadena de presencia enriquecida. Si desea que el servicio de presencia busque el valor del parámetro en el servicio de estadísticas, debe usar aquí el nombre de la estadística para hacer referencia al parámetro. Usar estadísticas en sus cadenas le permite establecerlas una sola vez. No tiene que reescribirlas. Si su cadena contiene el nombre del mapa y usa la estadística CurrentMap para rellenar el espacio en blanco, el servicio de presencia enriquecida actualiza la cadena adecuadamente a medida que los jugadores viajan de mapa en mapa en el juego. Si no usa estadísticas en sus cadenas de presencia enriquecida, no se puede especificar ningún parámetro. En la siguiente tabla de ejemplo, use el mapa actual generado por las estadísticas en la primera cadena. Use la estadística BucketsKicked en la segunda cadena. El tercer ejemplo no incluye parámetros. La cadena se define por sí sola; no hace referencia a estadísticas. No hay límite en cuanto al número de cadenas que puede crear, pero debe tener al menos una cadena para su juego. BucketsKicked es simplemente un número que se sustituye en su cadena. CurrentMap es un ejemplo de estadística en la que la cadena procede de la enumeración. Cuando su juego establezca la presencia enriquecida en una de estas cadenas, use la configuración para saber qué parámetros se necesitan.
Última modificación el 28 de agosto de 2026