访问令牌开发者指南

**注意:**Vivox 访问令牌是用于管理玩家频道访问权限的可选高级功能。当不需要频道访问控制时,建议使用 Unity Authentication 令牌来管理玩家。

玩家对 Vivox 资源的访问通过 Vivox 访问令牌 (VAT) 进行控制。Vivox 访问令牌包含定义特权操作的有效负载,由游戏服务器使用令牌签名密钥进行签名,随后在玩家要执行特权操作时由客户端提供给 Vivox 系统。Vivox 访问令牌类似于 JSON Web 令牌,但有一个空的访问令牌标头

访问令牌具有以下特征:

  • 令牌只能使用一次。将令牌用于特权操作后,将无法重复使用。
  • 令牌即使从未使用也会到期。在令牌颁发者设置的到期时间之后,您不能使用令牌。

游戏客户端需要访问令牌才能在 Vivox 系统中执行操作。

  • 游戏客户端生成的令牌:用于原型设计或测试目的。
  • 安全游戏服务器生成的令牌:用于生产游戏的安全部署,以及避免由于用户时间设置而产生的令牌错误。

当使用 Unity Authentication (UAS) 时,Vivox 访问令牌可以从令牌有效负载中解析 UASID。如果 Vivox 访问令牌用于 Safe Voice 或 Safe Text,必须在访问令牌中包含嵌入的 UAS ID。

请参阅标题为从客户端生成令牌在安全服务器上生成令牌的部分来生成令牌。

请注意:首先需要令牌颁发者和令牌签名密钥,然后客户端或服务器才能生成令牌。要了解更多信息,请参阅 Unity 支持知识库中的在哪里可以找到我的自定义应用程序凭据?

下图显示了游戏客户端、游戏服务器和 Vivox 系统之间的典型交互: