访问令牌有效负载
有效负载是 base64url 编码的 JSON 对象,其中包含令牌声明的声明。您可以按任意顺序列出有效负载。
下表详细介绍可以在令牌中使用的声明。有关每个令牌所需参数的更多信息,请参阅访问令牌示例。
有效负载内的 Unity Authentication ID
如果您的应用程序使用 Unity Authentication 服务来验证玩家身份,那么您可以使用 Vivox 访问令牌中的 UAS ID 来确保正确的玩家身份。用于识别玩家的 SIP URI 必须采用正确的格式,以确保从完整的 SIP URI 解析出玩家 ID。为了将 Unity Moderation 服务与 VAT 结合使用,必须遵循此格式。
以下是预期的 SIP 格式的示例:
sip:.issuer.unity_player_id.unity_environment_id.@domain.vivox.com
注意:f
和 sub
字段需要采用这种格式才能用于 UAS。
**注意:**请确保仅包含示例中的参数。包含错误参数的声明会在进行 API 调用时返回“invalid signature”或“malformed payload”错误。
声明 | 示例值 | 描述 |
vxi | 1 | 保证令牌唯一性。 如果所有其他声明都相同,则这必须不同,否则令牌可能由于已使用而被拒绝。 注意:我们建议使用无符号整数,对生成的每个令牌按 1 递增。 |
sub | sip:.blindmelon-AppName-dev.jerky.@tla.vivox.com | 主体。 用于 mute 和 kick 操作的用户 SIP URI。 这是被静音/取消静音或踢出的用户。 |
f | sip:.blindmelon-AppName-dev.beef.@tla.vivox.com | From 在所有操作中使用的用户 SIP URI。 这是执行操作(如登录、加入频道或是使另一个用户静音)的用户。 |
iss | blindmelon-AppName-dev | 特定于应用程序的颁发者。 在 Unity Cloud 后台上创建应用程序时会提供颁发者。 |
vxa | kick | Vivox 操作。 要了解更多信息,请参阅 Vivox 操作声明支持的值。 |
t | sip:confctl-g-blindmelon-AppName-dev.testchannel@tla.vivox.com | To 这是在 join、mute、kick 和 transcription 操作中使用的频道 SIP URI。 这是在其中执行操作的频道。 |
exp | 1600349400 | 到期时间(以纪元秒表示)。 此值通常是当前时间加上 90 秒。 |