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.

將遊戲國際化

前言

雖然獨立或小眾遊戲通常不需要本地化,但如果目標是更大規模的市場,則經常需要翻譯和本地化。Godot 提供了許多工具,讓這個流程更加簡單,因此這份教學更像是匯集了一些實用的小技巧和建議。

當地語系化通常是通過雇傭特定的工作室來完成的,儘管有大量的軟體和檔案格式可供使用,但迄今為止進行當地語系化最常見的方式仍然是使用試算表。建立試算表並匯入試算表的過程已經在 匯入翻譯 教學中介紹過了,所以這個教學更像是對那個教學的後續。

備註

我們將以官方範例專案作為示範,你可以從「資源庫」下載:Asset Library。

配置匯入的譯文

翻譯更改時可以更新並重新匯入,但它們仍需被新增到專案中。這可以在專案 > 專案設定 > 在地化 > 翻譯中完成:

../../_images/localization_dialog.webp

上述對話方塊用於新增或刪除專案範圍內的翻譯。

資源的當地語系化

也可以指示 Godot 使用資產 (資源) 的替代版本,根據目前的語言。這可用於本地化影像,例如遊戲內的看板或本地化語音。

重映射分頁可用於此目的:

../../_images/localization_remaps.webp

選擇需要重定向的資源,並指定它在其他語言地區的替代方案。

備註

DynamicFonts 不支援資源重新對應系統。若要根據語言的腳本使用不同的字形,請改用 DynamicFont 後備系統,它允許您定義任意數量的後備字形。

DynamicFont 後備系統的優點是,無論目前語言如何,它都可以工作,這使其非常適合文字語言可能與客戶端語言不配對的多人聊天等情況。

自動設定語言

建議預設使用使用者的首選語言,可以通過 OS.get_locale_language() 取得。如果你的遊戲不支援該語言,則會回退到專案 > 專案設定 > 常規 > 國際化 > 區域設定中的回退,如果為空則回退到 en。不管怎樣,出於各種原因(例如翻譯品質或玩家偏好),建議讓玩家能夠在遊戲中更改語言。

var language = "automatic"
# Load here language from the user settings file
if language == "automatic":
   var preferred_language = OS.get_locale_language()
   TranslationServer.set_locale(preferred_language)
else:
   TranslationServer.set_locale(language)

本地化和語系

一個 語系 通常是語言與地區或國家的組合,但也可以包含像是文字書寫系統或變體等資訊。

