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

Translation

继承： Resource < RefCounted < Object

派生： OptimizedTranslation

语言翻译，能够将一组字符串映射到对应的翻译。

描述

Translation 是可以按需加载和卸载的资源，能够将一组字符串映射到对应的翻译。还为复数形式提供了便捷方法。

教程

• 将游戏国际化

• 区域设置

属性

String

locale

"en"

方法

StringName	_get_message(src_message: StringName, context: StringName) virtual const
StringName	_get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName) virtual const
void	add_message(src_message: StringName, xlated_message: StringName, context: StringName = &"")
void	add_plural_message(src_message: StringName, xlated_messages: PackedStringArray, context: StringName = &"")
void	erase_message(src_message: StringName, context: StringName = &"")
StringName	get_message(src_message: StringName, context: StringName = &"") const
int	get_message_count() const
PackedStringArray	get_message_list() const
StringName	get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName = &"") const
PackedStringArray	get_translated_message_list() const

---

属性说明

String locale = "en" 🔗

• void set_locale(value: String)

• String get_locale()

翻译的区域设置。

---

方法说明

StringName _get_message(src_message: StringName, context: StringName) virtual const 🔗

覆盖 get_message() 的虚方法。

---

StringName _get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName) virtual const 🔗

覆盖 get_plural_message() 的虚方法。

---

void add_message(src_message: StringName, xlated_message: StringName, context: StringName = &"") 🔗

如果不存在，则添加一条消息，后跟其翻译。

可以使用一个额外的上下文，来指定翻译上下文或区分多义词。

---

void add_plural_message(src_message: StringName, xlated_messages: PackedStringArray, context: StringName = &"") 🔗

如果不存在，则添加一条涉及复数翻译的消息，后跟其翻译。

可以使用一个额外的上下文，来指定翻译上下文或区分多义词。

---

void erase_message(src_message: StringName, context: StringName = &"") 🔗

删除信息。

---

StringName get_message(src_message: StringName, context: StringName = &"") const 🔗

返回信息的翻译。

---

int get_message_count() const 🔗

返回现有信息的数量。

---

PackedStringArray get_message_list() const 🔗

返回所有的信息（键值）。

---

StringName get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName = &"") const 🔗

返回一条消息涉及复数的翻译。

数字 n 是复数对象的数目或数量。它将被用于指导翻译系统为所选语言获取正确的复数形式。

---

PackedStringArray get_translated_message_list() const 🔗

返回所有信息（翻译后的文本）。