コンソールのロケールと言語の判定

wchar_t localeName[LOCALE_NAME_MAX_LENGTH];
int retVal = GetUserDefaultLocaleName(localeName, ARRAYSIZE(localeName));
// The value is returned in localeName.

1. MicrosoftGame.config で宣言されている言語。
2. パッケージ レイアウト ファイルで宣言されている言語。
3. デバイスで選択されている言語。

char gameLocale[LOCALE_NAME_MAX_LENGTH];
HRESULT hr = XPackageGetUserLocale(_countof(gameLocale), gameLocale);
if (SUCCEEDED(hr))
{
    printf("Game using locale: %s\n", gameLocale);
}

​

例

​

1. ユーザーのロケールが、サポートされるリソースと一致する場合

<Resources>
    <Resource Language="en-US"/>
    <Resource Language="fr-FR"/>
    <Resource Language="de-DE"/>
    <Resource Language="en-GB"/>
</Resources>

• XPackageGetUserLocale は fr-FR を返します。
• GetUserDefaultLocaleName は fr-FR を返します。

​

2. ユーザーのロケールがマニフェストにないが、同じ言語が存在する場合

<Resources>
    <Resource Language="en-US"/>
    <Resource Language="fr-FR"/>
    <Resource Language="de-DE"/>
</Resources>

• XPackageGetUserLocale は en-US を返します (同じ言語内でのフォールバック)。
• GetUserDefaultLocaleName は en-GB を返します (常にコンソールの値)。

​

3. ユーザーの言語がまったく存在しない場合

<Resources>
    <Resource Language="en-US"/>
    <Resource Language="de-DE"/>
</Resources>

• XPackageGetUserLocale は en-US を返します (Resources の最初のエントリ)。
• GetUserDefaultLocaleName は fr-FR を返します。

​

まとめ

• GetUserDefaultLocaleName — ゲームが宣言している言語を無視した、コンソールの設定値。
• XPackageGetUserLocale — 次のロジックを用いた、読み込むべき言語:
  1. ユーザーのロケールが MicrosoftGame.config に含まれていれば、それを返します。
  2. そうでなければ、マニフェスト内で同じ言語のロケールを探します (ユーザーのロケールに基づく最良のフォールバック)。
  3. それも見つからなければ、Resources の最初のロケールを返します。
  4. 言語が 1 つも列挙されていなければ、コンソールの言語を返します。

​

関連項目

• XPackageGetUserLocale
• MicrosoftGame.config のローカライズ

​

関連 API ドキュメント

• XGameRuntime features リファレンス — 現在のロケール用の XGameRuntimeLocale
• XPackage API リファレンス — ロケール対応のパッケージ リソース クエリ