Inicio rápido de datos del título

Los datos del título son el conjunto de pares clave-valor de texto sin formato que se usan para almacenar y administrar los datos de configuración del juego de forma remota en el servidor. Mantienen accesibles y organizadas las variables de configuración de todo el título, que se pueden recuperar en el lado cliente. Este inicio rápido describe cómo crear y usar mediante programación los datos del título. Se trata de un tema importante porque almacenar los datos de configuración de un juego de forma remota en el servidor, donde se pueden cambiar en cualquier momento, es una de las razones más básicas para usar un servicio como PlayFab.

Obtención de los datos del título

Desde el cliente del juego

Use GetTitleData de PlayFabClientAPI para obtener los pares clave-valor de un título específico. El siguiente ejemplo de código muestra los valores de todos los datos del título.

public void ClientGetTitleData() {
    PlayFabClientAPI.GetTitleData(new GetTitleDataRequest(),
        result => {
            if(result.Data == null || !result.Data.ContainsKey("MonsterName")) Debug.Log("No MonsterName");
            else Debug.Log("MonsterName: "+result.Data["MonsterName"]);
        },
        error => {
            Debug.Log("Got error getting titleData:");
            Debug.Log(error.GenerateErrorReport());
        }
    );
}

Desde el servidor del juego

Use GetTitleData de PlayFabServerAPI para obtener los pares clave-valor de un título específico. El siguiente ejemplo de código muestra los valores de todos los datos del título.

public void ServerGetTitleData() {
    PlayFabServerAPI.GetTitleData( new GetTitleDataRequest(),
        result => {
            if (result.Data == null || !result.Data.ContainsKey("MonsterName")) Debug.Log("No MonsterName");
            else Debug.Log("MonsterName: " + result.Data["MonsterName"]);
        },
        error => {
            Debug.Log("Got error getting titleData:");
            Debug.Log(error.GenerateErrorReport());
        });
}

Establecimiento de los datos del título

Es poco probable que los datos del título cambien con mucha frecuencia. En la mayoría de las situaciones, debería usar los datos del título para datos estáticos que en gran medida no cambian durante la vida del título. Puede establecer los datos del título mediante Game Manager o mediante una función de la API de servidor.

Establecimiento de los datos del título mediante Game Manager

Para agregar datos principales del título a un título mediante Game Manager, siga estos pasos.

Abra el título en Game Manager.
Seleccione Content y, después, Title Data.
Seleccione New Title Data.
En la nueva página de datos del título, escriba un valor para la clave (Key) y un valor para el valor (Value). Tanto la clave como el valor se almacenan como cadenas.
Use el botón Save para guardar el nuevo elemento de datos.

Establecimiento de los datos del título mediante una llamada a la API de servidor en C

La API SetTitleData es una API de servidor a la que debe llamar desde un servidor dedicado. Solo puede establecer un par clave-valor de datos del título en cada llamada a SetTitleData.

public void SetTitleData() {
    PlayFabServerAPI.SetTitleData(
        new SetTitleDataRequest {
            Key = "MonsterName",
            Value = "Dorf"
        },
        result => Debug.Log("Set titleData successful"),
        error => {
            Debug.Log("Got error setting titleData:");
            Debug.Log(error.GenerateErrorReport());
        }
    );
}

Establecimiento de invalidaciones de datos del título mediante Game Manager

Una invalidación es también un conjunto de pares clave-valor JSON y, en principio, debería destinarse a contener el cambio diferencial necesario en los pares clave-valor de los datos principales del título. El cambio diferencial puede consistir, en comparación con los datos principales del título, en pares clave-valor nuevos, en un cambio del valor de una clave existente o en la eliminación de una clave (con NULL como entrada del valor). Para agregar invalidaciones a los datos principales del título, siga estos pasos.

Abra el título en Game Manager.
Seleccione Content y, después, Title Data.
Seleccione New Override.
Escriba la etiqueta de la invalidación y, además, escriba un valor para la clave (Key) y un valor para el valor (Value). Tanto la clave como el valor se almacenan como cadenas.
Use el botón Save para guardar la nueva invalidación de datos del título.

Por ahora, este conjunto de invalidación de pares clave-valor solo entra en vigor mediante los experimentos.

Si el jugador pertenece a una variante de experimento que contiene invalidaciones de datos del título, las invalidaciones se aplican automáticamente en el lado servidor y se devuelven con los datos del título en el lado cliente.

Los valores de las invalidaciones de datos del título pueden tardar hasta un minuto en actualizarse y conservarse.

Datos internos del título

De forma similar a los datos de usuario, los datos del título tienen un almacenamiento interno que está oculto para el cliente. Estos datos también se pueden establecer en Game Manager o mediante una API de servidor.

Obtención de los datos internos del título mediante una llamada a la API de servidor en C #

public void GetTitleInternalData()
{
    PlayFabServerAPI.GetTitleInternalData( new GetTitleDataRequest(),
        result => {
            if (result.Data == null || !result.Data.ContainsKey("PlayFab")) Debug.Log("No PlayFab");
            else Debug.Log("PlayFab: " + result.Data["PlayFab"]);
        },
        error => {
            Debug.Log("Got error getting titleData:");
            Debug.Log(error.GenerateErrorReport());
        }
    );
}

Establecimiento de los datos internos del título mediante una llamada a la API de servidor en C #

public void SetTitleInternalData() {
    PlayFabServerAPI.SetTitleInternalData(
        new SetTitleDataRequest {
            Key = "PlayFab",
            Value = "{ \"Status\": \"Secretly Awesome\" }"
        },
        result => { Debug.Log("Set titleData successful"); },
        error =>
        {
            Debug.Log("Got error setting titleData:");
            Debug.Log(error.GenerateErrorReport());
        });
}

XBOX Services

PlayFab

Obtención de los datos del título

Desde el cliente del juego

Desde el servidor del juego

Establecimiento de los datos del título

Establecimiento de los datos del título mediante Game Manager

Establecimiento de los datos del título mediante una llamada a la API de servidor en C

Establecimiento de invalidaciones de datos del título mediante Game Manager

Datos internos del título

Obtención de los datos internos del título mediante una llamada a la API de servidor en C #

Establecimiento de los datos internos del título mediante una llamada a la API de servidor en C #

Consulte también

​Obtención de los datos del título

​Desde el cliente del juego

​Desde el servidor del juego

​Establecimiento de los datos del título

​Establecimiento de los datos del título mediante Game Manager

​Establecimiento de los datos del título mediante una llamada a la API de servidor en C

​Establecimiento de invalidaciones de datos del título mediante Game Manager

​Datos internos del título

​Obtención de los datos internos del título mediante una llamada a la API de servidor en C #

​Establecimiento de los datos internos del título mediante una llamada a la API de servidor en C #

​Consulte también

Obtención de los datos del título

Desde el cliente del juego

Desde el servidor del juego

Establecimiento de los datos del título

Establecimiento de los datos del título mediante Game Manager

Establecimiento de los datos del título mediante una llamada a la API de servidor en C

Establecimiento de invalidaciones de datos del título mediante Game Manager

Datos internos del título

Obtención de los datos internos del título mediante una llamada a la API de servidor en C #

Establecimiento de los datos internos del título mediante una llamada a la API de servidor en C #

Consulte también