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

bool

pseudolocalization_enabled

false

Métodos

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

TranslationDomain

get_or_add_domain(domain: StringName)

String

get_script_name(script: String) const

String

get_tool_locale()

Translation

get_translation_object(locale: String)

bool

has_domain(domain: StringName) const

StringName

pseudolocalize(message: StringName) const

void

reload_pseudolocalization()

void

remove_domain(domain: StringName)

void

remove_translation(translation: Translation)

void

set_locale(locale: String)

String

standardize_locale(locale: String, add_defaults: bool = false) const

StringName

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

StringName

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


Descripciones de Propiedades

bool pseudolocalization_enabled = false 🔗

  • void set_pseudolocalization_enabled(value: bool)

  • bool is_pseudolocalization_enabled()

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).


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.


String get_locale() const 🔗

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_script_name(script: String) const 🔗

Devuelve un nombre de script legible para el código script.


String get_tool_locale() 🔗

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) 🔗

Devuelve la instancia de Translation que mejor coincide con locale en el dominio de traducción principal. Devuelve null si no hay coincidencias.


bool has_domain(domain: StringName) const 🔗

Devuelve true si existe un dominio de traducción con el nombre especificado.


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.