Unity Localization 初步了解及使用

前言

前段时间做的项目中有用到 Zenject + UniTask + UniRx + Localization + GoogleSheet + Addressable，后续文章中会挨个说明，本期先来介绍一下Localization。
为了让游戏在全球市场中取得成功，开发者需要确保游戏可以被不同语言和文化的玩家轻松理解和接受。Unity 提供的 Localization 插件是实现这一目标的强大工具。本篇博客将介绍 Unity Localization 插件的基础功能，并分享如何在项目中使用它进行本地化设置的最佳实践。

一、 Unity Localization 插件优点

• 官方支持：作为 Unity 官方推出的工具，Localization 插件与 Unity 的其他工具和功能高度集成，确保了良好的兼容性和稳定性。
• 易于使用：该插件提供了直观的用户界面和简洁的 API，使得即使是没有本地化经验的开发者也能轻松上手。
• 支持多种内容类型：除了文本翻译，Localization 插件还支持音频、图片和其他资源的本地化，满足游戏开发中的各种需求。
• 动态更新：插件支持运行时加载和动态更新翻译内容，无需重新构建整个项目。

二、在项目中使用 Unity Localization 插件

1.安装插件

在 Unity 的 Package Manager 中搜索 “Localization” 插件并安装。

2.创建本地化表格

Edit => Project Settings => Localization, 在项目中创建新的 Localize Table，用于管理多语言文本。你可以根据需要为不同内容（如 UI 文本、对话等）创建多个表格。

3.添加翻译内容

找到并点击Window => Asset Management =>.Localization Tables, 在本地化表格中添加原文，并为每种目标语言输入对应的翻译文本。你可以手动输入或导入翻译表格（如 CSV 文件）。

4.应用本地化

在场景中的 UI 元素或脚本中使用 LocalizedString 来引用本地化文本。可以通过语言切换功能动态调整当前显示的语言。

---

三、使用 Unity Localization 代码示例

1.静态使用本地化内容的示例代码

静态使用是指在编译时就已经决定了使用的语言和本地化内容。这种方法适用于内容不需要在运行时动态更新的场景。
// 使用静态本地化内容

  // 使用静态本地化内容
  startButtonText.text = LocalizationSettings.StringDatabase.GetLocalizedString("UI", "StartGame");
  settingsButtonText.text = LocalizationSettings.StringDatabase.GetLocalizedString("UI", "Settings");

2.动态使用本地化内容的示例代码

动态使用本地化内容意味着在运行时根据当前选择的语言动态加载和更新本地化文本。这通常用于需要在游戏中途改变语言的场景。

 // 通过 LocalizeStringEvent 动态加载本地化内容
 startButtonLocalizedText.StringReference.SetReference("UI", "StartGame");
 settingsButtonLocalizedText.StringReference.SetReference("UI", "Settings");

3.多语言切换的实现

在游戏中实现多语言切换的功能，可以通过以下代码实现。

 // 切换到指定索引的语言
 LocalizationSettings.SelectedLocale = LocalizationSettings.AvailableLocales.Locales[languageIndex];

4.运行时展示

game窗口左上角

总结

Unity Localization 插件为游戏开发者提供了一个强大且易于使用的工具，帮助你轻松实现游戏的多语言支持。不仅支持文本的本地化，也支持图片等资源的本地化，满足了多语言和多文化场景下的游戏开发需求。
在本篇博客中，我们介绍了 Localization 插件的基本功能和使用方法，并通过代码示例展示了如何在项目中实现文本和图片的本地化。希望这些内容能够帮助你更好地理解并应用 Unity Localization 插件。
参考资料
[https://https://docs.unity3d.com/Packages/com.unity.localization@1.0/manual/index.html](Unity 官方文档 - Localization 插件)
[https://unity.com/cn/blog](Unity Blog - Best Practices for Localization)