前言

Unity的多语言本地化是一个很实用的功能，它可以帮助游戏支持多种语言，让不同语言的玩家都能够更好地体验游戏。
而实现本地化的方案也有很多种，各个方案之间也各有优劣，后面也会对多个方案进行介绍学习。
本文就来介绍一个专门作用于多语言本地化的Unity官方插件：Localization 。
这个插件方便进行游戏的多语言本地化，让游戏支持多种语言，下面就来看看该插件的使用方法吧！

【Unity 实用工具篇】| 游戏多语言解决方案，官方插件Localization 实现本地化及多种语言切换

一、多语言本地化插件 Localization

1.1 介绍

Localization是Unity官方推出的本地化插件，它可以帮助开发者在Unity项目中实现多语言支持。

在Unity中，Localization的工作原理是创建多个表格来存储不同语言的不同字符串。

可以通过Localization Tables创建这些表格，表格可以建立不同资源之间的对应关系，一个key对应多个语言的资源。

通过使用Localization插件，开发者可以方便地设置和获取当前语言和当前语言地区，从而为游戏或应用程序提供多种语言的支持。

这对于那些需要面向不同地区和不同语言的用户发布游戏或应用程序的开发者来说是非常有用的。

1.2 效果展示

1.3 使用说明

官方文档：官方文档

本文使用的Localization版本为1.4.5，Unity引擎版本为2023.1.9。

后续插件可能会有更新，或者使用老版本的插件时功能使用上可能会有所不同，实际使用时按照自己的版本要求即可。

二、插件导入并配置

2.1 安装 Localization

打开菜单栏 Window -> Package Manager ，在搜索框中搜索Localization 并进行安装即可。

要注意Packages选择Unity Registry，不然可能搜不到该插件哦。

2.2 全局配置

打开菜单栏 Edit -> Project Settings -> Localization -> Create，找到Localization，点击Create创建，并选择一个文件目录进行文件保存。

点击 Locale Generator 搜索zh和en添加中英文配置，第一次添加时会让我们选择一个文件夹目录保存。

Locale Generator 用于添加或移出语言，每添加一种语言也会生成对应的配置文件，然后可以修改默认语言为中文，如下图所示：

三、多语言映射表

3.1 创建多语言文本配置表

打开菜单栏 Window -> Asset Management -> Localization Tables ，点击New Table Collection创建表格。

该表格用于建立不同资源之间的对应关系，一个key对应多个语言的资源，可以选择创建文本表或者资源表。

这里我们选择文本表(String Table Collection)使用，写好表名后点击Create就可以创建了，然后选择一个路径目录进行保存。

经过上面几个配置后可以在我们前面保存文件的路径下看到相关的文件，这里最好是根据自己的情况选择合适的文件夹进行管理保存。

3.2 添加多语言文本配置表内容

此时在Localization Tables中添加多语言文本即可，配置内容主要是Key和对应多种语言的文本。

可通过Window -> Asset Management -> Localization Tables 打开该窗口。

实际项目中不一定将多语言内容全部写在一个配置表中，不同的文本内容也可以通过创建多个配置表进行填写，让不同的模块自己管理文本内容也是一个不错的选择。

3.3 静态文本

此时在场景中添加一个文本组件Text，然后在该组件右侧菜单处点击Localize，会自动添加一个Localize String Event组件。（这里也可以手动在下面添加Localize String Event组件，不过还要手动配置该组件绑定的Text组件，稍微麻烦一些，功能都是一样的）

此时在该组件中的String Reference参数中选择之前配置的多语言文本配置表中的Key即可完成多语言的配置。

此时运行程序，可以看到该Text组件的文本内容已经变成我们配置多语言文本配置表中的Key对应的文本了。

通过Game视图右上角的语言选择可以切换语种，点击切换不同语言后，Game视图中的文本也会即时的跟着切换了。

这样我们的静态文本就可以通过这种方法来添加多语言文本配置表中的Key绑定多语言了。

也可以通过脚本控制语言的切换，测试代码如下：

csharp 复制代码

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.Localization;
using UnityEngine.Localization.Settings;
using UnityEngine.ResourceManagement.AsyncOperations;

public class LanguageManager : MonoBehaviour
{
    AsyncOperationHandle m_InitializeOperation;
    private Locale _chineseLocale;
    private Locale _englishLocale;

    void Start()
    {
        // SelectedLocaleAsync will ensure that the locales have been initialized and a locale has been selected.
        m_InitializeOperation = LocalizationSettings.SelectedLocaleAsync;
        if (m_InitializeOperation.IsDone)
        {
            InitializeCompleted(m_InitializeOperation);
        }
        else
        {
            m_InitializeOperation.Completed += InitializeCompleted;
        }
    }

