TranslationServer
Hereda: Object
El servidor responsable de las traducciones de idiomas.
Descripción
El servidor de traducción es el backend de la API que gestiona todas las traducciones de idiomas.
Las traducciones se almacenan en TranslationDomains, a las que se puede acceder por nombre. El dominio de traducción más utilizado es el dominio de traducción principal. Siempre existe y se puede acceder a él utilizando un StringName vacío. El servidor de traducción proporciona métodos wrapper para acceder al dominio de traducción principal directamente, sin tener que obtener primero el dominio de traducción. Los dominios de traducción personalizados son principalmente para usos avanzados como los plugins del editor. Los nombres que comienzan con godot. están reservados para los elementos internos del motor.
Tutoriales
Propiedades
|
Métodos
Descripciones de Propiedades
bool pseudolocalization_enabled = false 🔗
Si es true, habilita el uso de pseudolocalización en el dominio de traducción principal. Véase ProjectSettings.internationalization/pseudolocalization/use_pseudolocalization para más detalles.
Descripciones de Métodos
void add_translation(translation: Translation) 🔗
Añade una traducción al dominio de traducción principal.
void clear() 🔗
Elimina todas las traducciones del dominio de traducción principal.
int compare_locales(locale_a: String, locale_b: String) const 🔗
Compara dos configuraciones regionales y devuelve una puntuación de similitud entre 0 (sin coincidencia) y 10 (coincidencia total).
Array[Translation] find_translations(locale: String, exact: bool) const 🔗
Devuelve las instancias de Translation en el dominio de traducción principal que coinciden con locale (véase compare_locales()). Si exact es true, solo se devolverán las instancias cuyo locale sea exactamente igual a locale.
String format_number(number: String, locale: String) const 🔗
Convierte un número del sistema arábigo occidental (0..9) al sistema numérico utilizado en el locale dado.
PackedStringArray get_all_countries() const 🔗
Devuelve un array de códigos de país conocidos.
PackedStringArray get_all_languages() const 🔗
Devuelve un array de códigos de idioma conocidos.
PackedStringArray get_all_scripts() const 🔗
Devuelve un array de códigos de script conocidos.
String get_country_name(country: String) const 🔗
Devuelve un nombre de país legible para el código country.
String get_language_name(language: String) const 🔗
Devuelve un nombre de idioma legible para el código language.
PackedStringArray get_loaded_locales() const 🔗
Devuelve un array de todas las configuraciones regionales cargadas del proyecto.
Devuelve la configuración regional actual del proyecto.
Véase también OS.get_locale() y OS.get_locale_language() para consultar la configuración regional del sistema del usuario.
String get_locale_name(locale: String) const 🔗
Devuelve el locale de un lenguaje y su variante (por ejemplo, "es_ES" devolvería "Español (España)").
TranslationDomain get_or_add_domain(domain: StringName) 🔗
Devuelve el dominio de traducción con el nombre especificado. Se creará y agregará un dominio de traducción vacío si no existe.
String get_percent_sign(locale: String) const 🔗
Devuelve el signo de porcentaje utilizado en la locale dada.
String get_plural_rules(locale: String) const 🔗
Devuelve las reglas de pluralización predeterminadas para la locale.
String get_script_name(script: String) const 🔗
Devuelve un nombre de script legible para el código script.
Devuelve la configuración regional actual del editor.
Nota: Cuando se llama desde un proyecto exportado, devuelve el mismo valor que get_locale().
Translation get_translation_object(locale: String) 🔗
Obsoleto: Use find_translations() instead.
Devuelve la instancia de Translation que mejor coincide con locale en el dominio de traducción principal. Devuelve null si no hay coincidencias.
Array[Translation] get_translations() const 🔗
Devuelve todas las instancias Translation disponibles en el dominio de traducción principal, tal como se agregaron con add_translation().
bool has_domain(domain: StringName) const 🔗
Devuelve true si existe un dominio de traducción con el nombre especificado.
bool has_translation(translation: Translation) const 🔗
Devuelve true si el dominio de traducción principal contiene la traducción translation dada.
bool has_translation_for_locale(locale: String, exact: bool) const 🔗
Devuelve true si hay alguna instancia Translation en el dominio de traducción principal que coincida con locale (véase compare_locales()). Si exact es true, solo se consideran las instancias cuya configuración regional sea exactamente igual a locale.
String parse_number(number: String, locale: String) const 🔗
Convierte number del sistema numérico utilizado en la locale dada al árabe occidental (0..9).
StringName pseudolocalize(message: StringName) const 🔗
Devuelve la string pseudolocalizada basada en el message pasado.
Nota: Este método siempre utiliza el dominio de traducción principal.
void reload_pseudolocalization() 🔗
Vuelve a analizar las opciones de pseudolocalización y vuelve a cargar la traducción para el dominio de traducción principal.
void remove_domain(domain: StringName) 🔗
Elimina el dominio de traducción con el nombre especificado.
Nota: Intentar eliminar el dominio de traducción principal es un error.
void remove_translation(translation: Translation) 🔗
Elimina la traducción dada del dominio de traducción principal.
void set_locale(locale: String) 🔗
Establece la configuración regional del proyecto. La string locale se estandarizará para que coincida con las configuraciones regionales conocidas (por ejemplo, en-US se correspondería con en_US).
Si se han cargado traducciones de antemano para la nueva configuración regional, se aplicarán.
String standardize_locale(locale: String, add_defaults: bool = false) const 🔗
Devuelve una string locale estandarizada para que coincida con las configuraciones regionales conocidas (por ejemplo, en-US se correspondería con en_US). Si add_defaults es true, es posible que se añada un script o un país por defecto a la configuración regional.
StringName translate(message: StringName, context: StringName = &"") const 🔗
Devuelve la traducción del idioma actual para el mensaje y el contexto dados.
Nota: Este método siempre usa el dominio de traducción principal.
StringName translate_plural(message: StringName, plural_message: StringName, n: int, context: StringName = &"") const 🔗
Devuelve la traducción del idioma actual para el mensaje dado, el mensaje en plural y el contexto.
El número n es el número o la cantidad del objeto en plural. Se utilizará para guiar al sistema de traducción para obtener la forma plural correcta para el idioma seleccionado.
Nota: Este método siempre usa el dominio de traducción principal.