Definir idiomas padrão - XBOX Game Development Documentation

O PlayFab está introduzindo o suporte ao armazenamento de cadeias de caracteres localizadas em nome dos desenvolvedores de jogos. Além disso, estamos adicionando a lógica necessária para fornecer aos seus jogadores as cadeias de caracteres corretas para o idioma de preferência deles. Para isso, usaremos duas novas configurações de idioma: uma associada ao seu título e outra armazenada no perfil de entidade de cada um dos seus jogadores:

Idioma padrão do título: indica o principal idioma compatível com o seu título. Depois de definido, exigiremos que seu título ofereça suporte a esse idioma para ser usado pelo menos nos recursos que usam cadeias de caracteres localizadas.
Idioma do jogador: indica o idioma preferencial do jogador. Isso pode ser definido por título.

Usando essas duas configurações, a lógica do PlayFab corresponde as cadeias de caracteres localizadas aos jogadores que preferem esse idioma. Os jogadores sem preferência de idioma recebem as cadeias de caracteres no idioma padrão especificado do seu título.

Os jogadores com preferência por um idioma que seu título não oferece suporte também recebem cadeias de caracteres, com base no idioma padrão do seu título.

Este tutorial mostra como definir o idioma padrão do seu título e o idioma preferencial dos seus jogadores.

Requisitos

Este tutorial pressupõe que você tenha o seguinte conhecimento prático sobre o uso do PlayFab:

Um conhecimento básico de como criar um jogador. Isso é necessário, pois os jogadores precisam já existir com nome de usuário e senha antes de chamar a lógica de idioma preferencial.
Que você tenha lido o Início rápido do Game Manager. Se você não estiver familiarizado com o Game Manager, é nele que as informações de idioma são exibidas.
Que você saiba trabalhar com perfis de jogador, pois é necessário confirmar que um idioma preferencial foi adicionado ao perfil de um jogador.
Reserve um momento para revisar as informações fornecidas sobre como obter o perfil de um jogador no tutorial Obter perfis de jogador.

Seção 1: idioma preferencial do jogador

Antes de definir o idioma preferencial do jogador, descubra como você deseja coletá-lo. Você tem algumas opções:

Perguntar: adicione uma opção no menu do seu jogo.
Deduzir o idioma: use o idioma do dispositivo do jogador chamando a API de plataforma fornecida (por exemplo, Locale.getDefault.getLanguage() no Android).

Existem muitos idiomas, e seu título talvez não ofereça suporte a todos eles. Embora não seja obrigatório, recomendamos preparar seu título para o futuro e armazenar a preferência real do jogador. Se você adicionar suporte a esse idioma mais tarde, a lógica do PlayFab começará automaticamente a fornecer as novas cadeias de caracteres (em vez das padrão).

Etapa 1: definir o idioma

O PlayFab permite escolher em uma lista específica de idiomas para oferecer suporte. Você pode fazer uma chamada ao método GetLanguageList() para ver os códigos de idioma.

Ao usar a API SetProfileLanguage, a cadeia de caracteres de idioma deve ser especificada no formato ISO 639-1 (por exemplo, “en”, “es” ou “ja”). No momento, o código “zh” não tem suporte.

Primeiro, atualizaremos o perfil de um jogador para incluir o idioma no qual ele prefere receber o conteúdo do seu título.

Exemplo de código em 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());
}

Etapa 2: verificar se o idioma foi atualizado

Acesse a visão geral do jogador. No Game Manager, acesse Player > Overview. Verifique se a seção de informações de contato foi atualizada com o idioma preferencial. O idioma também pode ser atualizado com o menu suspenso Language exibido na imagem a seguir.

Game Manager: Player: Overview: email de contato: idioma

Em seguida, navegue até o PlayStream do jogador, que mostrará um evento Entity language updated.

Game Manager: Players: PlayStream: evento Entity Language Updated

Selecione o ícone de informações no evento e veja um JSON semelhante ao exemplo abaixo.

{
    "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
}

Seção 2: definir um idioma padrão do título

Em seguida, defina um idioma padrão para o seu título. Todos os recursos de localização agora associam um idioma a cada versão traduzida do conteúdo. O título exige um idioma padrão. Isso garante que, se o idioma preferencial de algum jogador não estiver definido ou não tiver suporte, o jogador ainda possa receber a versão padrão do conteúdo. Para começar, selecione Settings no menu à esquerda, conforme mostrado abaixo.

Game Manager: Settings: General: idioma padrão

Na guia General, no novo cabeçalho TITLE DEFAULTS, localize a lista suspensa Default language. Você precisa definir um idioma padrão antes de poder usar qualquer um dos recursos de localização. Ao terminar, selecione o botão SAVE. Uma notificação será exibida se a atualização tiver êxito. Ao retornar ao painel, você verá um evento Title API settings changed na lista de eventos do PlayStream, conforme mostrado abaixo.

Selecione o ícone de informações no evento e veja um JSON semelhante ao exemplo abaixo.

{
    "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
}

Seção 3: atualizar o idioma padrão do título

É importante lembrar que definir um padrão para o seu título informa ao PlayFab para usar esse idioma ao enviar comunicações a jogadores que não têm um idioma preferencial definido ou que escolheram um idioma que não corresponde a nenhum dos que você oferece suporte. Como o padrão do título é usado como idioma de fallback, o PlayFab espera que todas as suas comunicações ofereçam suporte ao seu idioma padrão.

Você sempre pode alterar o padrão do título, mas o PlayFab exige que seus modelos de comunicação atuais ofereçam suporte ao idioma para o qual você está mudando.

Se você atualizar o idioma padrão do título, verá que a interface agora mostra um link Edit.

Ao seguir esse link, você verá a mesma lista suspensa de antes. No entanto, se você tentar salvar um idioma padrão que não tenha suporte completo nos seus modelos de email, verá uma ou mais mensagens de erro como a mostrada abaixo.

Game Manager: General: editar idioma padrão

Se houver erros, você poderá seguir os links fornecidos para atualizar seu conteúdo e oferecer suporte ao idioma ausente. Quando todos os erros forem resolvidos, a alteração do idioma padrão será aceita.

Conclusão

Neste tutorial, você viu como definir e atualizar o idioma padrão do seu título e o idioma preferencial dos seus jogadores. Se você tiver dúvidas ou comentários sobre este tutorial, entre em contato conosco pelos nossos fóruns ou pelo canal do Slack.

​Requisitos

​Seção 1: idioma preferencial do jogador

​Etapa 1: definir o idioma

​Exemplo de código em C#

​Etapa 2: verificar se o idioma foi atualizado

​Seção 2: definir um idioma padrão do título

​Seção 3: atualizar o idioma padrão do título

​Conclusão

Requisitos

Seção 1: idioma preferencial do jogador

Etapa 1: definir o idioma

Exemplo de código em C#

Etapa 2: verificar se o idioma foi atualizado

Seção 2: definir um idioma padrão do título

Seção 3: atualizar o idioma padrão do título

Conclusão