oops-plugin-framework/assets/libs/gui/language/Language.ts

import { warn } from "cc";
import { EventDispatcher } from "../../../core/common/event/EventDispatcher";
import { Logger } from "../../../core/common/log/Logger";
import { LanguageData } from "./LanguageData";
import { LanguagePack } from "./LanguagePack";

export enum LanguageEvent {
    /** 语种变化事件 */
    CHANGE = 'LanguageEvent.CHANGE',
    /** 语种资源释放事件 */
    RELEASE_RES = "LanguageEvent.RELEASE_RES"
}

export class LanguageManager extends EventDispatcher {
    private _support: Array<string> = ["zh", "en", "tr"];        // 支持的语言
    private _languagePack: LanguagePack = new LanguagePack();    // 语言包

    private _defaultLanguage: string = "zh";                      // 默认语言

    /** 设置多语言系统支持哪些语种 */
    set supportLanguages(supportLanguages: Array<string>) {
        this._support = supportLanguages;
    }

    /** 默认语言,读取语言失败使用 */
    set defaultLanguage(lang: string) {
        this._defaultLanguage = lang || "zh";
    }

    /** 语言包 */
    get pack(): LanguagePack {
        return this._languagePack;
    }

    /**
     * 获取当前语种
     */
    get current(): string {
        return LanguageData.current;
    }

    /**
     * 获取支持的多语种数组
     */
    get languages(): string[] {
        return this._support;
    }

    isExist(lang: string): boolean {
        return this.languages.indexOf(lang) > -1;
    }

    /**
     * 获取下一个语种
     */
    getNextLang(): string {
        let supportLangs = this.languages;
        let index = supportLangs.indexOf(LanguageData.current);
        let newLanguage = supportLangs[(index + 1) % supportLangs.length];
        return newLanguage;
    }

    /**
     * 改变语种，会自动下载对应的语种，下载完成回调
     * @param language 
     */
    setLanguage(language: string, callback: (success: boolean) => void) {
        if (!language) {
            language = this._defaultLanguage;
        }
        language = language.toLowerCase();
        let index = this.languages.indexOf(language);
        if (index < 0) {
            warn("当前不支持该语种" + language + ` 将自动切换到 ${this._defaultLanguage} 语种!`);
            language = this._defaultLanguage;
        }
        if (language === LanguageData.current) {
            callback(false);
            return;
        }

        this.loadLanguageAssets(language, (lang: string) => {
            Logger.logConfig(`当前语言为【${language}】`);
            LanguageData.current = language;
            this._languagePack.updateLanguage(language);
            this.dispatchEvent(LanguageEvent.CHANGE, lang);
            callback(true);
        });
    }

    /**
     * 根据data获取对应语种的字符
     * @param labId 
     * @param arr 
     */
    getLangByID(labId: string): string {
        return LanguageData.getLangByID(labId);
    }

    /**
     * 下载语言包素材资源
     * 包括语言json配置和语言纹理包
     * @param lang 
     * @param callback 
     */
    loadLanguageAssets(lang: string, callback: Function) {
        lang = lang.toLowerCase();
        return this._languagePack.loadLanguageAssets(lang, callback);
    }

    /**
     * 释放不需要的语言包资源
     * @param lang 
     */
    releaseLanguageAssets(lang: string) {
        lang = lang.toLowerCase();
        this._languagePack.releaseLanguageAssets(lang);
        this.dispatchEvent(LanguageEvent.RELEASE_RES, lang);
    }
}