Unity 多语言轻量高效的多语言工具集 LanguageManager

原创已于 2023-02-20 13:14:24 修改 · 1.1k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#unity #多语言

于 2023-02-16 18:10:09 首次发布

Unity 专栏收录该内容

49 篇文章

订阅专栏

效果展示

在这里插入图片描述

支持excel导入自动化

组件化更方便

在这里插入图片描述

也提供直接获取多语言的接口

没有挂 LanguageText的对象也可以获取多语言文本内容
在这里插入图片描述

支持 Format接口可以传递N个参数进来组装多语言

在这里插入图片描述

支持首次系统语言自测

在这里插入图片描述

支持语言切换后本地自动保存配置

在这里插入图片描述

支持实时切换同步刷新所有UI

在这里插入图片描述

容错处理

当设置当前多语言为不存在的多语言语种时选择默认语言( 英文 )
当默认语言( 英文 ) 没有的时候默认选择第一个多语言
当更新多语言时新的多语言只有存在的时候才会刷新文本显示避免多语言ID错误
每个LanguageText组件提供 UpdateText( string customContent = null ) 可以自定义设置文本

部分源码

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;

[RequireComponent( typeof( Text ) )]
public class LanguageText : MonoBehaviour
{

    [SerializeField]
    private int m_mulID = 0;

    //多语言ID
    public int mulID
    {
        get
        {
            return m_mulID;
        }
        set
        { 
            var newTextValue = LanguageManager.GetInstance().GetText( value );
            if ( !string.IsNullOrEmpty( newTextValue ) )
            {
                m_mulID = value;
                UpdateText( newTextValue );
            }
        }
    }

    //UGUI Text 句柄
    Text textHandler = null;

    //可以指定内容
    public void UpdateText( string customContent = null )
    {
        if ( null == textHandler )
        {
            textHandler = GetComponent<Text>();
        }

        if( customContent == null )
        {
            customContent = LanguageManager.GetInstance().GetText( mulID );
        }

        textHandler.text = customContent;
    }

    private void Awake()
    {
        LanguageManager.GetInstance().___AddLanguageTextComponent( this );
    }

    private void OnEnable()
    {
        if ( !LanguageManager.GetInstance().inite )
        {
            //未初始完成 后续初始化完成后会由Manager再调用更新的 不用担心
            return;
        }
        UpdateText();
    }

    //有可能切出去修改了设备语言
    private void OnApplicationFocus( bool focus )
    {
        if ( focus ) UpdateText();
    }

    private void OnDestroy()
    {
        LanguageManager.GetInstance().___RemoveLanguageTextComponent( this );
    }
}