XUnity.AutoTranslator开源解决方案：Unity游戏实时翻译技术实现深度解析

XUnity.AutoTranslator开源解决方案Unity游戏实时翻译技术实现深度解析【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslatorXUnity.AutoTranslator是一个专为Unity游戏设计的智能翻译解决方案通过创新的架构设计和灵活的插件系统为全球玩家提供无缝的语言本地化体验。该项目采用模块化设计支持多种翻译引擎和游戏插件框架实现了游戏内文本的实时检测、翻译和替换功能。项目价值宣言消除语言障碍的技术创新XUnity.AutoTranslator的核心价值在于为Unity游戏开发者与玩家构建了一座跨越语言鸿沟的技术桥梁。在全球化游戏市场中语言障碍往往成为玩家体验的瓶颈而传统的本地化方案需要游戏开发商投入大量资源进行人工翻译和代码修改。XUnity.AutoTranslator通过运行时文本拦截与替换技术实现了无需修改游戏源代码的实时翻译能力。该解决方案支持从日语、中文、韩语等亚洲语言向英语、西班牙语、法语等全球主流语言的自动转换同时保留了游戏原有的UI布局和交互体验。项目采用MIT许可证开源允许开发者自由使用、修改和分发为独立游戏开发者和模组社区提供了强大的本地化工具支持。架构解析多层次的翻译处理系统XUnity.AutoTranslator采用分层架构设计各模块职责分明协同工作实现高效的文本翻译流程。核心架构图描述游戏运行时环境 │ ├── 插件加载层 (BepInEx/MelonMod/UnityInjector/IPA) │ │ │ └── 插件适配器 │ │ │ └── 核心翻译引擎 │ ├── 文本检测模块 │ ├── 翻译缓存系统 │ ├── 翻译调度器 │ └── 文本替换引擎 │ │ │ ├── UGUI/NGUI/TextMeshPro适配器 │ ├── 图像纹理替换模块 │ └── 资源重定向器 │ │ │ └── 翻译服务层 │ ├── Google Translate API │ ├── DeepL API │ ├── Bing Translator │ ├── 自定义翻译端点 │ └── 本地翻译缓存核心接口说明项目定义了清晰的核心接口确保系统的可扩展性和灵活性ITranslator接口- 翻译服务的核心抽象public interface ITranslator { void TranslateAsync(string untranslatedText, ActionTranslationResult onCompleted); bool TryTranslate(string untranslatedText, out string translatedText); void IgnoreTextComponent(object textComponent); void RegisterOnTranslatingCallback(ActionComponentTranslationContext context); }ITranslateEndpoint接口- 翻译端点的统一抽象public interface ITranslateEndpoint { string Id { get; } string FriendlyName { get; } int MaxTranslationsPerRequest { get; } void Initialize(IInitializationContext context); IEnumerator Translate(ITranslationContext context); }翻译处理流程文本检测通过Unity游戏引擎的Hook机制捕获UI文本变化预处理应用文本替换规则和格式标准化缓存查询检查本地翻译缓存是否存在匹配项远程翻译调用配置的翻译服务API后处理应用翻译结果格式化规则文本替换将翻译结果注入游戏UI组件翻译缓存系统设计项目实现了多层级的缓存机制以优化性能public class TextTranslationCache : IReadOnlyTextTranslationCache { private readonly Dictionarystring, string _translations new Dictionarystring, string(); private readonly Dictionarystring, RegexTranslation _regexTranslations new Dictionarystring, RegexTranslation(); private readonly Dictionarystring, string _substitutions new Dictionarystring, string(); public bool TryGetTranslation(string untranslatedText, out string translatedText) { // 1. 检查精确匹配 if (_translations.TryGetValue(untranslatedText, out translatedText)) return true; // 2. 检查正则表达式匹配 foreach (var regex in _regexTranslations.Values) { if (regex.TryTranslate(untranslatedText, out translatedText)) return true; } // 3. 应用文本替换规则 return ApplySubstitutions(untranslatedText, out translatedText); } }配置指南完整配置与优化策略基础配置文件示例项目使用INI格式的配置文件支持丰富的配置选项[Service] EndpointGoogleTranslate FallbackEndpointBingTranslate [General] Languageen FromLanguageja MaxCharactersPerTranslation200 [Files] DirectoryTranslation\{Lang}\Text OutputFileTranslation\{Lang}\Text\_AutoGeneratedTranslations.txt SubstitutionFileTranslation\{Lang}\Text\_Substitutions.txt [TextFrameworks] EnableUGUITrue EnableTextMeshProTrue EnableIMGUIFalse [Behaviour] EnableUIResizingTrue EnableBatchingTrue UseStaticTranslationsTrue OverrideFont ResizeUILineSpacingScale0.85 [Texture] TextureDirectoryTranslation\{Lang}\Texture EnableTextureTranslationFalse EnableTextureDumpingFalse TextureHashGenerationStrategyFromImageName [Google] ServiceUrlhttps://translate.googleapis.com翻译引擎配置对比表翻译引擎认证要求免费额度质量评级适用场景GoogleTranslate无需认证无限制★★★★☆通用翻译需求GoogleTranslateLegitimateAPI密钥首年$300额度★★★★★商业项目DeepLTranslate无需认证无限制★★★★★高质量翻译DeepLLegitimateAPI密钥50万字符/月免费★★★★★专业翻译BingTranslate无需认证无限制★★★★☆备用方案BaiduTranslateAppId/Secret5万字符/月免费★★★☆☆中文相关高级配置优化策略性能优化配置[Behaviour] MaxCharactersPerTranslation400 EnableBatchingTrue CacheRegexLookupsTrue CacheWhitespaceDifferencesFalse MaxTextParserRecursion2 CacheTexturesInMemoryTrue文本处理配置[Behaviour] IgnoreWhitespaceInDialogueTrue MinDialogueChars20 ForceSplitTextAfterCharacters0 HtmlEntityPreprocessingTrue HandleRichTextTrue PersistRichTextModeFinal资源重定向配置[ResourceRedirector] PreferredStoragePathTranslation\{Lang}\RedirectedResources EnableTextAssetRedirectorTrue LogAllLoadedResourcesFalse EnableDumpingFalse CacheMetadataForAllFilesTrue扩展开发二次开发与集成指南自定义翻译端点实现开发者可以轻松实现自定义翻译服务端点。以下是一个简单的HTTP翻译端点示例using XUnity.AutoTranslator.Plugin.Core; using XUnity.AutoTranslator.Plugin.Core.Endpoints.Http; namespace MyCustomTranslator { public class MyCustomTranslateEndpoint : HttpEndpoint { public override string Id MyCustomTranslator; public override string FriendlyName My Custom Translator; public override void Initialize(IInitializationContext context) { // 初始化配置 var apiKey context.GetOrCreateSettingstring(MyCustom, ApiKey); var baseUrl context.GetOrCreateSettingstring(MyCustom, BaseUrl); if (string.IsNullOrEmpty(apiKey)) throw new EndpointInitializationException(API Key is required); } public override IEnumerator Translate(ITranslationContext context) { // 构建请求URL var url $https://api.mycustomtranslator.com/translate; // 设置请求参数 var parameters new Dictionarystring, string { [source] context.SourceLanguage, [target] context.DestinationLanguage, [text] context.UntranslatedText, [api_key] _apiKey }; // 发送HTTP请求 using (var request CreateRequest(url, parameters)) using (var response request.GetResponse()) { var json ReadResponseText(response); var result ParseTranslationResponse(json); if (!string.IsNullOrEmpty(result)) { context.Complete(result); } else { context.Fail(Translation failed); } } yield break; } private string ParseTranslationResponse(string json) { // 解析JSON响应 var jsonObject SimpleJSON.JSON.Parse(json); return jsonObject[translation]?.Value; } } }插件集成APIXUnity.AutoTranslator提供了完整的API供其他插件集成// 查询翻译缓存 public class MyPlugin : MonoBehaviour { private void Start() { var untranslatedText こんにちは; // 异步翻译查询 AutoTranslator.Default.TranslateAsync(untranslatedText, result { if (result.Succeeded) { Debug.Log($翻译结果: {result.TranslatedText}); } }); // 同步缓存查询 if (AutoTranslator.Default.TryTranslate(ありがとう, out string translation)) { Debug.Log($缓存命中: {translation}); } } }资源重定向器开发对于需要自定义资源处理的场景可以扩展资源重定向器using XUnity.ResourceRedirector; public class MyResourceRedirector : IAssetLoadedContext { public void OnAssetLoaded(AssetLoadedContext context) { if (context.Asset is TextAsset textAsset) { // 修改文本资源 var modifiedText ProcessText(textAsset.text); context.Asset new TextAsset(modifiedText); context.Complete(); } } private string ProcessText(string original) { // 自定义文本处理逻辑 return original.Replace(旧文本, 新文本); } }最佳实践性能优化与使用技巧翻译缓存策略优化多层缓存架构内存缓存使用LRU算法缓存最近使用的翻译磁盘缓存将翻译结果持久化到_AutoGeneratedTranslations.txt静态词典内置常用短语词典减少API调用正则表达式缓存编译并缓存常用正则模式缓存配置文件示例[Behaviour] UseStaticTranslationsTrue CacheRegexLookupsTrue CacheWhitespaceDifferencesFalse GenerateStaticSubstitutionTranslationsTrue文本处理性能优化正则表达式优化技巧// 低效的正则表达式 Regex regex new Regex(^アイテム(\d)$); // 高效的正则表达式预编译、使用静态字段 private static readonly Regex ItemRegex new Regex( ^アイテム(\d)$, RegexOptions.Compiled | RegexOptions.CultureInvariant ); // 在翻译文件中使用 sr:^アイテム(\d)$Item $1批量翻译配置[Behaviour] EnableBatchingTrue MaxTranslationsPerRequest10 TranslationDelay0.5 MaxAvailableBatchOperations50内存管理最佳实践纹理翻译内存优化[Texture] CacheTexturesInMemoryFalse # 内存紧张时禁用 TextureHashGenerationStrategyFromImageName # 使用名称哈希而非数据哈希 EnableTextureScanOnSceneLoadFalse # 减少场景加载开销文本缓存清理策略// 定期清理长时间未使用的翻译缓存 public class TranslationCacheManager { private readonly TimeSpan _cacheExpiration TimeSpan.FromDays(7); public void CleanupOldTranslations() { var cutoffDate DateTime.Now - _cacheExpiration; foreach (var entry in _translationCache.ToList()) { if (entry.Value.LastAccessed cutoffDate) { _translationCache.Remove(entry.Key); } } } }社区生态相关资源与集成方案第三方翻译服务集成XUnity.AutoTranslator支持丰富的第三方翻译服务扩展SugoiOfflineTranslatorEndpoint- 离线翻译服务器集成LlmTranslators- OpenAI和Ollama模型支持AutoChatGptTranslator- ChatGPT翻译端点AutoLLMTranslator- 通用LLM翻译框架AutoPollinationTranslator- Pollinations.ai API集成游戏引擎兼容性矩阵游戏引擎版本BepInEx支持MelonLoader支持IL2CPP兼容性备注Unity 2017-2019✓✓部分支持推荐BepInEx 5.xUnity 2020✓✓✓推荐BepInEx 6.xUnity IL2CPP✓✓✓需要特定配置Unity Mono✓✓✓完全支持开发工具链集成Visual Studio项目结构XUnity.AutoTranslator.sln ├── XUnity.AutoTranslator.Plugin.Core (核心库) ├── XUnity.AutoTranslator.Plugin.BepInEx (BepInEx适配器) ├── XUnity.AutoTranslator.Plugin.MelonMod (MelonLoader适配器) ├── XUnity.AutoTranslator.Plugin.IPA (IPA适配器) ├── XUnity.AutoTranslator.Plugin.UnityInjector (UnityInjector适配器) ├── Translators/ (翻译端点实现) │ ├── GoogleTranslate/ │ ├── DeepLTranslate/ │ ├── BingTranslate/ │ └── CustomTranslate/ └── XUnity.ResourceRedirector (资源重定向库)构建与部署脚本# 安装脚本示例 param( [string]$GamePath, [string]$PluginType BepInEx ) $translatorFiles ( XUnity.AutoTranslator.Plugin.Core.dll, XUnity.AutoTranslator.Plugin.$PluginType.dll, XUnity.ResourceRedirector.dll, Translators/GoogleTranslate.dll ) foreach ($file in $translatorFiles) { Copy-Item $file -Destination $GamePath\BepInEx\plugins\ } Write-Host XUnity.AutoTranslator安装完成调试与监控方案日志配置示例[Debug] EnableConsoleTrue EnableLogTrue LogLevelDebug [Behaviour] EnableTextPathLoggingTrue OutputUntranslatableTextFalse LogAllLoadedResourcesFalse性能监控指标翻译缓存命中率API调用频率统计内存使用情况文本处理延迟纹理加载性能持续集成与自动化测试项目提供了完整的测试套件确保代码质量// 单元测试示例 [TestClass] public class TranslationCacheTests { [TestMethod] public void TestTranslationCacheHit() { var cache new TextTranslationCache(); cache.AddTranslation(こんにちは, Hello); Assert.IsTrue(cache.TryGetTranslation(こんにちは, out string result)); Assert.AreEqual(Hello, result); } [TestMethod] public void TestRegexTranslation() { var translation new RegexTranslation( ^アイテム(\d)$, Item $1, RegexOptions.Compiled ); Assert.IsTrue(translation.TryTranslate(アイテム123, out string result)); Assert.AreEqual(Item 123, result); } }XUnity.AutoTranslator作为一个成熟的Unity游戏翻译解决方案通过其模块化架构、丰富的配置选项和强大的扩展能力为游戏本地化提供了完整的技术栈。无论是独立开发者还是大型游戏团队都可以基于此项目构建符合自身需求的翻译系统真正实现游戏的无障碍全球化体验。【免费下载链接】XUnity.AutoTranslator项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考