Configuración de idiomas predeterminados - XBOX Game Development Documentation

PlayFab está introduciendo compatibilidad con el almacenamiento de cadenas localizadas en nombre de los desarrolladores de juegos. Además, estamos agregando la lógica necesaria para proporcionar a sus jugadores las cadenas correctas para el idioma que prefieran. Para lograrlo, aprovecharemos dos nuevas opciones de configuración de idioma: una está asociada a su título y la otra se almacena en cada uno de los perfiles de entidad de sus jugadores:

Idioma predeterminado del título: indica el idioma principal admitido por su título. Una vez establecido, requeriremos que su título admita este idioma para usarlo, al menos, en las características que usan cadenas localizadas.
Idioma del jugador: indica el idioma preferido del jugador. Se puede establecer por título.

Con estas dos opciones de configuración, la lógica de PlayFab hace coincidir las cadenas localizadas con los jugadores que prefieren ese idioma. Los jugadores sin preferencia de idioma reciben las cadenas en el idioma predeterminado especificado por su título.

Los jugadores con preferencia por un idioma que su título no admite reciben también las cadenas basadas en el idioma predeterminado de su título.

Este tutorial le guía por la configuración del idioma predeterminado de su título y del idioma preferido de sus jugadores.

Requisitos

En este tutorial se supone que tiene los siguientes conocimientos prácticos sobre el uso de PlayFab:

Conocimientos básicos sobre cómo crear un jugador. Esto es necesario porque los jugadores deben existir previamente con un nombre de usuario y una contraseña antes de llamar a la lógica de idioma preferido.
Que ha leído el inicio rápido de Game Manager. Si no está familiarizado con Game Manager, este es el lugar donde se ve la información de idioma.
Que tiene conocimientos sobre cómo trabajar con perfiles de jugador, ya que es necesario para confirmar que se ha agregado un idioma preferido al perfil de un jugador.
Dedique un momento a revisar la información proporcionada sobre cómo obtener el perfil de un jugador en el tutorial Obtención de perfiles de jugador.

Sección 1: Idioma preferido del jugador

Antes de establecer el idioma preferido de su jugador, decida cómo quiere recopilarlo. Tiene un par de opciones:

Preguntarles: agregue una opción en el menú de su juego.
Deducir su idioma: use el idioma del dispositivo del jugador llamando a la API de la plataforma proporcionada (por ejemplo, Locale.getDefault.getLanguage() para Android).

Existen muchos idiomas y es posible que su título no los admita todos. Aunque no es obligatorio, le recomendamos preparar su título para el futuro y almacenar la preferencia real del jugador. Si más adelante agrega compatibilidad con ese idioma, la lógica de PlayFab empezará a proporcionar automáticamente las nuevas cadenas (en lugar de las predeterminadas).

Paso 1: Establecer el idioma

PlayFab le permite elegir entre una lista específica de idiomas admitidos. Puede realizar una llamada al método GetLanguageList() para ver los códigos de idioma.

Al usar la API SetProfileLanguage, la cadena de idioma debe especificarse en el formato ISO 639-1 (por ejemplo, “en”, “es” o “ja”). En este momento, el código “zh” no se admite.

En primer lugar, actualizaremos el perfil de un jugador para incluir el idioma en el que preferiría recibir el contenido de su título.

Ejemplo de código de C#

void SetProfileLanguage(string language, int? profileExpectedVersion, EntityKey entity)
{
    var request = new SetProfileLanguageRequest
    {
        Language = language,
        ExpectedVersion = profileExpectedVersion,
        Entity = entity
    };
    PlayFabProfilesAPI.SetProfileLanguage(request, res =>
    {
        Debug.Log("The language on the entity's profile has been updated.");
    }, FailureCallback);
}

void FailureCallback(PlayFabError error)
{
    Debug.LogWarning("Something went wrong with your API call. Here's some debug information:");
    Debug.LogError(error.GenerateErrorReport());
}

Paso 2: Comprobar que se actualizó el idioma

Vaya a la información general del jugador. En Game Manager, vaya a Player > Overview. Compruebe que la sección de información de contacto se ha actualizado con su idioma preferido. El idioma también se puede actualizar con el menú desplegable Language que se muestra en la imagen siguiente.

Game Manager - Jugador - Información general - Correo electrónico de contacto - Idioma

A continuación, vaya al PlayStream del jugador y se mostrará un evento Entity language updated.

Game Manager - Jugadores - PlayStream - Evento Entity Language Updated

Seleccione el icono de información del evento y verá un JSON similar al del ejemplo siguiente.

