> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Xbox services 安全令牌 (XSTS) 声明中引用 Xbox 游戏串流服务器

> 在 XBOX 服务安全令牌 (XSTS) 声明中引用 XBOX 游戏串流服务器

在某些情况下，您的游戏可能需要专门引用并识别哪些用户来自 XBOX 游戏串流服务器。

要做到这一点，应在 Partner Center 执行以下步骤：

1. 在 Partner Center 内，导航到相应的信赖方并选择 [XBOX 服务安全令牌声明 (microsoft.com)（NDA 主题）](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-token-claims.md)中找到的适当声明。要了解使用哪个声明以及期望的值，请在链接的声明文档中查找术语 “XBOX Game Streaming server”。
2. 更新声明架构以包含引用 XBOX 游戏串流的适当变量。
3. 返回到主 “Relying Parties” 菜单并单击 “Publish”。

> [!NOTE]
>
> 对现有信赖方的调整将需要重新启动设备和游戏（以清除主机缓存）才能获取新生成的 XSTS 令牌（或等待约 4 小时使前一个令牌过期）。

## 从设备功能 (`dca`) 声明中检测 XBOX 游戏串流服务器

在您配置信赖方以包含设备功能声明后，您的服务可以检查已解密 XSTS 令牌中 `xdi`（设备身份）部分内的 `dca` 值，以确定该令牌是否是在 XBOX 游戏串流服务器上生成的。

`dca` 声明是一个整数数组。按以下方式解读：

| `dca` 值 | 含义 |
| - | - |
| `2`、`1 2` 或 `2 1` | 设备是 XBOX 游戏串流服务器（无论是否带有 ODD）。将其视为云实例。 |
| `1` 或无值 | 设备是 XBOX 主机硬件（无论是否带有 ODD）。将其视为非串流设备。 |
| 令牌中省略该声明 | 信赖方未配置为发出 `dca`，或令牌来自不发出设备身份声明的客户端（例如非 XBOX 平台）。仅在您确认信赖方为 XBOX 令牌发出 `dca` 后，才将声明缺失视为非串流设备。 |

由于声明缺失与信赖方配置错误无法区分，请在将声明缺失作为信号依据之前，先确认您的信赖方发布了 `dca` 声明（上述步骤 1）。有关完整的 `dca` 值表以及其他声明，请参阅 [XBOX 服务安全令牌声明](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-token-claims.md)。有关显示 `xdi.dca` 字段的示例解码令牌，请参阅 [XSTS 令牌、解密与验证示例](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-sample-xsts-token.md)。

> [!NOTE]
>
> 在客户端，游戏本身可以调用 [`XGameStreamingIsStreaming`](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-am-i-streaming) 来检测活动的串流连接。`dca` 声明是您的游戏服务在服务端等效的信号。

## XBOX 游戏串流服务器上的设备成对 ID (`dpi`)

设备成对 ID (`dpi`) 声明用于标识生成令牌的物理硬件。在 XBOX 游戏串流服务器上，该硬件是位于 Azure 数据中心的共享服务器，因此相同的 `dpi` 值可能会随时间推移出现在多个不同用户身上。

如果您的服务使用 `dpi` 强制执行按设备封禁或按设备速率限制，请先根据 `dca` 值决定是否执行。当 `dca` 表示为串流服务器时，请将该令牌的 `dpi` 从设备级封禁和速率限制中排除，以免连累那些之后从同一服务器进行串流的无关用户。


## Related topics

- [XBOX 游戏串流开发最佳实践](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-optimizing-your-game.md)
- [XBOX services 安全令牌声明](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-token-claims.md)
- [安全令牌](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/index.md)
- [XBOX Live 安全令牌](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-security-token-nav.md)
- [供 GDK 游戏使用的 Xbox 服务安全令牌（XSTS 令牌）](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-security-tokens.md)