身份验证

比较 Convai Unity SDK 的 API Key 和 Auth Token 身份验证模式，了解各自适用场景，并查看玩家构建中包含什么。

从 Unity 项目到 Convai 的每个连接都需要一个凭据，以证明该项目被允许与 Convai 通信。Convai 的 Unity SDK 支持两种提供该凭据的方式：已保存的账户 API 密钥，或由您控制的服务器签发的短期令牌。本节将解释这两种模式，并展示如何为每种模式进行配置、扩展和排错。

两种身份验证模式

ConvaiAuthMode (ApiKey = 0, AuthToken = 1) 控制如何为一个 ConvaiManager 为每个房间连接解析凭据。

模式	凭据如何获取	凭据存放位置
API 密钥	SDK 读取保存在 Convai Project Settings 中的账户 API 密钥。	存储在磁盘上的 ConvaiSettings 资源中，经过混淆但未加密。
Auth Token	SDK 从已注册的 IConvaiAuthTokenProvider，或者从您配置的 HTTPS 端点获取。	仅在一次连接尝试期间保存在内存中；SDK 从不将其写入磁盘。

何时适合使用每种模式

使用 API 密钥 用于本地开发的模式：在 Unity 编辑器中迭代场景、运行示例场景，或在仅由您控制的机器上测试。它不需要您自己的服务器。

使用 Auth Token 适用于您发布的任何内容的模式：分发给测试人员、玩家或最终用户的构建。Auth Token 模式下的玩家构建绝不会包含账户 API 密钥——构建处理器会在构建期间将其剥离，并在之后恢复。API Key 模式下的玩家构建会位于随构建发布的 ConvaiSettings 资源。

混淆并不等于加密。任何拥有 SDK 源代码的人都可以还原存储的 API 密钥。不要将 API Key 模式的构建发布给您并不完全信任的受众。

玩家构建中会随附什么

使用……构建生成	构建中包含 API 密钥	连接时解析凭据
API Key 模式	是的，经过混淆，位于 ConvaiSettings 资源	直接从资源中读取
Auth Token 模式	否——在构建前剥离，并在之后恢复	从您注册的提供程序或端点获取

选择一个页面

身份验证如何工作 凭据解析顺序以及每种模式发送的传输标头。

配置 Auth Token 模式 切换到认证令牌模式，并在项目设置中配置令牌端点。

编写自定义令牌提供器 实现 IConvaiAuthTokenProvider，从您自己的登录流程中获取令牌。

使用现有的身份验证令牌进行连接 当您的登录层已经持有令牌时，请使用 ConnectWithAuthTokenAsync。

身份验证脚本参考 身份验证的完整接口、注册表和设置说明。

发布安全构建 构建处理器会剥离什么，以及令牌端点所需的 WebGL CORS 要求。

排查认证问题 两种认证模式的控制台消息和错误代码。

下一步

如果您正在配置第一个项目，请从 API 密钥开始。

配置 API 密钥

当您准备发布构建时，请先了解凭据解析的工作方式，再配置 Auth Token 模式。

身份验证如何工作