UOS
介绍
UOS(Unity Online Services) 是 Unity 官方提供的游戏云服务平台,涵盖 CDN、远程配置(Remote Config)、匹配(Matchmaking)、推送(Push)、存储(Storage)、崩溃分析(Stacktrace)、账号服务(Passport)等多种在线服务。
Tuanjie AI 支持将 UOS 应用绑定到工作区。绑定后,Codely 会自动获取并保存该应用的凭据,之后你可以直接通过 UOS Skills 让 Codely 完成相关云服务的开发、测试与部署等操作,全程无需手动复制 App ID 和密钥。
进入 UOS 设置页
点击 ⚙️ 图标进入设置(也可以通过 '/' 找到设置),在左侧菜单的 WORKSPACE(工作区) 分组下选择 UOS。
UOS 应用归属于当前登录的 Unity 账号,使用前请先完成登录。
界面功能
UOS 设置页(Unity Online Services 应用管理)会列出账号下所有已启用 UOS 的应用。每个应用卡片会显示所属组织、应用名、App ID 以及已开通的服务标签。
| 功能 | 说明 |
|---|---|
| 应用列表 | 分为「最近使用」和「全部应用」两个区域,便于快速定位常用应用。 |
| 新建 | 在弹窗中选择组织与项目,创建并启用一个新的 UOS 应用。 |
| 组织筛选 | 按组织过滤应用列表。 |
| 服务筛选 | 只显示已开通指定服务的应用(如 CDN、Remote Config、Matchmaking、Push、Storage、Stacktrace 等)。 |
| 搜索 | 按关键字搜索应用。 |
| 复制 App ID | 一键复制应用的 App ID,便于在代码或控制台中核对。 |
| 隐藏 / 取消隐藏 | 将不常用的应用暂时从列表中隐藏,需要时可重新显示。 |
| Check | 打开 UOS 控制台,查看应用的详细配置。 |
绑定工作区
绑定的作用是告诉 Codely「当前工作区使用哪个 UOS 应用」。
绑定步骤:
- 在 UOS 设置页中找到目标应用,点击 绑定工作区(或应用卡片上的 绑定当前工程)。
- 在弹出的列表中选择要绑定的工作区。
- 绑定成功后,Codely 会自动获取该应用的凭据(App ID 与密钥),并保存到工作区下的
.codely-cli/uos.json文件中。
绑定规则:
- 一个应用可绑定多个工作区:同一个 UOS 应用可以同时供多个工作区使用,应用卡片上会显示已绑定的所有工作区。
- 一个工作区 同一时间只能绑定一个应用:为工作区绑定新的 UOS 应用后,旧应用的凭据会被替换。
- 从下一次对话开始生效:凭据会作为环境变量(如
UOS_APP_ID、UOS_APP_SERVICE_SECRET)注入到对话会话中,UOS Skills 的脚本可以直接读取。
此外,在配置 Skill 环境变量时,也可以选择将凭据保存到全局 ~/.codely-cli/uos.json(所有工作区可用)或当前工作区的 .codely-cli/uos.json。
使用 UOS Skills
在技能市场下载 uos、stacktrace(崩溃分析)、device(设备云)这类依赖 UOS 凭据的技能后,Codely 会自动弹出 UOS 应用与工作区的绑定界面,引导你完成配置,无需手动填写密钥:
- 工作区已绑定 UOS 应用:自动完成配置,直接开始使用。
- 已有 UOS 应用但未绑定:在弹窗中选择要使用的 UOS 应用和工作区,Codely 会自动完成绑定并写入凭据。
- 还没有 UOS 应用:根据弹窗引导前往 UOS 设置页,新建一个应用。
配置完成后,即可直接让 Codely 执行相关云服务的开发、测试与部署操作,无需退出对话或手动传递凭据。
解除绑定
在 UOS 设置页的应用卡片上可以查看该应用已绑定的工作区,点击工作区条目旁的 ✕ 并确 认,即可解除绑定。
注意:解绑工作区会清除该工作区已保存的 UOS 凭据,依赖它的 UOS Skills 将无法继续访问该应用,需要重新绑定后才能恢复使用。