範例:

  • en: 英文

  • en_GB: 英文(英國)

  • en_US: 英文(美國

  • en_DE: 英文(德國)

獨立遊戲一般只需要關心語言,但請繼續閱讀以獲得更多資訊。

美國和英國的例子可以說明區域設定存在的必要性。兩者使用同一種語言(英語),但在許多方面存在差異:

  • 拼寫:例如 gray(美國)、grey(英國)

  • 用詞:例如 eggplant(美國)、aubergine(英國)

  • 單位或貨幣:例如英尺/英吋(美國)、米/釐米(英國)

然而,這可能會變得更複雜。假設您在歐洲和中國提供不同的內容 (例如在大型多人線上遊戲中)。您需要將各種不同的內容翻譯為多種語言,並據此進行儲存和載入。

將鍵轉換為文字

某些控制項,例如按鈕和標籤,如果它們的文字與翻譯鍵匹配,將自動取得翻譯。例如,如果標籤的文字是 MAIN_SCREEN_GREETING1,並且該鍵存在於目前翻譯中,則文字將被自動翻譯。

某些情況下可能不希望出現這種自動翻譯。例如,當使用 Label 顯示玩家名稱時,如果玩家名稱與翻譯鍵匹配,你很可能不希望翻譯該名稱。要停用特定節點的自動翻譯,請在屬性檢視器中將Auto Translate > Mode設定為 Disabled。

在程式碼中, 可以使用 Object.tr() 函式. 這將只是在翻譯中搜尋文字, 如果找到的話就進行轉換:

# Using a static key.
level.text = tr("LEVEL_5_NAME")
# Using a dynamic key.
status.text = tr("GAME_STATUS_%d" % status_index)

備註

如果更改語言後不顯示任何文字,請嘗試換一個字形。預設專案字形僅支援 Latin-1 字元集的子集,無法用於顯示俄語、漢語等文字。

多語言字形的一個很好的資源是「Noto Fonts <https://www.google.com/get/noto/>」。如果您使用的是不太常見的語言,請確保下載正確的變體。

下載字形後,將 TTF 檔案載入到 DynamicFont 資源中,並將其用作控制節點的自訂字形。為了獲得更好的可重複使用性,請將新的主題資源關聯到根控制節點,並將 DynamicFont 定義為主題中的預設字形。

佔位符

To feature placeholders in your translated strings, use GDScript 格式化字串 or string.Format() in C#. This lets translators move the location of the placeholder in the string freely, which allows translations to sound more natural. Named placeholders with the String.format() function should be used whenever possible, as they also allow translators to choose the order in which placeholders appear:

# The placeholder's locations can be changed, but not their order.
# This will probably not suffice for some target languages.
message.text = tr("%s picked up the %s") % ["Ogre", "Sword"]

# The placeholder's locations and order can be changed.
# Additionally, this form gives more context for translators to work with.
message.text = tr("{character} picked up the {weapon}").format({character = "Ogre", weapon = "Sword"})

翻譯語境

如果你使用普通的英文所謂來源字串(而不是類似於 LIKE_THIS 的消息程式碼),那麼就有可能會遇到歧義的情況,同一個英文字串可能需要在某些目的語言中翻譯為不同的字串。你可以通過指定可選的 翻譯本文 來消除歧義,即便原始字串是相同的,也能夠讓目的語言能夠使用不同的字串:

# "Close", as in an action (to close something).
button.set_text(tr("Close", "Actions"))

# "Close", as in a distance (opposite of "far").
distance_label.set_text(tr("Close", "Distance"))

複數化

多數語言會根據單數或複數而使用不同的字串。不過,單純以物件數量是否大於 1 來判斷是否為複數,對所有語言都不適用。

有些語言有兩種以上的複數形式,不同的複數需要的物件數量也各不相同。Godot 提供了對 複數 的支援,目標地區可以自動進行處理。

複數應該只用於正整數(或零)的情況。負數和浮點數所代表的物理實體數量是單數還是複數一般無法明確區分。

var num_apples = 5
label.text = tr_n("There is %d apple", "There are %d apples", num_apples) % num_apples

如有需要,也可以與語境(context)結合使用:

var num_jobs = 1
label.text = tr_n("%d job", "%d jobs", num_jobs, "Task Manager") % num_jobs

讓控制項可調整大小

不同語言的相同文字的長度差異很大。為此,請務必閱讀教學 尺寸與錨點,因為動態調整控制項大小可能有所説明。Container 可能很有用,Label 的文字換行選項應該也能幫上忙。

要檢查你的 UI 是否能容納比原文更長的譯文,可以在進階專案設定中啟用 pseudolocalization。這會將所有可在地化的字串替換為更長的版本,同時把原字串中的部分字元換成帶重音(仍可辨識)的版本。佔位符會保持不變,以確保在啟用偽本地化時仍可正常運作。

例如,當啟用偽本地化時,字串「Hello world, this is %s!」將變為「[Ĥéłłô ŵôŕłd́, ŧh̀íš íš %s!]」。

雖然第一眼看上去很奇怪,但是偽當地語系化的好處有很多:

  • 它可以讓您快速發現不可本地化的字串,這樣您就可以檢查它們並使它們可本地化(如果這樣做有意義的話)。

  • 它可以讓您檢查無法容納長字串的 UI 元素。許多語言的翻譯都會比原始文字長得多,因此確保您的 UI 能夠容納比平常更長的字串非常重要。

  • 它讓您檢查您的字型是否包含支援各種語言所需的所有字元。然而,由於偽本地化的目標是保持原始字串可讀,因此它不是一個有效的測試,無法檢查字型是否能支援 CJK 或由右至左書寫的語言。

專案設定可讓您調整偽本地化行為,以便您可以根據需要停用其部分內容。

TranslationServer(翻譯伺服器)

Godot 具有一個處理底層翻譯管理的伺服器,稱為 翻譯伺服器。可以在執行期間新增或移除翻譯;目前的語言也可以在執行期間變更。

雙向文字和 UI 鏡像

阿拉伯語和希伯來語是從右到左書寫的(除了混合的數字和拉丁單字),這些語言的使用者介面也應該是鏡像的。在某些語言中,字形的形狀會根據周圍的字元而變化。

對雙向書寫系統和 UI 鏡像的支援是透明的,您通常不需要更改任何內容或了解特定書寫系統。

對於 RTL(從右至左)語言,Godot 會自動對 UI 進行以下調整:

  • 鏡像左右錨點和邊距。

  • 交換文字的左對齊和右對齊。

  • 鏡像容器中子控制項的水平順序以及 Tree/ItemList 控制項中專案的水平順序。

  • 使用內部控制項元素的鏡像順序(例如 OptionButton 下拉按鈕、CheckBox/CheckButton 對齊方式、清單列順序、TreeItem 圖示和連接線對齊方式)。在某些情況下,鏡像控制項使用單獨的主題樣式。

  • 座標系不會被鏡像。

  • 非 UI 節點(精靈等)不會受到影響。

可以使用下列控制項屬性來覆寫文字和控制項佈局方向:

  • text_direction,設定基礎文字方向。當設定為“auto”時,方向取決於文字中根據 Unicode 雙向算法的第一個強方向字元。

  • language,覆蓋目前專案區域設定。

  • structured_text_bidi_override 屬性和 _structured_text_parser 回呼,可以對結構化文字進行特殊處理。

  • “layout_direction”,覆蓋控制鏡像。

../../_images/ui_mirror.png

也參考

您可以使用 BiDI 與字型功能示範專案 來實際查看由右至左排版是如何運作的。

將斷詞資料新增到匯出專案

有些語言書寫時不使用空格。對於這些語言,斷詞與換行需要不僅僅是字元序列規則。Godot 包含基於 ICU 規則與字典的斷詞迭代器資料,但在匯出的專案中預設不會包含這些資料。

要包含這些資料,請轉到專案 > 專案設定 > 常規 > 國際化 > 區域設定,啟用包括文字伺服器資料,然後匯出專案。分詞迭代器資料的大小約為 4 MB。

結構化文字 BiDi 覆寫

Unicode BiDi 演算法設計用於處理自然文字,它無法處理具有更高層級順序的文字,例如檔案名稱、URI、電子郵件地址、正規表示式或原始程式碼。

../../_images/bidi_override.png

例如,所顯示的目錄結構的路徑將顯示不正確(頂部「LineEdit」控制項)。 「檔案」型別結構化文字會覆寫將文字分割成段,然後將 BiDi 演算法單獨套用到每個段,以正確顯示任何語言的目錄名稱並保留資料夾的正確順序(底部「LineEdit」控制項)。

自訂回調提供了一種覆蓋其他型別結構化文字的 BiDi 的方法。

數字本地化

專門設計用於數值輸入或輸出的 Control (例如 ProgressBar、SpinBox) 將會自動使用本地化數字系統,對於其他 Control,TextServer.format_number(string, language) 可用於將西方阿拉伯數字 (0..9) 轉換到本地化數字系統,以及 TextServer.parse_number(string, language) 將其轉換回來。

圖示與圖片本地化

帶有左右指向箭頭的圖示可能需要在阿拉伯語和希伯來語語言環境中顛倒過來,以防它們指示移動或方向(例如後退/前進按鈕)。否則,它們可以保持不變。

翻譯測試

在發佈前你可能會想測試專案的翻譯。Godot 為此提供三種方法。

第一,在專案 > 專案設定 > 常規 > 國際化 > 區域設定下(啟用進階設定後)有一個測試屬性。將此屬性設定為你想要測試的語言的區域設定程式碼。當專案執行時(無論是從編輯器執行還是匯出後執行),Godot 將使用該區域設定執行專案。

../../_images/locale_test.webp

請記住,因為這是一個專案設定,設為非空時會在版本控制中顯示。因此,將修改提交到版本控制之前,應該將其設回空值。

其次,在編輯器中前往上方選單點選 View,接著前往 Preview Translation 並選擇你想預覽的語言。

../../_images/locale_editor_preview.webp

此時編輯器中場景的所有文字應會以所選語言顯示。

翻譯也可以在 從命令列執行 Godot 時 測試。例如,若要測試法文的遊戲,可以提供以下引數:

godot --language fr

專案名稱翻譯

專案名稱在匯出到不同作業系統和平台時會成為應用名稱。要以多種語言指定專案名稱,請轉到專案 > 專案設定 > 常規 > 應用 > 設定。在這裡,點擊可在地化字串 (大小 0)按鈕,然後點擊新增翻譯按鈕。這將把你帶到一個頁面,你可以在其中為專案名稱翻譯選擇語言(以及如果需要,選擇國家)。完成後,你就可以輸入在地化的名稱。

../../_images/localized_name.webp

如果您不確定要使用的語言代碼,請參閱 語言環境代碼列表。