    void InitializeCompleted(AsyncOperationHandle obj)
    {
        var locales = LocalizationSettings.AvailableLocales.Locales;
        for (int i = 0; i < locales.Count; ++i)
        {
            var locale = locales[i];
            if (locale.LocaleName == "Chinese (Simplified) (zh)")
            {
                _chineseLocale = locale;
            }
            else if (locale.LocaleName == "English (en)")
            {
                _englishLocale = locale;
            }
        }
    }

    public void SwitchChinese()
    {
        LocalizationSettings.Instance.SetSelectedLocale(_chineseLocale);
    }
    public void SwitchEnglish()
    {
        LocalizationSettings.Instance.SetSelectedLocale(_englishLocale);
    }
}

将该脚本挂载到场景中，并在场景中添加两个Button分别绑定切换中英文的方法即可。

上述脚本代码也可以换成下方这种，更简单粗暴的方法切换语言。

csharp 复制代码

using UnityEngine;
using UnityEngine.Localization.Settings;

public class LanguageManager : MonoBehaviour
{
    public void SwitchChinese()
    {
        LocalizationSettings.SelectedLocale = LocalizationSettings.AvailableLocales.Locales[0];
    }
    public void SwitchEnglish()
    {
        LocalizationSettings.SelectedLocale = LocalizationSettings.AvailableLocales.Locales[1];
    }
}

索引值为Localization 的配置项中的多种语言的顺序，如下方第一个语言为中文则索引为0。

3.2 动态文本

除了可以设置静态文本，也可以在代码中获取对应的文本并进行动态设置，下面看一下动态文本的设置方法。

设置动态文本的方法有很多种，可以看情况选择，具体原理可以在官方文档仔细查阅，这里就直接写几种方法的使用示例。

1.最简单粗暴的方法，直接动态读表赋值。

csharp 复制代码

using UnityEngine;
using UnityEngine.Localization.Settings;
using UnityEngine.UI;

public class TestLocalization : MonoBehaviour
{
    public Text text;

    void Start()
    {
        var loadingResult = LocalizationSettings.StringDatabase.GetTableEntry("UITestTable", "ui_Test");
        text.text = loadingResult.Entry.GetLocalizedString();
    }
}

GetTableEntry() 第一个参数为多语言配置表的名字，第二个参数为该表里面的Key。

通过方法传入多语言配置表的名字及对应多语言的Key即可完成动态文本赋值。

不过要注意的是字符串表可能不会立即可用，例如在本地化系统初始化期间或尚未加载表时。

为了保险起见，可以确保该多语言配置表被加载出之后再进行赋值，可以来看第二种方法的使用示例。

2.等待语言配置表初始化之后在赋值。

csharp 复制代码

using System.Collections;
using UnityEngine.ResourceManagement.AsyncOperations;
using UnityEngine;
using UnityEngine.Localization.Settings;
using UnityEngine.UI;

public class TestLocalization : MonoBehaviour
{
    public Text text;

    void Start()
    {
        StartCoroutine(LoadStrings());
    }

    IEnumerator LoadStrings()
    {
        // A string table may not be immediately available such as during initialization of the localization system or when a table has not been loaded yet.
        var loadingOperation = LocalizationSettings.StringDatabase.GetTableAsync("UITestTable");
        yield return loadingOperation;
    
        if (loadingOperation.Status == AsyncOperationStatus.Succeeded)
        {
            var stringTable = loadingOperation.Result;
            text.text = stringTable.GetEntry("ui_Test").GetLocalizedString();
        }
        else
        {
            Debug.LogError("Could not load String Table\n" + loadingOperation.OperationException.ToString());
        }
    }
}

3.初始化时获得该多语言配置表，事件动态更新文本。

csharp 复制代码

using UnityEngine;
using UnityEngine.Localization;
using UnityEngine.Localization.Tables;
using UnityEngine.UI;

public class Demo : MonoBehaviour
{
    public Text Name;
    private LocalizedStringTable stringTable = new LocalizedStringTable { TableReference = "UITestTable" };

    void OnEnable()
    {
        stringTable.TableChanged += LoadStrings;
    }

    void OnDisable()
    {
        stringTable.TableChanged -= LoadStrings;
    }

    void LoadStrings(StringTable stringTable)
    {
        Name.text = GetLocalizedString(stringTable, "ui_Test");
    }

    static string GetLocalizedString(StringTable table, string entryName)
    {
        var entry = table.GetEntry(entryName);
        return entry.GetLocalizedString();
    }
}