stingray.Localizer オブジェクト リファレンス

説明

Localizer は、指定されている単一の .strings リソースに含まれているローカライズされた文字列にアクセスできるようにするヘルパー インタフェースです。

.strings リソースには、多数の異なる言語でローカライズされた文字列を保持できます。ローカライズに使用する言語を設定するには、Localizer.set_language() を使用します。

例:

my_localizer = stingray.Localizer("resources/levels/level1/dialogue")
local en_string = stingray.Localizer.lookup(my_localizer, "introduction") -- returns default ("en") string
...
stingray.Localizer.set_language("fr") -- or whatever language the player selects
local fr_string = stingray.Localizer.lookup(my_localizer, "introduction") -- returns French string

「ゲームのローカライズ」も参照してください。

コンストラクタとアクセサ

stingray.Localizer()

その他の関連リファレンス項目

Utilities

この参照ページは、次の概要トピックと関連付けられています

	「コンテンツとリソースを管理する > ゲームのローカライズ > 文字列をローカライズする」
	「コンテンツとリソースを管理する > ゲームのローカライズ > ユーザ インタフェースをローカライズする」

関数

lookup ( self, key ) : string? ローカライザによって管理されている .strings リソースを最後にロードしたときに設定されたリソース プロパティの設定順序に従って、ローカライザで認識される文字列のセットから要求されたキーを取得します。

パラメータ

self :	stingray.Localizer	この関数を機能させるオブジェクト インスタンスを指定します。 このオブジェクトのインスタンスでこの関数を呼び出すために、コロン : 呼び出し構文を使用できます。その場合、このパラメータは省略する必要があります。詳細については、この Stingray ヘルプ トピック、または Lua ドキュメントのこのページを参照してください。
key :	string	取得する文字列のキーを指定します。

戻り値

string?

指定したキーを持つ文字列、または一致するキーがが見つからない場合は nil です。 ? 表記は、このタイプが省略可能であることを示しています。ゼロ個または 1 個のインスタンスが存在します。

set_language ( language ) ローカライザで文字列を検索するときに使用する言語を指定します。

パラメータ

language :

string?

ローカライザで使用する言語を指定します。既定の言語(英語)を使用するには、en を使用します。 ? 表記は、このタイプが省略可能であることを示しています。ゼロ個または 1 個のインスタンスが存在します。

戻り値

この関数は値を返しません。