ローカライゼーション

あなたのテキストエレメントを異なる言語にローカライズする方法について説明します。

ローカライゼーションファイル

JSONファイルのinfo部分で異なるロケールを指定することができます。messagesセクションには、それぞれのローカライズされたフレーズのキー - 値のペアが含まれています。キーはそのフレーズの識別子で、テキストはそのキーの翻訳テキストです。

JSONアセットは次のようになります。

{
    "header": {
        "version": 1
    },
    "data": [
        {
            "info": {
                "locale": "en-US"
            },
            "messages": {
                "key": "Single key translation",
                "key plural": [
                    "One key translation",
                    "Translation for {number} keys"
                ]
            }
        }
    ]
}

JSONファイルのinfo部分ので異なるロケールを指定することができます。messagesセクションには、それぞれのローカライズされたフレーズのキー - 値のペアが含まれています。キーはそのフレーズの識別子で、テキストはそのキーの翻訳テキストです。

PlayCanvasは各ロケールの複数形もサポートしています。各フレーズの複数形を指定するためには、単一の文字列の代わりに、各複数形の文字列の配列を渡す必要があります。各言語の複数形はここで見つけることができます。各配列要素はその言語の複数形に対応します。たとえば英語の場合は次のようになります。

"key plural": [
    "One item", // plural form ONE
    "Not one" // plural form OTHER
]

アラビア語の場合:

"key plural": [
    "Zero items", // plural form ZERO
    "One item", // plural form ONE
    "Two items", // plural form TWO
    "Few items", // plural form FEW
    "Many items", // plural form MANY
    "Rest", // plural form OTHER
]

各言語のルールについては、ここの言語表を参照してください。

ローカライズJSONアセットを作成したら、エディタ設定のローカライゼーションの下に追加する必要があります。

テキストエレメントのローカライズ

テキストエレメントの Localized チェックボックスを有効にすると、ローカライゼーションファイルを使用してそのテキストを翻訳できます。テキストエレメントの Key フィールドに入力するテキストは、ローカライゼーションファイルのキーと一致する必要があります。

ローカライゼーションをテストするためには、エディタ設定の Locale フィールドを変更できます。これにより、エディタのビューポートがそのロケールに更新され、またアプリケーションを起動したときに使用するロケールも更新されます。このフィールドは、ビルドを公開またはダウンロードするときには使用されません。

数字のローカライズ

異なるロケールでは、数字のフォーマット方法について異なるルールがあります。例えば、英語（イギリスとアメリカ）では 1000000 を 1,000,000 とフォーマットし、オランダ語では小数点でフォーマットします 1.000.000。

JavaScriptはロケールコードに基づいてこのフォーマットを行う組み込み関数、Number.protoype.toLocaleString()を提供しています。

使用例:

var numberOfItems = 1000;
var currentLocale = this.app.i18n.locale;
var localeNumberString = numberOfItems.toLocaleString(currentLocale);

console.log(localeNumberString);
// expected output assuming currentLocale is en-US: "1,000"

ローカライズされたフォント

よくあるケースとして、異なる言語では異なるフォントを使用する必要がある場合があります。特定の言語に対して異なるフォントを定義するためには、テキストエレメントで使用している主要なフォントアセットを選択し、アセット属性の下部にあるそのフォントアセットのローカライゼーションセクションを見つけます。目的のロケールを入力し、そのロケールに新しいフォントアセットを割り当てます。

ランタイム時にアプリケーションが異なるロケールに切り替えると、そのロケールに定義したフォントアセットが読み込まれます。

Localized Fonts Inspector