Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

TranslationServer¶

继承： Object

负责语言翻译的服务器。

描述¶

管理所有语言翻译的服务器。可以向其中添加翻译，也可以从中移除翻译。

教程¶

属性¶

bool

pseudolocalization_enabled

false

方法¶

void	add_translation(translation: Translation)
void	clear()
int	compare_locales(locale_a: String, locale_b: String) const
PackedStringArray	get_all_countries() const
PackedStringArray	get_all_languages() const
PackedStringArray	get_all_scripts() const
String	get_country_name(country: String) const
String	get_language_name(language: String) const
PackedStringArray	get_loaded_locales() const
String	get_locale() const
String	get_locale_name(locale: String) const
String	get_script_name(script: String) const
String	get_tool_locale()
Translation	get_translation_object(locale: String)
StringName	pseudolocalize(message: StringName) const
void	reload_pseudolocalization()
void	remove_translation(translation: Translation)
void	set_locale(locale: String)
String	standardize_locale(locale: String) const
StringName	translate(message: StringName, context: StringName = &"") const
StringName	translate_plural(message: StringName, plural_message: StringName, n: int, context: StringName = &"") const

属性说明¶

bool pseudolocalization_enabled = false 🔗

void set_pseudolocalization_enabled(value: bool)
bool is_pseudolocalization_enabled()

如果为 true，则启用伪本地化。有关详细信息，请参阅 ProjectSettings.internationalization/pseudolocalization/use_pseudolocalization。

方法说明¶

void add_translation(translation: Translation) 🔗

添加一个 Translation 资源。

void clear() 🔗

清除服务器中的所有翻译。

int compare_locales(locale_a: String, locale_b: String) const 🔗

比较两个区域设置，返回 0（不匹配）和 10（完全匹配）之间的相似度得分。

PackedStringArray get_all_countries() const 🔗

返回已知地区代码的数组。

PackedStringArray get_all_languages() const 🔗

返回已知语言代码的数组。

PackedStringArray get_all_scripts() const 🔗

返回已知文字代码的数组。

String get_country_name(country: String) const 🔗

返回地区代码 country 的可读地区名称。

String get_language_name(language: String) const 🔗

返回语言代码 language 的可读语言名称。

PackedStringArray get_loaded_locales() const 🔗

返回项目中所有已加载的区域设置的数组。

String get_locale() const 🔗

返回项目的当前区域设置。

查询用户系统的区域设置请参阅 OS.get_locale 和 OS.get_locale_language。

String get_locale_name(locale: String) const 🔗

返回区域设置的语言及其变体。例如，"en_US" 将返回 "English (United States)"。

String get_script_name(script: String) const 🔗

返回文字代码 script 的可读文字名称。

String get_tool_locale() 🔗

返回编辑器的当前区域设置。

注意：从导出后的项目中调用时，返回值与 get_locale 相同。

Translation get_translation_object(locale: String) 🔗

根据传入的 locale 返回 Translation 实例。

如果没有与 locale 匹配的 Translation 实例，则返回 null。

StringName pseudolocalize(message: StringName) const 🔗

根据传入的 message 返回伪本地化字符串。

void reload_pseudolocalization() 🔗

重新解析伪本地化选项，并重新加载翻译。

void remove_translation(translation: Translation) 🔗

从服务器中删除给定的翻译。

void set_locale(locale: String) 🔗

设置项目的区域设置。locale 字符串将被标准化，以匹配已知的区域设置（例如 en-US 将与 en_US 匹配）。

如果已经为新区域设置预先加载了翻译，则它们将被应用。

String standardize_locale(locale: String) const 🔗

返回标准化的 locale 字符串，以匹配已知的区域设置（例如 en-US 将与 en_US 匹配）。

StringName translate(message: StringName, context: StringName = &"") const 🔗

返回给定消息（键）和上下文的翻译，使用当前区域设置。

StringName translate_plural(message: StringName, plural_message: StringName, n: int, context: StringName = &"") const 🔗

返回给定消息（键）、复数消息和上下文的翻译，使用当前区域设置。

数字 n 是复数对象的数量。翻译系统会根据这个数字来针对所选语言获取正确的复数形式。