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
負責語言翻譯的伺服器。
說明
The translation server is the API backend that manages all language translations.
Translations are stored in TranslationDomains, which can be accessed by name. The most commonly used translation domain is the main translation domain. It always exists and can be accessed using an empty StringName. The translation server provides wrapper methods for accessing the main translation domain directly, without having to fetch the translation domain first. Custom translation domains are mainly for advanced usages like editor plugins. Names starting with godot. are reserved for engine internals.
教學
屬性
|
方法
屬性說明
bool pseudolocalization_enabled = false 🔗
If true, enables the use of pseudolocalization on the main translation domain. See ProjectSettings.internationalization/pseudolocalization/use_pseudolocalization for details.
方法說明
void add_translation(translation: Translation) 🔗
Adds a translation to the main translation domain.
void clear() 🔗
Removes all translations from the main translation domain.
int compare_locales(locale_a: String, locale_b: String) const 🔗
比較兩個區域設定，返回 0（不配對）和 10（完全配對）之間的相似度得分。
Array[Translation] find_translations(locale: String, exact: bool) const 🔗
Returns the Translation instances in the main translation domain that match locale (see compare_locales()). If exact is true, only instances whose locale exactly equals locale will be returned.
String format_number(number: String, locale: String) const 🔗
Converts a number from Western Arabic (0..9) to the numeral system used in the given locale.
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 🔗
返回專案中所有已載入的區域設定的陣列。
返回專案的目前區域設定。
查詢使用者系統的區域設定請參閱 OS.get_locale() 和 OS.get_locale_language()。
String get_locale_name(locale: String) const 🔗
返回區域設定的語言及其變體。例如，"en_US" 將返回 "English (United States)"。
TranslationDomain get_or_add_domain(domain: StringName) 🔗
Returns the translation domain with the specified name. An empty translation domain will be created and added if it does not exist.
String get_percent_sign(locale: String) const 🔗
Returns the percent sign used in the given locale.
String get_plural_rules(locale: String) const 🔗
Returns the default plural rules for the locale.
String get_script_name(script: String) const 🔗
返回文字程式碼 script 的可讀文字名稱。
返回編輯器的目前區域設定。
注意：從匯出後的專案中呼叫時，返回值與 get_locale() 相同。
Translation get_translation_object(locale: String) 🔗
已棄用： Use find_translations() instead.
Returns the Translation instance that best matches locale in the main translation domain. Returns null if there are no matches.
Array[Translation] get_translations() const 🔗
Returns all available Translation instances in the main translation domain as added by add_translation().
bool has_domain(domain: StringName) const 🔗
Returns true if a translation domain with the specified name exists.
bool has_translation(translation: Translation) const 🔗
Returns true if the main translation domain contains the given translation.
bool has_translation_for_locale(locale: String, exact: bool) const 🔗
Returns true if there are any Translation instances in the main translation domain that match locale (see compare_locales()). If exact is true, only instances whose locale exactly equals locale are considered.
String parse_number(number: String, locale: String) const 🔗
Converts number from the numeral system used in the given locale to Western Arabic (0..9).
StringName pseudolocalize(message: StringName) const 🔗
Returns the pseudolocalized string based on the message passed in.
Note: This method always uses the main translation domain.
void reload_pseudolocalization() 🔗
Reparses the pseudolocalization options and reloads the translation for the main translation domain.
void remove_domain(domain: StringName) 🔗
Removes the translation domain with the specified name.
Note: Trying to remove the main translation domain is an error.
void remove_translation(translation: Translation) 🔗
Removes the given translation from the main translation domain.
void set_locale(locale: String) 🔗
設定專案的區域設定。locale 字串將被標準化，以配對已知的區域設定（例如 en-US 將與 en_US 配對）。
如果已經為新區域設定預先載入了翻譯，則它們將被套用。
String standardize_locale(locale: String, add_defaults: bool = false) const 🔗
Returns a locale string standardized to match known locales (e.g. en-US would be matched to en_US). If add_defaults is true, the locale may have a default script or country added.
StringName translate(message: StringName, context: StringName = &"") const 🔗
Returns the current locale's translation for the given message and context.
Note: This method always uses the main translation domain.
StringName translate_plural(message: StringName, plural_message: StringName, n: int, context: StringName = &"") const 🔗
Returns the current locale's translation for the given message, plural message and context.
The number n is the number or quantity of the plural object. It will be used to guide the translation system to fetch the correct plural form for the selected language.
Note: This method always uses the main translation domain.