61 lines
1.9 KiB
C#
61 lines
1.9 KiB
C#
using Godot;
|
|
using Models;
|
|
|
|
namespace Core;
|
|
|
|
/// <summary>
|
|
/// i18n 服务抽象
|
|
/// 设计说明：
|
|
/// 1) Model 只持有 LocalizedText(Key/Fallback)，具体翻译交给服务层。
|
|
/// 2) 便于后续替换为自定义多语言系统或 Mod 词库。
|
|
/// 注意事项：
|
|
/// - TranslationServer 的翻译表应通过 Godot Editor 管理。
|
|
/// 未来扩展：
|
|
/// - 可加入“参数化翻译”和“运行时语言切换事件”。
|
|
/// </summary>
|
|
public interface ILocalizationService {
|
|
/// <summary>
|
|
/// 翻译本地化文本对象
|
|
/// </summary>
|
|
/// <param name="text">文本对象</param>
|
|
/// <returns>翻译后的字符串</returns>
|
|
string Translate(LocalizedText text);
|
|
|
|
/// <summary>
|
|
/// 翻译键值
|
|
/// </summary>
|
|
/// <param name="key">键值</param>
|
|
/// <param name="fallback">默认值</param>
|
|
/// <returns>翻译后的字符串</returns>
|
|
string Translate(string key, string fallback = null);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Godot 本地化服务实现
|
|
/// </summary>
|
|
public sealed class GodotLocalizationService : ILocalizationService {
|
|
/// <summary>
|
|
/// 翻译本地化文本对象
|
|
/// </summary>
|
|
/// <param name="text">文本对象</param>
|
|
/// <returns>翻译后的字符串</returns>
|
|
public string Translate(LocalizedText text) {
|
|
if (text == null) return string.Empty;
|
|
return Translate(text.Key, text.Fallback);
|
|
}
|
|
|
|
/// <summary>
|
|
/// 翻译键值
|
|
/// </summary>
|
|
/// <param name="key">键值</param>
|
|
/// <param name="fallback">默认值</param>
|
|
/// <returns>翻译后的字符串</returns>
|
|
public string Translate(string key, string fallback = null) {
|
|
if (string.IsNullOrWhiteSpace(key)) return fallback ?? string.Empty;
|
|
|
|
var translated = TranslationServer.Translate(key);
|
|
if (translated == key && !string.IsNullOrWhiteSpace(fallback)) return fallback;
|
|
|
|
return translated;
|
|
}
|
|
} |