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 🔗
Returns the Translation instances in the main translation domain that match locale (see compare_locales()). If exact is true, only instances whose locale exactly equals locale will be returned.
String format_number(number: String, locale: String) const 🔗
Converts a number from Western Arabic (0..9) to the numeral system used in the given 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 🔗
Returns the percent sign used in the given locale.
String get_plural_rules(locale: String) const 🔗
Returns the default plural rules for the 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 🔗
Returns all available Translation instances in the main translation domain as added by 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 🔗
Returns true if the main translation domain contains the given translation.
bool has_translation_for_locale(locale: String, exact: bool) const 🔗
Returns true if there are any Translation instances in the main translation domain that match locale (see compare_locales()). If exact is true, only instances whose locale exactly equals locale are considered.
String parse_number(number: String, locale: String) const 🔗
Converts number from the numeral system used in the given locale to Western Arabic (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.