TranslationServer
Eredita: Object
Il server responsabile delle traduzioni linguistiche.
Descrizione
Il server di traduzione è il backend API che gestisce tutte le traduzioni linguistiche.
Le traduzioni sono archiviate nei TranslationDomain, a cui si può accedere per nome. Il dominio di traduzione più comunemente utilizzato è il dominio di traduzione principale. Esiste sempre e vi si può accedere tramite uno StringName vuoto. Il server di traduzione fornisce metodi wrapper per accedere direttamente al dominio di traduzione principale, senza dover prima recuperare il dominio di traduzione. I domini di traduzione personalizzati sono principalmente per usi avanzati come le estensioni dell'editor. I nomi che iniziano con godot. sono riservati per le parti interne del motore.
Tutorial
Proprietà
|
Metodi
void |
add_translation(translation: Translation) |
void |
clear() |
compare_locales(locale_a: String, locale_b: String) const |
|
get_all_countries() const |
|
get_all_languages() const |
|
get_all_scripts() const |
|
get_country_name(country: String) const |
|
get_language_name(language: String) const |
|
get_loaded_locales() const |
|
get_locale() const |
|
get_locale_name(locale: String) const |
|
get_or_add_domain(domain: StringName) |
|
get_script_name(script: String) const |
|
get_translation_object(locale: String) |
|
has_domain(domain: StringName) const |
|
pseudolocalize(message: StringName) const |
|
void |
|
void |
remove_domain(domain: StringName) |
void |
remove_translation(translation: Translation) |
void |
set_locale(locale: String) |
standardize_locale(locale: String, add_defaults: bool = false) const |
|
translate(message: StringName, context: StringName = &"") const |
|
translate_plural(message: StringName, plural_message: StringName, n: int, context: StringName = &"") const |
Descrizioni delle proprietà
bool pseudolocalization_enabled = false 🔗
Se true, abilita l'uso della pseudolocalizzazione sul dominio di traduzione principale. Vedi ProjectSettings.internationalization/pseudolocalization/use_pseudolocalization per i dettagli.
Descrizioni dei metodi
void add_translation(translation: Translation) 🔗
Aggiunge una traduzione al dominio di traduzione principale.
void clear() 🔗
Rimuove tutte le traduzioni dal dominio di traduzione principale.
int compare_locales(locale_a: String, locale_b: String) const 🔗
Confronta due impostazioni locali e restituisce un punteggio di similarità tra 0 (nessuna corrispondenza) e 10 (corrispondenza totale).
PackedStringArray get_all_countries() const 🔗
Restituisce un array di codici paese noti.
PackedStringArray get_all_languages() const 🔗
Restituisce un array di codici di lingua noti.
PackedStringArray get_all_scripts() const 🔗
Restituisce un array di codici alfabeto noti.
String get_country_name(country: String) const 🔗
Restituisce un nome di paese leggibile per il codice paese country.
String get_language_name(language: String) const 🔗
Restituisce un nome di lingua leggibile per il codice di lingua language.
PackedStringArray get_loaded_locales() const 🔗
Restituisce un array di tutte le impostazioni locali caricate del progetto.
Restituisce la localizzazione attuale del progetto.
Vedi anche OS.get_locale() e OS.get_locale_language() per recuperare la localizzazione del sistema utente.
String get_locale_name(locale: String) const 🔗
Restituisce la lingua di una localizzazione e la sua variante (ad esempio "it_IT" restituirebbe "Italiano (Italia)").
TranslationDomain get_or_add_domain(domain: StringName) 🔗
Restituisce il dominio di traduzione con il nome specificato. Un dominio di traduzione vuoto verrà creato e aggiunto se non esiste.
String get_script_name(script: String) const 🔗
Restituisce un nome leggibile di alfabeto per il codice alfabeto script.
Restituisce la localizzazione attuale dell'editor.
Nota: Quando viene chiamato da un progetto esportato, restituisce lo stesso valore di get_locale().
Translation get_translation_object(locale: String) 🔗
Restituisce l'istanza di Translation che corrisponde di più alla localizzazione locale nel dominio di traduzione principale. Restituisce null se non ci sono corrispondenze.
bool has_domain(domain: StringName) const 🔗
Restituisce true se esiste un dominio di traduzione con il nome specificato.
StringName pseudolocalize(message: StringName) const 🔗
Restituisce la stringa pseudolocalizzata in base al messaggio message passato.
Nota: Questo metodo utilizza sempre il dominio di traduzione principale.
void reload_pseudolocalization() 🔗
Riesamina le opzioni di pseudolocalizzazione e ricarica la traduzione dal dominio di traduzione principale.
void remove_domain(domain: StringName) 🔗
Rimuove il dominio di traduzione con il nome specificato.
Nota: Tentare di rimuovere il dominio di traduzione principale è un errore.
void remove_translation(translation: Translation) 🔗
Rimuove la traduzione specificata dal dominio di traduzione principale.
void set_locale(locale: String) 🔗
Imposta la localizzazione del progetto. La stringa locale sarà standardizzata per corrispondere alle localizzazioni note (ad esempio, en-US sarebbe abbinata a en_US).
Se sono state caricate traduzioni in precedenza per la nuova localizzazione, saranno applicate.
String standardize_locale(locale: String, add_defaults: bool = false) const 🔗
Restituisce una stringa locale standardizzata per corrispondere alle localizzazioni note (ad esempio, en-US sarebbe abbinato a en_US). Se add_defaults è true, è possibile che alla localizzazione sia aggiunto un alfabeto o un paese predefinito.
StringName translate(message: StringName, context: StringName = &"") const 🔗
Restituisce la traduzione della lingua attuale per il messaggio e il contesto specificati.
Nota: Questo metodo utilizza sempre il dominio di traduzione principale.
StringName translate_plural(message: StringName, plural_message: StringName, n: int, context: StringName = &"") const 🔗
Restituisce la traduzione della localizzazione attuale per il messaggio, il messaggio plurale e il contesto specificati.
Il numero n è il numero o la quantità dell'oggetto plurale. Sarà usato per guidare il sistema di traduzione a recuperare la forma plurale corretta per la lingua selezionata.
Nota: Questo metodo utilizza sempre il dominio di traduzione principale.