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

# 在 XSTS 宣告中參考 XBOX Game Streaming 伺服器

> 在 Partner Center 中設定裝置功能 (dca) 宣告，並在伺服器端解譯該宣告，以從 XSTS 權杖偵測 XBOX Game Streaming 伺服器。

在某些情況下，您的遊戲可能需要明確參考並識別哪些使用者來自 XBOX Game Streaming 伺服器。

若要執行此操作，應在 Partner Center 中採取下列步驟：

1. 在 Partner Center 中，瀏覽至適用的信賴憑證者，並選取 [XBOX services 安全性權杖宣告 (microsoft.com) (NDA 主題)](/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-token-claims) 中的適當宣告。若要了解要使用哪個宣告以及預期的值為何，請在連結的宣告文件中尋找「XBOX Game Streaming server」一詞。
2. 更新宣告結構描述，以包含參考 XBOX Game Streaming 的適當變數。
3. 返回主要的「信賴憑證者」功能表，然後按一下「發佈」。

<Note>調整現有的信賴憑證者需要重新啟動裝置和遊戲 (以清除主機快取)，才能取得新產生的 XSTS 權杖 (或等待約 4 小時讓先前的權杖過期)。</Note>

## 從裝置功能 (`dca`) 宣告偵測 XBOX Game Streaming 伺服器

設定信賴憑證者以包含裝置功能宣告之後，您的服務可以檢查已解密之 XSTS 權杖的 `xdi` (裝置身分識別) 區段內的 `dca` 值，以判斷權杖是否在 XBOX Game Streaming 伺服器上產生。

`dca` 宣告是整數陣列。請依下列方式解譯：

| `dca` 值 | 意義 |
| - | - |
| `2`、`1 2` 或 `2 1` | 裝置是 XBOX Game Streaming 伺服器 (不論是否有 ODD)。請將其視為雲端執行個體。 |
| `1` 或無值 | 裝置是 XBOX 主機硬體 (不論是否有 ODD)。請將其視為非串流裝置。 |
| 權杖中省略了宣告 | 信賴憑證者未設定為發出 `dca`，或權杖來自不會發出裝置身分識別宣告的用戶端 (例如非 XBOX 平台)。只有在確認信賴憑證者會針對 XBOX 權杖發出 `dca` 之後，才將缺少宣告視為非串流裝置。 |

由於省略的宣告與設定錯誤的信賴憑證者無法區分，因此在依賴缺少宣告作為訊號之前，請先確認您的信賴憑證者會發佈 `dca` 宣告 (上述步驟 1)。如需完整的 `dca` 值表格和其他宣告，請參閱 [XBOX services 安全性權杖宣告](/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-token-claims)。如需顯示 `xdi.dca` 欄位的範例解碼權杖，請參閱[範例 XSTS 權杖、解密和驗證](/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/service-authentication/security-tokens/live-sample-xsts-token)。

<Note>在用戶端，遊戲本身可以呼叫 [`XGameStreamingIsStreaming`](/zh-TW/build/core-features/common/game-streaming/game-streaming-am-i-streaming) 來偵測作用中的串流連線。`dca` 宣告則是您遊戲服務的對等伺服器端訊號。</Note>

## XBOX Game Streaming 伺服器上的裝置成對識別碼 (`dpi`)

裝置成對識別碼 (`dpi`) 宣告會識別產生權杖的實體硬體。在 XBOX Game Streaming 伺服器上，該硬體是 Azure 資料中心內的共用伺服器，因此隨著時間經過，相同的 `dpi` 值可能會出現在多位不同的使用者身上。

如果您的服務使用 `dpi` 強制執行按裝置封鎖或按裝置速率限制，請先根據 `dca` 值控管該強制執行。當 `dca` 表示串流伺服器時，請將權杖的 `dpi` 排除在裝置層級封鎖和速率限制之外，以免處罰之後從同一部伺服器串流的無關使用者。


## Related topics

- [安裝 GDK 工具鏈](/zh-TW/home/setup-install/download-install.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [XR-074 與 XBOX 及合作夥伴服務的連線中斷](/zh-TW/publishing/certification/xr/xr-074.md)
- [PlayFab Multiplayer C++ SDK 版本資訊](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [在 XSTS 声明中引用 XBOX Game Streaming 服务器](/zh-CN/build/core-features/common/game-streaming/game-streaming-referencing-xcloud-servers-in-xsts-claims.md)