- 引入 UnityGameFramework

- 使用 Luban 替代原来的 UGF 的数据表
2026-08-30 18:08:55 +08:00
parent 42ad134759
commit 92bf3e9097
1925 changed files with 362268 additions and 4859 deletions
@@ -0,0 +1,76 @@
+//------------------------------------------------------------
+// Game Framework
+// Copyright © 2013-2021 Jiang Yin. All rights reserved.
+// Homepage: https://gameframework.cn/
+// Feedback: mailto:ellan@gameframework.cn
+//------------------------------------------------------------
+
+using GameFramework;
+using GameFramework.Localization;
+using UnityEngine;
+
+namespace UnityGameFramework.Runtime
+{
+    /// <summary>
+    /// 本地化辅助器基类。
+    /// </summary>
+    public abstract class LocalizationHelperBase : MonoBehaviour, IDataProviderHelper<ILocalizationManager>, ILocalizationHelper
+    {
+        /// <summary>
+        /// 获取系统语言。
+        /// </summary>
+        public abstract Language SystemLanguage
+        {
+            get;
+        }
+
+        /// <summary>
+        /// 读取字典。
+        /// </summary>
+        /// <param name="localizationManager">本地化管理器。</param>
+        /// <param name="dictionaryAssetName">字典资源名称。</param>
+        /// <param name="dictionaryAsset">字典资源。</param>
+        /// <param name="userData">用户自定义数据。</param>
+        /// <returns>是否读取字典成功。</returns>
+        public abstract bool ReadData(ILocalizationManager localizationManager, string dictionaryAssetName, object dictionaryAsset, object userData);
+
+        /// <summary>
+        /// 读取字典。
+        /// </summary>
+        /// <param name="localizationManager">本地化管理器。</param>
+        /// <param name="dictionaryAssetName">字典资源名称。</param>
+        /// <param name="dictionaryBytes">字典二进制流。</param>
+        /// <param name="startIndex">字典二进制流的起始位置。</param>
+        /// <param name="length">字典二进制流的长度。</param>
+        /// <param name="userData">用户自定义数据。</param>
+        /// <returns>是否读取字典成功。</returns>
+        public abstract bool ReadData(ILocalizationManager localizationManager, string dictionaryAssetName, byte[] dictionaryBytes, int startIndex, int length, object userData);
+
+        /// <summary>
+        /// 解析字典。
+        /// </summary>
+        /// <param name="localizationManager">本地化管理器。</param>
+        /// <param name="dictionaryString">要解析的字典字符串。</param>
+        /// <param name="userData">用户自定义数据。</param>
+        /// <returns>是否解析字典成功。</returns>
+        public abstract bool ParseData(ILocalizationManager localizationManager, string dictionaryString, object userData);
+
+        /// <summary>
+        /// 解析字典。
+        /// </summary>
+        /// <param name="localizationManager">本地化管理器。</param>
+        /// <param name="dictionaryBytes">要解析的字典二进制流。</param>
+        /// <param name="startIndex">字典二进制流的起始位置。</param>
+        /// <param name="length">字典二进制流的长度。</param>
+        /// <param name="userData">用户自定义数据。</param>
+        /// <returns>是否解析字典成功。</returns>
+        public abstract bool ParseData(ILocalizationManager localizationManager, byte[] dictionaryBytes, int startIndex, int length, object userData);
+
+        /// <summary>
+        /// 释放字典资源。
+        /// </summary>
+        /// <param name="localizationManager">本地化管理器。</param>
+        /// <param name="dictionaryAsset">要释放的字典资源。</param>
+        public abstract void ReleaseDataAsset(ILocalizationManager localizationManager, object dictionaryAsset);
+    }
+}