Unity-本地化插件Localization

游戏本地化主要是文字和资源;图片等;随语言变化;比如游戏内一些艺术字使用的是图片;就要根据语言加载不同的图片

安装;配置

Localization是unity官方推出的本地化插件;通过PackageManager安装

使用前需要先创建本地化配置;Edit > Project Settings > Localization;生成总的配置文件

Locale Generator用于添加或移出语言;每添加一种语言也会生成对应的配置文件;然后选择默认语言的配置文件;如上图

创建表格

Window > Asset Management > Localization Tables 创建表格;用于建立不同资源之间的对应关系;就是一个key对应多个语言的资源;可以选择创建文本表或者资源表;写好表名后就可以创建了

文本表;String Table;

这里先以文本表演示;创建一个表名为MyStringTable的String Table

UI上添加一个TextMeshPro;右键选择Localize

会自动添加一个脚本;指定表名和Entry Name;也就是表中的key;;然后在场景中挂脚本进行测试

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

public class TestLocalization : 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-Hans);)
            {
                _chineseLocale = locale;
            }
            else if (locale.LocaleName == ;English (en);)
            {
                _englishLocale = locale;
            }
        }
    }

    private void OnGUI()
    {
        if (GUI.Button(new Rect(0, 0, 100, 50),;中文;))
        {
            LocalizationSettings.Instance.SetSelectedLocale(_chineseLocale);
        }
        
        if (GUI.Button(new Rect(0, 60, 100, 50),;英文;))
        {
            LocalizationSettings.Instance.SetSelectedLocale(_englishLocale);
        }
    }
}

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

public class TestLocalization2 : MonoBehaviour
{
    public TextMeshProUGUI 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(;MyStringTable;);
        yield return loadingOperation;

        if (loadingOperation.Status == AsyncOperationStatus.Succeeded)
        {
            var stringTable = loadingOperation.Result;
            text.text = stringTable.GetEntry(;id_hello;).GetLocalizedString();
        }
        else
        {
            Debug.LogError(;Could not load String Table
; ; loadingOperation.OperationException.ToString());
        }
    }
}

using UnityEngine;
using UnityEngine.Localization;
using UnityEngine.Localization.Settings;
using UnityEngine.Localization.Tables;

public class TestLocalization3 : MonoBehaviour
{
    public LocalizedStringTable stringTable = new LocalizedStringTable { TableReference = ;MyStringTable; };
    string m_TranslatedStringHello;

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

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

    void LoadStrings(StringTable stringTable)
    {
        m_TranslatedStringHello = GetLocalizedString(stringTable, ;id_hello;);
    }

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

    void OnGUI()
    {
        // We can check if the localization system is ready using the InitializationOperation.
        // Initialization involves loading locales and optionally preloading localized data for the current locale.
        if (!LocalizationSettings.InitializationOperation.IsDone)
        {
            GUILayout.Label(;Initializing Localization;);
            return;
        }
        GUILayout.Label(m_TranslatedStringHello);
    }
}

using System;

namespace UnityEngine.Localization
{
    [Serializable]
    public class LocalizedTmpFont : LocalizedAsset<TMPro.TMP_FontAsset>
    {
        
    }
}

using System;
using UnityEngine.Events;

namespace UnityEngine.Localization.Events
{
    [Serializable]
    public class UnityEventTmpFont : UnityEvent<TMPro.TMP_FontAsset>
    {
    }
}

using TMPro;
using UnityEngine.Localization.Events;

namespace UnityEngine.Localization.Components
{
    [AddComponentMenu(;Localization/Asset/Localize TmpFont Event;)]
    public class LocalizeTmpFontEvent : LocalizedAssetEvent<TMPro.TMP_FontAsset, LocalizedTmpFont, UnityEventTmpFont>
    {
        private TextMeshProUGUI text;
        private void Awake()
        {
            text = GetComponent<TextMeshProUGUI>();
        }

        protected override void UpdateAsset(TMP_FontAsset localizedAsset)
        {
            base.UpdateAsset(localizedAsset);
            text.font = localizedAsset;
        }
    }
}