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
Статус на сервери.
Опис
Сервер перекладу — це серверний API, який керує перекладами всіх мов.
Переклади зберігаються в TranslationDomain, доступ до якого можна отримати за іменем. Найбільш часто використовуваним доменом перекладу є основний домен перекладу. Він завжди існує, і до нього можна отримати доступ за допомогою порожнього StringName. Сервер перекладу надає методи оболонки для прямого доступу до основного домену перекладу без необхідності попереднього отримання домену перекладу. Користувальницькі домени перекладу в основному призначені для розширеного використання, наприклад плагінів редактора. Назви, що починаються з godot., зарезервовані для внутрішніх пристроїв двигуна.
Посібники
Властивості
|
Методи
Описи властивостей
bool pseudolocalization_enabled = false 🔗
Якщо true, увімкнено використання псевдолокалізації в основному домені перекладу. Докладніше див. у ProjectSettings.internationalization/pseudolocalization/use_pseudolocalization.
Описи методів
void add_translation(translation: Translation) 🔗
Додає переклад до основного домену перекладу.
void clear() 🔗
Видаляє всі переклади з основного домену перекладу.
int compare_locales(locale_a: String, locale_b: String) const 🔗
Порівняйте два локальні та повертає аналогічний бал між 0 (без матчу) та 10 (повний матч).
Array[Translation] find_translations(locale: String, exact: bool) const 🔗
Повертає екземпляри Translation в основному домені перекладу, які відповідають locale (див. compare_locales()). Якщо exact має значення true, будуть повернуті лише екземпляри, локаль яких точно дорівнює locale.
String format_number(number: String, locale: String) const 🔗
Перетворює число із західноарабської системи числення (0..9) у систему числення, що використовується у заданому locale.
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 🔗
Повертає масив всіх завантажених місцевих місць проекту.
Повертає поточну локалізацію проєкту.
Див. також 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) 🔗
Повертає домен перекладу з вказаною назвою. Буде створено та додано порожній домен перекладу, якщо він не існує.
String get_percent_sign(locale: String) const 🔗
Повертає знак відсотка, який використовується у заданому locale.
String get_plural_rules(locale: String) const 🔗
Повертає правила множини за замовчуванням для locale.
String get_script_name(script: String) const 🔗
Повертаємо читабельне ім'я скрипта script код.
Повернути поточний локальний редактор.
Примітка: Після того, як було прийнято експортований проект, повертає той самий значення, як get_locale().
Translation get_translation_object(locale: String) 🔗
Застаріло: Use find_translations() instead.
Повертає екземпляр Translation, який найкраще відповідає locale в основному домені перекладу. Повертає null, якщо немає збігів.
Array[Translation] get_translations() const 🔗
Повертає всі доступні екземпляри Translation в основному домені перекладу, додані add_translation().
bool has_domain(domain: StringName) const 🔗
Повертає true, якщо існує домен перекладу з вказаною назвою.
bool has_translation(translation: Translation) const 🔗
Повертає true, якщо основний домен перекладу містить задане translation.
bool has_translation_for_locale(locale: String, exact: bool) const 🔗
Повертає true, якщо в основному домені перекладу є екземпляри Translation, які відповідають locale (див. compare_locales()). Якщо exact має значення true, розглядаються лише екземпляри, локаль яких точно дорівнює locale.
String parse_number(number: String, locale: String) const 🔗
Перетворює number із системи числення, що використовується у вказаній locale, на західну арабську систему (0..9).
StringName pseudolocalize(message: StringName) const 🔗
Повертає псевдолокалізований рядок на основі переданого message.
Примітка. Цей метод завжди використовує основний домен перекладу.
void reload_pseudolocalization() 🔗
Повторно аналізує параметри псевдолокалізації та перезавантажує переклад для основного домену перекладу.
void remove_domain(domain: StringName) 🔗
Видаляє домен перекладу з указаним іменем.
Примітка. Спроба видалити основний домен перекладу є помилкою.
void remove_translation(translation: Translation) 🔗
Видаляє вказаний переклад з основного домену перекладу.
void set_locale(locale: String) 🔗
Встановлює локалізацію проекту. Locale string буде стандартизовано відповідно до відомих місцевих місць (наприклад, en-US буде відповідати en_US.
Якщо переклади були завантажені раніше для нової локалізації, вони будуть застосовуватися.
String standardize_locale(locale: String, add_defaults: bool = false) const 🔗
Повертає рядок locale, стандартизований відповідно до відомих локалей (наприклад, en-US відповідатиме en_US). Якщо add_defaults має значення true, можливо, до локалі додано скрипт за умовчанням або країну.
StringName translate(message: StringName, context: StringName = &"") const 🔗
Повертає переклад поточної мови для даного повідомлення та контексту.
Примітка. Цей метод завжди використовує основний домен перекладу.
StringName translate_plural(message: StringName, plural_message: StringName, n: int, context: StringName = &"") const 🔗
Повертає переклад поточної мови для даного повідомлення, повідомлення у множині та контексту.
Число n — це число або кількість об’єкта множини. Він використовуватиметься, щоб керувати системою перекладу для отримання правильної форми множини для вибраної мови.
Примітка. Цей метод завжди використовує основний домен перекладу.