跳到主要内容

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 应用」。

绑定步骤:

  1. 在 UOS 设置页中找到目标应用,点击 绑定工作区(或应用卡片上的 绑定当前工程)。
  2. 在弹出的列表中选择要绑定的工作区。
  3. 绑定成功后,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 将无法继续访问该应用,需要重新绑定后才能恢复使用。