登录并管理你的账户

通过编辑器窗口连接你的 Convai 账户，退出以切换账户，并在 Unreal Editor 中查看计划、配额和使用详情。

Convai 编辑器窗口可帮助你将 Unreal 项目连接到 Convai。使用你的 Convai 账号登录，可自动存储项目 API 密钥，并在 账号 部分查看套餐详情和使用配额，并在需要使用其他账号时，从右上角账号菜单退出登录。

先决条件

• Convai Unreal Engine 插件已安装并启用。
• Convai 编辑器窗口可用。请参见 Convai 编辑器窗口 了解编辑器窗口版本要求。
• 一个 Convai 账户。
• Unreal Editor 可访问互联网。

完成欢迎流程

当项目尚未完成欢迎设置或没有有效的 API 密钥时，Unreal Editor 初始化后可能会出现欢迎流程。

1

打开 Convai 编辑器窗口

点击 Convai 编辑器 按钮，位于 Level Editor 工具栏中，或者从 窗口 > Convai > 打开 Convai 编辑器 菜单栏中选择。

如果 欢迎使用 Convai 界面已经打开，请继续下一步。

2

点击连接 Convai 账号

单击 连接 Convai 账号。插件会打开 Convai 登录流程。

3

完成身份验证

按照 Convai 登录流程操作。电子邮件和密码验证会在 Convai 身份验证窗口中进行。Google 或 GitHub 等 OAuth 提供商按钮会在你的外部浏览器中打开。

4

等待编辑器窗口打开

身份验证完成后，插件会验证并存储 API 密钥，关闭身份验证窗口，并打开 Convai 编辑器窗口。

当 Convai 编辑器窗口打开且 账号 部分显示你的套餐详情时，身份验证即完成。

退出登录并切换账号

当你需要退出登录并连接其他 Convai 账号时，请使用右上角的账号菜单。

1

打开账号菜单

在 Convai 编辑器窗口中，点击右上角的账号控件。它会显示你账号名称中的两个字母。

2

退出登录

选择 退出登录。插件会清除 API_Key, AuthToken以及此项目的缓存账号详情，并将空值写入 Config/DefaultEngine.ini.

3

使用其他账号登录

重复上面的欢迎流程，并使用你要使用的 Convai 账号登录。插件会自动存储新账号的 API 密钥。

查看你的账号详情

单击 账号 在导航栏中打开账号部分。

区域	显示内容
账号详情	当前套餐、套餐到期时间和配额续期日期
使用情况	交互使用量、Elevenlabs 使用量、核心 API 使用量和像素流送使用量

右上角的账号菜单会显示你账号名称中的两个字母、身份验证后的缓存用户名和电子邮件，以及一个 退出登录 选项。

故障排查

登录失败

症状： 身份验证流程没有返回 Unreal Editor，或者登录后 Convai 编辑器窗口没有打开。

原因： 登录未完成，未收到本地回调，或者 Unreal Editor 无法连接到 Convai。

修复： 重复登录流程。保持 Unreal Editor 打开，直到身份验证完成，并确认你的网络允许外发 HTTPS。

验证： Convai 编辑器窗口打开且 账号 部分显示你的套餐详情时，身份验证即完成。

账号部分未显示任何使用数据

症状： 账号部分显示为空或占位的使用值。

原因： 窗口尚未加载使用数据、身份验证无效，或者编辑器无法连接到 Convai。

修复： 关闭并重新打开 Convai 编辑器窗口。如果数据仍未加载，请从账号菜单退出登录，再次登录，并等待 账号 部分刷新。

验证： 账号部分显示套餐详情和使用条。

下一步

导出诊断日志