{
    "EventName": "entity_language_updated",
    "Source": "PlayFab",
    "Language": "en",
    "EntityChain": "title_player_account!4CDA57A14A596E70/<YourTitleId>/C9458B4D3A115F4B/36163DA3783B0C8A/",
    "EntityLineage": {
        "NamespaceId": "4CDA57A14A596E70",
        "TitleId": "YourTitleId",
        "MasterPlayerAccountId": "C9458B4D3A115F4B",
        "TitlePlayerAccountId": "36163DA3783B0C8A",
        "CharacterId": null,
        "GroupId": null
    },
    "EventNamespace": "com.playfab",
    "EventId": "f643e22a2a76462aaeaa3469afa31434",
    "EntityType": "title_player_account",
    "EntityId": "36163DA3783B0C8A",
    "SourceType": "BackEnd",
    "Timestamp": "2018-08-24T18:49:47.8755292Z",
    "History": null,
    "CustomTags": null,
    "Reserved": null
}

Sección 2: Establecer un idioma predeterminado del título

A continuación, establezca un idioma predeterminado para su título. Todas las características de localización ahora asocian un idioma a cada versión traducida del contenido. El título requiere un idioma predeterminado. Esto garantiza que, si el idioma preferido de algún jugador no está establecido o no se admite, el jugador pueda seguir recibiendo la versión predeterminada del contenido. Para empezar, seleccione Settings en el menú de la izquierda, como se muestra a continuación.

Game Manager - Configuración - General - Idioma predeterminado

En la pestaña General, bajo el nuevo encabezado TITLE DEFAULTS, busque el menú desplegable Default language. Debe establecer un idioma predeterminado antes de poder usar cualquiera de las características de adición de localización. Cuando haya terminado, seleccione el botón SAVE. Aparecerá una notificación de mensaje si la actualización se realizó correctamente. Cuando vuelva al panel, verá un evento Title API settings changed en su lista de eventos de PlayStream, como se muestra a continuación.

Seleccione el icono de información del evento y verá un JSON similar al del ejemplo siguiente.

{
    "EventName": "title_api_settings_changed",
    "PreviousSettingsValues": {
        "DefaultLanguage": null
    },
    "SettingsValues": {
        "DefaultLanguage": "en"
    },
    "UserId": "EAF83D52E282C291",
    "DeveloperId": null,
    "EventNamespace": "com.playfab",
    "EntityType": "title",
    "Source": "PlayFab",
    "EventId": "108849a5e1424051b42256bc75b2e34b",
    "EntityId": "YourTitleId",
    "SourceType": "BackEnd",
    "Timestamp": "2018-08-24T21:51:02.2215614Z",
    "History": null,
    "CustomTags": null,
    "Reserved": null
}

Sección 3: Actualización del idioma predeterminado de un título

Es importante recordar que establecer un idioma predeterminado para su título indica a PlayFab que use ese idioma cuando emita comunicaciones a jugadores que no tienen establecido un idioma preferido o que han elegido un idioma que no coincide con uno que usted admita. Dado que el idioma predeterminado del título se usa como idioma de reserva, PlayFab espera que todas sus comunicaciones admitan su idioma predeterminado.

Siempre puede cambiar el idioma predeterminado de su título, pero PlayFab requiere que sus plantillas de comunicaciones actuales admitan el idioma al que va a cambiar.

Si actualiza el idioma predeterminado de su título, verá que la interfaz ahora muestra un vínculo Edit.

Valores predeterminados del título - Idioma predeterminado

Al seguir este vínculo, verá el mismo menú desplegable que antes. Sin embargo, si intenta guardar un idioma predeterminado que no es totalmente compatible con sus plantillas de correo electrónico, verá uno o varios mensajes de error como el que se muestra a continuación.

Game Manager - General - Editar idioma predeterminado

Si hay errores, puede seguir los vínculos proporcionados para actualizar su contenido a fin de que admita el idioma que falta. Cuando se hayan corregido todos los errores, se aceptará el cambio de idioma predeterminado.

Conclusión

En este tutorial, ha visto cómo establecer y actualizar el idioma predeterminado de su título y el idioma preferido de sus jugadores. Si tiene alguna pregunta o comentario sobre este tutorial, póngase en contacto con nosotros a través de nuestros foros o canal de Slack.

​Requisitos

​Sección 1: Idioma preferido del jugador

​Paso 1: Establecer el idioma

​Ejemplo de código de C#

​Paso 2: Comprobar que se actualizó el idioma

​Sección 2: Establecer un idioma predeterminado del título

​Sección 3: Actualización del idioma predeterminado de un título

​Conclusión

Requisitos

Sección 1: Idioma preferido del jugador

Paso 1: Establecer el idioma

Ejemplo de código de C#

Paso 2: Comprobar que se actualizó el idioma

Sección 2: Establecer un idioma predeterminado del título

Sección 3: Actualización del idioma predeterminado de un título

Conclusión