Définition des langues par défaut - XBOX Game Development Documentation

PlayFab introduit la prise en charge du stockage de chaînes localisées pour le compte des développeurs de jeux. En outre, nous ajoutons la logique nécessaire pour fournir à vos joueurs les chaînes correspondant à leur langue préférée. Pour ce faire, nous nous appuyons sur deux nouveaux paramètres de langue : l’un est associé à votre titre et l’autre est stocké dans le profil d’entité de chacun de vos joueurs :

Langue par défaut du titre : indique la principale langue prise en charge par votre titre. Une fois ce paramètre défini, votre titre devra prendre en charge cette langue, au moins pour les fonctionnalités utilisant des chaînes localisées.
Langue du joueur : indique la langue préférée du joueur. Elle peut être définie titre par titre.

À l’aide de ces deux paramètres, la logique de PlayFab fait correspondre les chaînes localisées aux joueurs qui préfèrent cette langue. Les joueurs sans préférence linguistique reçoivent les chaînes dans la langue par défaut spécifiée pour votre titre.

Les joueurs qui préfèrent une langue que votre titre ne prend pas en charge reçoivent également des chaînes, dans la langue par défaut de votre titre.

Ce tutoriel vous explique comment définir la langue par défaut de votre titre et la langue préférée de vos joueurs.

Configuration requise

Ce tutoriel suppose que vous disposez des connaissances pratiques suivantes sur l’utilisation de PlayFab :

Des connaissances de base sur la création d’un joueur. Elles sont nécessaires, car des joueurs dotés d’un nom d’utilisateur et d’un mot de passe doivent déjà exister avant d’appeler la logique de langue préférée.
Vous avez lu le démarrage rapide de Game Manager. Si vous ne connaissez pas Game Manager, c’est là que les informations de langue sont consultées.
Vous savez utiliser les profils de joueurs, car il est nécessaire de vérifier qu’une langue préférée a été ajoutée au profil d’un joueur.
Prenez un moment pour consulter les informations sur l’obtention du profil d’un joueur dans le tutoriel Obtention des profils de joueurs.

Section 1 : langue préférée du joueur

Avant de définir la langue préférée de votre joueur, déterminez comment vous souhaitez la collecter. Plusieurs options s’offrent à vous :

La lui demander : ajoutez une option dans le menu de votre jeu.
Déduire sa langue : utilisez la langue de l’appareil du joueur en appelant l’API de plateforme fournie (par exemple, Locale.getDefault.getLanguage() pour Android).

Il existe de nombreuses langues, et votre titre ne les prend peut-être pas toutes en charge. Bien que ce ne soit pas obligatoire, nous vous recommandons de préparer votre titre pour l’avenir en stockant la préférence réelle du joueur. Si vous ajoutez ultérieurement la prise en charge de cette langue, la logique de PlayFab commencera automatiquement à fournir les nouvelles chaînes (au lieu de celles par défaut).

Étape 1 : définir la langue

PlayFab vous permet de choisir les langues à prendre en charge dans une liste spécifique. Vous pouvez appeler la méthode GetLanguageList() pour afficher les codes de langue.

Lorsque vous utilisez l’API SetProfileLanguage, la chaîne de langue doit être spécifiée au format ISO 639-1 (par exemple, “en”, “es” ou “ja”). Actuellement, le code “zh” n’est pas pris en charge.

Nous allons d’abord mettre à jour le profil d’un joueur pour y inclure la langue dans laquelle il préfère recevoir le contenu de votre titre.

Exemple de code 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());
}

Étape 2 : vérifier que la langue a été mise à jour

Accédez à la vue d’ensemble du joueur. Dans Game Manager, accédez à Player > Overview. Vérifiez que la section des informations de contact est mise à jour avec sa langue préférée. La langue peut également être mise à jour à l’aide du menu déroulant Language affiché dans l’image suivante.

Game Manager : joueur, vue d'ensemble, adresse e-mail de contact, langue

Accédez ensuite au PlayStream du joueur : un événement Entity language updated s’affiche.

Game Manager : joueurs, PlayStream, événement Entity Language Updated

Sélectionnez l’icône d’informations de l’événement pour afficher un JSON similaire à l’exemple ci-dessous.

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

Section 2 : définir une langue par défaut pour le titre

Définissez ensuite une langue par défaut pour votre titre. Toutes les fonctionnalités de localisation associent désormais une langue à chaque version traduite du contenu. Le titre requiert une langue par défaut. Ainsi, si la langue préférée d’un joueur n’est pas définie ou pas prise en charge, le joueur peut tout de même recevoir la version par défaut du contenu. Pour commencer, sélectionnez Settings dans le menu de gauche, comme illustré ci-dessous.

Game Manager : paramètres, général, langue par défaut

Dans l’onglet General, sous le nouvel en-tête TITLE DEFAULTS, repérez la liste déroulante Default language. Vous devez définir une langue par défaut avant de pouvoir utiliser les fonctionnalités de localisation. Lorsque vous avez terminé, sélectionnez le bouton SAVE. Une notification s’affiche si la mise à jour a réussi. Lorsque vous revenez au tableau de bord, un événement Title API settings changed apparaît dans la liste des événements PlayStream, comme illustré ci-dessous.

Sélectionnez l’icône d’informations de l’événement pour afficher un JSON similaire à l’exemple ci-dessous.

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

Section 3 : mise à jour de la langue par défaut d’un titre

Il est important de se rappeler que la définition d’une langue par défaut pour votre titre indique à PlayFab d’utiliser cette langue lorsque vous envoyez des communications aux joueurs qui n’ont pas défini de langue préférée ou qui ont choisi une langue ne correspondant à aucune de celles que vous prenez en charge. Comme la langue par défaut du titre sert de langue de repli, PlayFab s’attend à ce que toutes vos communications prennent en charge votre langue par défaut.

Vous pouvez toujours modifier la langue par défaut de votre titre, mais PlayFab exige que vos modèles de communication actuels prennent en charge la nouvelle langue choisie.

Si vous mettez à jour la langue par défaut de votre titre, l’interface affiche désormais un lien Edit.

Paramètres par défaut du titre : langue par défaut

En suivant ce lien, vous verrez la même liste déroulante qu’auparavant. Toutefois, si vous essayez d’enregistrer une langue par défaut qui n’est pas entièrement prise en charge par vos modèles d’e-mail, un ou plusieurs messages d’erreur semblables à celui ci-dessous s’affichent.

Game Manager : général, modifier la langue par défaut

En cas d’erreurs, vous pouvez suivre les liens fournis pour mettre à jour votre contenu afin qu’il prenne en charge la langue manquante. Une fois toutes les erreurs corrigées, la modification de la langue par défaut est acceptée.

Conclusion

Dans ce tutoriel, vous avez vu comment définir et mettre à jour la langue par défaut de votre titre et la langue préférée de vos joueurs. Si vous avez des questions ou des commentaires sur ce tutoriel, contactez-nous via nos forums ou notre canal Slack.

​Configuration requise

​Section 1 : langue préférée du joueur

​Étape 1 : définir la langue

​Exemple de code C#

​Étape 2 : vérifier que la langue a été mise à jour

​Section 2 : définir une langue par défaut pour le titre

​Section 3 : mise à jour de la langue par défaut d’un titre

​Conclusion

Configuration requise

Section 1 : langue préférée du joueur

Étape 1 : définir la langue

Exemple de code C#

Étape 2 : vérifier que la langue a été mise à jour

Section 2 : définir une langue par défaut pour le titre

Section 3 : mise à jour de la langue par défaut d’un titre

Conclusion