⤓发行包一览

发行包直接从服务器资源下载，SHA-256 校验码附于下方。

●Unity 引擎插件

把 Aludus 翻译能力直接挂到游戏运行时。支持 API Key / JWT 双形态鉴权，自动占位符冻结与还原，内置翻译缓存与降级逻辑。

• UPM 包结构：直接 Add package from tarball 即可，无需手动复制
• 最低支持 Unity 2022.3 LTS；Editor 集成 API Key 窗口
• Editor 菜单 Tools → Glot → Demo 一键生成 Demo 场景数据
• Runtime 走 /v1/translate/sync，按成功字数在服务端计费
• 纯 C# 实现，无外部 native 依赖

⚙Python SDK

从 Python 脚本里调 API —— 适合离线批处理、自动化管线、测试。pip 直接装。

①Unity 安装步骤

1. 下载 com.glot.game-trans-0.3.0.tgz 后，在 Unity 编辑器里打开 Window → Package Manager
2. 点击左上角 +，选择 Add package from tarball…，选中刚才下载的 tgz
3. 等待包解包；首次打开会弹出 API Key 配置窗口，填入控制台 API Key 即可
4. 菜单 Tools → Glot → Demo → Generate Demo Data 会在项目里写一份 角色 / 术语 / 对白 Demo 数据，可直接 Play 切换语言验证

②Python 使用示例

import glot
client = glot.Client(api_key="gt_live_your_key", project_id="proj_xxx")
units = [glot.Unit(unit_id="u1", source_text="开始游戏", text_type="ui")]
result = client.translate_sync(src_lang="zh-CN", tgt_lang="en-US", units=units)
for r in result.results:
    print(r.unit_id, r.target_text)

🔑API Key 鉴权

在控制台 控制台 → 账户 → API Key 页面创建一把 Key，前缀 gt_live_（线上）/ gt_test_（测试）；Key 只显示一次，丢了请吊销重建。

🎮快速体验

插件自带 Demo 场景，API Key 留空时走 Mock 降级链，可以在不碰真实后端的情况下把整条链路跑通。

1. 菜单 Tools → Glot → Demo → Generate Demo Data，幂等写 3 个角色 / 5 条术语 / 10 段对白
2. 打开 Demo/GlotDemoBootstrap 场景，直接 Play；MockTransport 会伪造译文回传
3. 空格键切换 locale，验证翻译缓存命中与回退

?常见问题