既定の言語の設定 - XBOX Game Development Documentation

PlayFab は、ゲーム開発者に代わってローカライズされた文字列を保存するためのサポートを導入しています。さらに、プレイヤーが希望する言語の正しい文字列を提供するのに必要なロジックを追加します。これを達成するために、2 つの新しい言語設定を活用します。1 つはタイトルに関連付けられ、もう 1 つは各プレイヤーのエンティティプロファイルに保存されます:

タイトルの既定の言語: タイトルが主にサポートする言語を示します。設定すると、少なくともローカライズされた文字列を使用する機能で使用するために、タイトルがこの言語をサポートすることが必要になります。
プレイヤーの言語: プレイヤーの優先言語を示します。これはタイトルごとに設定できます。

これら 2 つの設定を使用して、PlayFab のロジックは、ローカライズされた文字列を、その言語を優先するプレイヤーとマッチさせます。言語の優先が設定されていないプレイヤーは、タイトルで指定された既定の言語で文字列を受け取ります。

タイトルが サポートしていない 言語を優先するプレイヤーも、タイトルの既定の言語に基づいて文字列を受け取ります。

このチュートリアルでは、タイトルの既定の言語とプレイヤーの優先言語を設定する方法を説明します。

要件

このチュートリアルでは、PlayFab の使用に関する次の実務知識を前提としています:

プレイヤーの作成方法に関する基本的な知識。優先言語のロジックを呼び出す前に、プレイヤーがユーザー名とパスワードを持って 既に存在する 必要があるため、これが必要です。
Game Manager クイックスタートを読んでいること。Game Manager に慣れていない場合、これは言語情報を表示する場所です。
プレイヤープロファイルの操作方法に関する知識。優先言語がプレイヤーのプロファイルに追加されたことを確認する必要があるためです。
プレイヤープロファイルの取得チュートリアルで、プレイヤープロファイルを取得する方法についての情報を確認する時間を取ってください。

セクション 1 – プレイヤーの優先言語

プレイヤーの優先言語を設定する前に、どのように収集するかを考えます。いくつかのオプションがあります:

プレイヤーに尋ねる: ゲームのメニューにオプションを追加します。
言語を推測する: 提供されているプラットフォーム API (たとえば Android の Locale.getDefault.getLanguage()) を呼び出すことで、プレイヤーのデバイスの言語を使用します。

世界には多くの言語があり、タイトルは すべての 言語をサポートしない場合があります。必須ではありませんが、タイトルを将来性のあるものにし、プレイヤーの実際の優先を保存することを推奨します。後でその言語のサポートを追加する場合、PlayFab のロジックは自動的に新しい文字列を提供し始めます (既定の代わりに)。

ステップ 1 – 言語を設定する

PlayFab では、サポートする言語のリストから選択できます。GetLanguageList() メソッドを呼び出して言語コードを確認できます。

SetProfileLanguage API を使用する場合、言語文字列は ISO 639-1 形式で指定する必要があります (たとえば、“en”、“es”、“ja”)。現時点では、コード “zh” はサポートされていません。

まず、プレイヤーのプロファイルを更新して、タイトルからのコンテンツを受け取りたい言語を含めます。

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

ステップ 2 – 言語が更新されたことを確認する

プレイヤーの概要に移動します。Game Manager で Player > Overview に移動します。連絡先情報セクションが優先言語で更新されていることを確認します。言語は、以下の画像に表示されている Language ドロップダウンメニューでも更新できます。次に、プレイヤーの PlayStream に移動すると、Entity language updated イベントが表示されます。イベントの情報アイコンを選択すると、以下の例のような JSON が表示されます。

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

セクション 2 – タイトルの既定の言語を設定する

次に、タイトルの既定の言語を設定します。すべてのローカライズ機能は、コンテンツの翻訳された各バージョンに言語を関連付けるようになりました。タイトルには既定の言語が必要です。これにより、プレイヤーの優先言語が設定されていないかサポートされていない場合でも、プレイヤーはコンテンツの既定バージョンを引き続き受け取ることができます。まず、以下に示すように、左のメニューで Settings を選択します。新しい TITLE DEFAULTS ヘッダーの下の General タブで、Default language ドロップダウンを見つけます。ローカリゼーション追加機能のいずれかを使用する前に、既定の言語を設定する必要があります。完了したら、SAVE ボタンを選択します。更新が成功した場合はメッセージ通知が表示されます。ダッシュボードに戻ると、以下に示すように PlayStream イベントリストに Title API settings changed イベントが表示されます。イベントの情報アイコンを選択すると、以下の例のような JSON が表示されます。

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

セクション 3 – タイトルの既定の言語の更新

タイトルの既定を設定すると、優先言語が設定されて いない プレイヤーや、サポートしていない言語を選択したプレイヤーに通信を発行するときに、その言語を使用するように PlayFab に指示することを覚えておくことが重要です。タイトルの既定は フォールバック 言語として使用されるため、PlayFab はすべての通信が既定の言語をサポートすることを期待します。

タイトルの既定は いつでも 変更できますが、PlayFab は現在の通信テンプレートが変更先の言語をサポートしていることを要求します。

タイトルの既定の言語を更新すると、インターフェイスに Edit リンクが表示されるようになります。このリンクをたどると、以前と同じドロップダウンが表示されます。ただし、メールテンプレートで完全にサポートされていない既定の言語を保存しようとすると、以下のような 1 つ以上のエラーメッセージが表示されます。エラーがある場合は、提供されているリンクをたどって、欠けている言語をサポートするようにコンテンツを更新できます。すべてのエラーに対処すると、既定の言語の変更が受け入れられます。

まとめ

このチュートリアルでは、タイトルの既定の言語とプレイヤーの優先言語を設定・更新する方法を確認しました。このチュートリアルに関するご質問やフィードバックがある場合は、フォーラムまたは Slack チャンネルからお問い合わせください。

​要件

​セクション 1 – プレイヤーの優先言語

​ステップ 1 – 言語を設定する

​C# コード例

​ステップ 2 – 言語が更新されたことを確認する

​セクション 2 – タイトルの既定の言語を設定する

​セクション 3 – タイトルの既定の言語の更新

​まとめ

要件

セクション 1 – プレイヤーの優先言語

ステップ 1 – 言語を設定する

C# コード例

ステップ 2 – 言語が更新されたことを確認する

セクション 2 – タイトルの既定の言語を設定する

セクション 3 – タイトルの既定の言語の更新

まとめ