凭据、身份与存储

将 SDK 的默认凭据、身份和持久化提供程序替换为适合你的部署环境的自定义实现。

Convai Unity SDK 随附面向生产环境的默认配置，涵盖凭据、最终用户身份和会话持久化。每个系统都由一个定义明确的接口支持；当默认设置不适合你的部署时，你可以自行实现并注册。

何时使用自定义提供程序

• CI / 密钥管理 — API 密钥不得存储在 ConvaiSettings.asset中；它来自环境变量或密钥保管库。
• 基于身份验证的身份 — 你的应用程序有自己的用户系统（OAuth、Steam、自定义 LMS），并且你希望 Convai 的长期记忆和 MAU（每月活跃用户）跟踪与你的用户 ID 关联。
• 云端保存或自定义存储 — 会话数据必须持久保存到云后端、加密存储或非PlayerPrefs 存储。

这三种提供程序都通过继承 ConvaiManager 并重写 CreateRuntimeBuilder()。这意味着你需要创建一个新的 C# 类来继承 ConvaiManager，将其作为组件添加到同一个 GameObject 上的 ConvaiManager 当前所在位置，并移除原始组件。例外：身份和元数据提供程序也可以通过 ConvaiManager上的直接 setter 进行设置，这不需要子类化，而且在你不需要更改任何其他设置时更简单。

下一步

自定义凭据提供程序自定义身份提供程序自定义持久化提供程序个人访问令牌

自定义凭据提供程序 从环境变量、密钥保管库或任何运行时来源提供 API 凭据，而不是使用 ConvaiSettings。

自定义身份提供程序 将 Convai 的最终用户身份绑定到你自己的认证系统，以实现稳定的按用户记忆和准确的每月活跃用户（MAU）跟踪。

自定义持久化提供程序 将 PlayerPrefs 会话存储替换为云后端、加密文件存储或任何键值实现。

个人访问令牌 根据你的 API 密钥生成短期令牌，这样真正的密钥就永远不会随你的 Unity 构建一起发布。