using System;
using UnityEngine;

namespace BaseGames.Localization
{
    /// <summary>
    /// 本地化字符串访问工具类（架构 16_SupportingModules §4）。
    /// 当 Unity Localization 包（com.unity.localization）安装后使用 LocalizationSettings 实现完整功能；
    /// 未安装时退回到 Key 直传（返回 entryKey 本身）。
    /// </summary>
    public static class LocalizationManager
    {
#if UNITY_LOCALIZATION
        private const string DefaultTable = "UI";

        /// <summary>从指定表中获取本地化字符串。</summary>
        public static string Get(string entryKey, string tableName = DefaultTable)
        {
            try
            {
                var op = UnityEngine.Localization.Settings.LocalizationSettings
                    .StringDatabase.GetLocalizedStringAsync(tableName, entryKey);
                return op.IsDone ? op.Result : entryKey;
            }
            catch (Exception e)
            {
                Debug.LogWarning($"[Localization] Key '{entryKey}' in table '{tableName}' 读取失败: {e.Message}");
                return entryKey;
            }
        }

        /// <summary>带格式化参数的本地化字符串。</summary>
        public static string GetFormat(string entryKey, string tableName, params object[] args)
        {
            string template = Get(entryKey, tableName);
            try   { return string.Format(template, args); }
            catch (Exception e)
            {
                Debug.LogWarning($"[Localization] GetFormat '{entryKey}' 格式化失败: {e.Message}");
                return template;
            }
        }
#else
        /// <summary>Unity Localization 包未安装：直接返回 Key。</summary>
        public static string Get(string entryKey, string tableName = "UI")
            => entryKey;

        public static string GetFormat(string entryKey, string tableName, params object[] args)
        {
            try   { return string.Format(entryKey, args); }
            catch (Exception e)
            {
                Debug.LogWarning($"[Localization] GetFormat '{entryKey}' 格式化失败: {e.Message}");
                return entryKey;
            }
        }
#endif
    }
}