Urho3D本地化 国际化

本地化子系统提供了创建多语言应用程序的简单方法。

初始化

在使用子系统之前，需要加载本地化字符串集合。通常的做法是在应用程序启动时执行此操作。可以加载多个集合文件，每个集合文件只能定义一种或多种语言。例如：

Localization* l10n = GetSubsystem<Localization>();
// 1st JSON file format
l10n->LoadJSONFile("StringsEnRu.json");
l10n->LoadJSONFile("StringsDe.json");// 2nd JSON file format
l10n->LoadJSONFile("StringsLv.json", "lv");

JSON文件必须采用UTF8编码，无BOM。示例文件位于bin/Data目录中。JSON文件必须具有以下格式之一：

1.LoadJSONFile（“StringsEnRu.json”）方法将自动从json文件中选择语言

{"string id 1":{"language 1":"value11","language 2":"value12","language 3":"value13"},"string id 2":{"language 1":"value21","language 2":"value22","language 3":"value23"}
}

2.必须将第二个参数传递给LoadJSONFile（“StringsLv.json”，“lv”）方法，以告诉解析器将加载哪种语言

{"string id 1": "value 1","string id 2": "value 2","string id 3": "value 3"
}

可以定义任意数量的语言。请记住，语言名称和字符串标识符区分大小写。“En”和“en”被认为是不同的语言。在加载过程中，按照查找顺序对语言进行编号。索引从零开始。第一个找到的语言被设置为初始激活。

使用

Get函数以当前语言返回具有指定字符串标识符的字符串。

Text* t = new Text(context_);
t->SetName("Text1");
Localization* l10n = GetSubsystem<Localization>();
t->SetText(l10n->Get("string 1"));

      如果字符串id为空，将返回一个空字符串。如果找不到翻译，将不修改地返回id，并记录警告。使用SetLanguage（）函数在运行时更改语言。

Localization* l10n = GetSubsystem<Localization>();
l10n->SetLanguage("language 2");

    语言更改后，将发送E_CHANGELANGUAGE事件。订阅它以执行必要的用户界面重新定位（文本、精灵等）

SubscribeToEvent(E_CHANGELANGUAGE, URHO3D_HANDLER(Game, HandleChangeLanguage));void Game::HandleChangeLanguage(StringHash eventType, VariantMap& eventData)
{Localization* l10n = GetSubsystem<Localization>();...Text* t = static_cast<Text*>(uiRoot->GetChild("Text1", true));t->SetText(l10n->Get("string 1"));
}

文本UI元素还支持自动翻译，以避免手动操作。

Text* t2 = new Text(context_);
t2->SetText("string 2");
t2->SetAutoLocalizable(true);

其中文本值用作标识符。另请参见示例40_Localization。