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
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
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).
Array[Translation] find_translations(locale: String, exact: bool) const 🔗
Restituisce le istanze di Translation nel dominio di traduzione principale che corrispondono a locale (vedi compare_locales()). Se exact è true, vengono restituite solo le istanze la cui localizzazione è esattamente uguale a locale.
String format_number(number: String, locale: String) const 🔗
Converte un numero dall'arabo occidentale (0..9) al sistema numerico utilizzato nella localizzazione locale.
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_percent_sign(locale: String) const 🔗
Restituisce il simbolo di percentuale utilizzato nella localizzazione locale.
String get_plural_rules(locale: String) const 🔗
Restituisce le regole predefinite per il plurale per la localizzazione locale.
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) 🔗
Deprecato: Use find_translations() instead.
Restituisce l'istanza di Translation che corrisponde di più alla localizzazione locale nel dominio di traduzione principale. Restituisce null se non ci sono corrispondenze.
Array[Translation] get_translations() const 🔗
Restituisce tutte le istanze di Translation disponibili nel dominio di traduzione principale, come sono state aggiunte tramite add_translation().
bool has_domain(domain: StringName) const 🔗
Restituisce true se esiste un dominio di traduzione con il nome specificato.
bool has_translation(translation: Translation) const 🔗
Restituisce true se il dominio di traduzione principale contiene la traduzione translation.
bool has_translation_for_locale(locale: String, exact: bool) const 🔗
Restituisce true se ci sono istanze di Translation nel dominio di traduzione principale che corrispondono a locale (vedi compare_locales()). Se exact è true, vengono considerate solo le istanze la cui localizzazione è esattamente uguale a locale.
String parse_number(number: String, locale: String) const 🔗
Converte il numero number dal sistema numerico utilizzato nella localizzazione locale in arabo occidentale (0..9).
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.