# 访问令牌有效负载

> Understand the payload section of a Vivox Access Token.

有效负载是 base64url 编码的 JSON 对象，其中包含令牌声明的声明。您可以按任意顺序列出有效负载。

下表详细介绍可以在令牌中使用的声明。有关每个令牌所需参数的更多信息，请参阅[访问令牌示例](../access-token-examples/access-token-examples-toc)。

## 有效负载内的 Unity Authentication ID##unity-authentication-ids-within-payloads

如果您的应用程序使用 Unity Authentication 服务来验证玩家身份，那么您可以使用 Vivox 访问令牌中的 UAS ID 来确保正确的玩家身份。用于识别玩家的 SIP URI 必须采用正确的格式，以确保从完整的 SIP URI 解析出玩家 ID。为了将 Unity Moderation 服务与 VAT 结合使用，必须遵循此格式。

以下是预期的 SIP 格式的示例：

```text
sip:.issuer.unity_player_id.unity_environment_id.@domain.vivox.com
```

`f` 和 `sub` 字段需要采用这种格式才能用于 UAS。

> **Note:**
>
> 请确保仅包含示例中的参数。包含错误参数的声明会在进行 API 调用时返回“invalid signature”或“malformed payload”错误。

| 声明  | 示例值                                                                                                                                 | 描述                                                                               |
| --- | ----------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| vxi | 1                                                                                                                                   | 保证令牌唯一性。
如果所有其他声明都相同，则这必须不同，否则令牌可能由于已使用而被拒绝。
我们建议使用无符号整数，对生成的每个令牌按 1 递增。 |
| sub | sip:[.blindmelon-AppName-dev.jerky.@tla.vivox.com](mailto:.blindmelon-AppName-dev.jerky.@tla.vivox.com)                             | 主体。
用于 mute 和 kick 操作的用户 SIP URI。
这是被静音/取消静音或踢出的用户。                      |
| f   | sip:[.blindmelon-AppName-dev.beef.@tla.vivox.com](mailto:.blindmelon-AppName-dev.beef.@tla.vivox.com)                               | From
在所有操作中使用的用户 SIP URI。
这是执行操作（如登录、加入频道或是使另一个用户静音）的用户。                 |
| iss | blindmelon-AppName-dev                                                                                                              | 特定于应用程序的颁发者。
在 Unity Cloud 后台上创建应用程序时会提供颁发者。                                 |
| vxa | kick                                                                                                                                | Vivox 操作。
要了解更多信息，请参阅 [Vivox 操作声明支持的值](./supported-values-vxa-claim.md)。     |
| t   | sip:[confctl-g-blindmelon-AppName-dev.testchannel@tla.vivox.com](mailto:confctl-g-blindmelon-AppName-dev.testchannel@tla.vivox.com) | To
这是在 join、mute、kick 和 transcription 操作中使用的频道 SIP URI。
这是在其中执行操作的频道。    |
| exp | 1600349400                                                                                                                          | 到期时间（以纪元秒表示）。
此值通常是当前时间加上 90 秒。                                              |