> ## 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.

# XR-045 XBOX 網路與帳戶權限

> 遊戲必須向 XBOX 網路服務檢查權限，才能在 XBOX 網路服務或遊戲體驗中完成特定動作。

版本 2.0 - 03/01/2023

XBOX 網路為使用者及其子女提供應有程度的隱私權與線上安全。為了實現此承諾，遊戲必須向 XBOX 網路服務檢查權限，才能在 XBOX 網路服務或遊戲體驗中完成特定動作。

雖然權限檢查與遵守適用於所有帳戶，但請特別留意兒童帳戶的體驗與預期。對於兒童帳戶，特定活動可能因以年齡為基礎的預設值及/或兒童的家庭召集人 (父母或監護人) 的設定而受到封鎖。兒童無法自行變更設定，但對於某些活動，遊戲可以且應該叫用必要的系統 UI，讓年輕玩家透過核准流程，針對相關活動要求例外。例如，在這種情況下，年輕玩家可能在全域範圍內被封鎖多人遊戲，但家庭中的父母或監護人可以透過系統 UI 核准特定遊戲的多人遊戲；之後該兒童便能夠且應該能夠存取該特定遊戲的此遊戲模式。

| **活動** | **ID** | **權限名稱** | **附註** |
| - | - | - | - |
| 在多人遊戲工作階段中遊玩 | 254 | XPRIVILEGE\_MULTIPLAYER\_SESSIONS | 允許使用者在下列情境中，與真實世界的使用者 (而非機器人) 加入線上多人遊戲工作階段：同一工作階段中的同步玩家對玩家遊戲、非同步回合制遊戲、團隊遊戲、使用者起始的配對、傳送或接受邀請，以及中途加入工作階段。請注意，此權限與在同一部裝置上執行的本機多人遊戲無關。 |
| 在跨網路遊戲工作階段中遊玩 | 185 | AuthPrivileges.CrossNetworkPlay | 允許使用者在下列情境中，與其他未登入 XBOX 服務的真實世界玩家參與遊戲工作階段：同一工作階段中的同步玩家對玩家遊戲、非同步回合制遊戲、團隊遊戲、使用者起始的配對、傳送或接受邀請，以及中途加入工作階段。 |
| 與任何人通訊 | 252 | XPRIVILEGE\_COMMUNICATIONS | 允許使用者透過語音或文字與任何其他 XBOX Live 使用者通訊。 |
| 共用遊戲工作階段 | 189 | XPRIVILEGE\_SESSIONS | 允許使用者在共用環境中參與連線的單人體驗，或在遊戲為免費遊玩與付費多人遊戲混合型遊戲，並使用此權限在 XBOX 主機上管控這些體驗的情境中參與。單人體驗不得具有權限 252 或 254 (分別為通訊與多人遊戲) 所涵蓋的任何功能。使用此權限屬於需要平台核准的遊戲功能。 |
| 使用者產生的內容 (UGC) | 247 | XPRIVILEGE\_USER\_CREATED\_CONTENT | 允許使用者在線上查看其他使用者的 UGC、下載其他使用者的 UGC，或在線上分享自己的 UGC。這不會限制使用先前已下載的 UGC。 |
| 分享至社交網路 | 220 | XPRIVILEGE\_SOCIAL\_NETWORK\_SHARING | 僅限 XBOX 主機：允許使用者在 XBOX Live 以外分享資訊，包括遊戲進度、Kinect 產生的內容、遊戲短片等。 |

免費遊玩的遊戲、試玩版或 Beta 版可以設定為允許非 Game Pass 訂閱者的玩家進行多人遊戲 (ID 254)。這是透過服務端的設定完成，可藉由連絡您的 Microsoft 代表來啟動。這些遊戲必須繼續檢查多人遊戲權限，以確保遵守家長監護設定和玩家的選擇。

## 更多資訊

> \[!NOTE]
> 如需技術指導方針和最佳做法的詳細說明，請參閱 [XBOX 服務使用者權限的用戶端使用方式](/zh-TW/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client) 文件。

如果您的服務會處理 XBOX 網路發行的權杖，您應在服務上檢查權杖內這些使用者的「prv」宣告，以強制確認工作階段中的使用者具有執行所要求動作的適當權限。

如果遊戲提供上表所列的一或多項活動，遊戲必須檢查與該特定活動相關聯的權限。如果使用者沒有該權限，則不得允許使用者使用相關聯的活動。權限的授予期間為工作階段/動作的持續時間，或 XBOX 網路權杖重新整理之前的時間，以較短者為準。

視開發平台 (GDK、XDK、XSAPI) 而定，遊戲應呼叫適當的 API，以確保 (1) 叫用系統 UI，告知使用者遭封鎖的權限，並在兒童帳戶的情況下提供向父母或監護人要求特定權限許可的功能；或 (2) 提供具指示性且可據以採取行動的錯誤訊息。

**在 PC 或 XBOX 主機上使用 GDK：** 若要使用 GDK 檢查使用者是否具有權限，遊戲應使用 XUserCheckPrivilege 和 XUserResolvePrivilegeWithUiAsync API。有關使用模式和內容處理的具體資訊，請參閱 GDK 文件中的 [XBOX 服務使用者權限概觀](/zh-TW/services/xbox-services/fundamentals/identity/privileges/live-user-privileges-overview) 主題。

**使用 XBOX One XDK：** 若要在 XBOX One 上檢查使用者是否具有權限，遊戲會使用 Store::Product::CheckPrivilegeAsync API。如果權限檢查是由使用者動作 (例如進入多人遊戲模式) 所觸發，則 attemptResolution 參數必須設定為 true (或完全不設定)。平台會檢查權限，如果使用者沒有該權限，則會嘗試判斷原因。

如果 API 傳回 false，表示使用者沒有該權限，且系統未能成功解決問題。在這種情況下，遊戲必須封鎖需要權限的活動，但可以假設系統已經適當地告知使用者，他們沒有執行該活動的適當許可，或其權限有問題。

如果權限檢查並非由使用者動作所觸發，而是 (例如) 作為無訊息背景呼叫的一部分或用於裝飾 UX，則應在 attemptResolution 設定為 false 的情況下呼叫 API。因此，系統不會向使用者顯示訊息，也不會介入修正任何權限問題。

**直接搭配 UWP、Win32、行動裝置或其他平台使用 XSAPI：** 如果「prv」宣告中沒有該權限，表示使用者沒有該權限，遊戲應阻止使用者繼續進行需要權限的活動。如果檢查是因使用者要求存取需要權限的活動 (例如嘗試開始或加入多人遊戲工作階段) 而觸發，遊戲應顯示資訊性訊息，讓使用者知道他們無法參與。*建議* 的訊息如下：

## 實作需求

| **活動** | **ID** | **權限名稱** | **如何處理？** |
| - | - | - | - |
| 在多人遊戲工作階段中遊玩 | 254 | XPRIVILEGE\_MULTIPLAYER\_SESSIONS | \* **GDK**：遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 XUserCheckPrivilege 和 XUserResolvePrivilegeWithUiAsync API)。<br /> \* **XDK**：遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 Store::Product::CheckPrivilegeAsync API)。<br /> \* **XSAPI**：建議的訊息為「很抱歉，您目前無法玩線上多人遊戲。」<br /> \* 如果您的帳戶由父母或監護人管理，他們可以在 \[設定] > \[帳戶] > \[家庭設定] > \[管理家庭成員] 中，為您的設定檔自訂 XBOX 隱私權設定。 |
| 在跨網路遊戲工作階段中遊玩 | 185 | AuthPrivileges.CrossNetworkPlay | \* **GDK**：遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 XUserCheckPrivilege 和 XUserResolvePrivilegeWithUiAsync API)。<br /> \* **XDK**：遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 Store::Product::CheckPrivilegeAsync API)。<br /> \* **XSAPI**：建議的訊息為「很抱歉，您目前無法與 XBOX 網路以外平台上的玩家一起遊玩。」<br /> \* 如果您的帳戶由父母或監護人管理，他們可以在 \[設定] > \[帳戶] > \[家庭設定] > \[管理家庭成員] 中，為您的設定檔自訂 XBOX 隱私權設定。 |
| 與任何人通訊 | 252 | XPRIVILEGE\_COMMUNICATIONS | \* **GDK**：遊戲必須使用 XUserCheckPrivilege API 檢查權限衝突，並顯示資訊性訊息，讓使用者知道他們無法與 XBOX 網路上的其他人通訊。<br /> \* **XDK**：遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 Store::Product::CheckPrivilegeAsync API)。<br /> \* **XSAPI**：建議的訊息為「很抱歉，您目前無法與 XBOX 網路上的其他人交談。」<br /> \* 如果您的帳戶由父母或監護人管理，他們可以在 \[設定] > \[帳戶] > \[家庭設定] > \[管理家庭成員] 中，為您的設定檔自訂 XBOX 隱私權設定。 |
| 共用遊戲工作階段 | 189 | XPRIVILEGE\_SESSIONS | \* **GDK**：遊戲必須使用 XUserCheckPrivilege API 檢查權限衝突，並顯示資訊性訊息，讓使用者知道他們無法玩線上多人遊戲。<br /> \* **XDK**：遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 Store::Product::CheckPrivilegeAsync API)。<br /> \* **XSAPI**：建議的訊息為「很抱歉，您目前無法玩線上多人遊戲。」<br /> \* 如果您的帳戶由父母或監護人管理，他們可以在 \[設定] > \[帳戶] > \[家庭設定] > \[管理家庭成員] 中，為您的設定檔自訂 XBOX 隱私權設定。 |
| 使用者產生的內容 (UGC) | 247 | XPRIVILEGE\_USER\_CREATED\_CONTENT | \* **GDK**：遊戲必須使用 XUserCheckPrivilege API 檢查權限衝突，並顯示資訊性訊息，讓使用者知道他們無法檢視其他使用者建立的內容。<br /> \* **XDK**：遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 Store::Product::CheckPrivilegeAsync API)。<br /> \* **XSAPI**：建議的訊息為「很抱歉，您目前無法查看其他人製作的內容。」<br /> \* 如果您的帳戶由父母或監護人管理，他們可以在 \[設定] > \[帳戶] > \[家庭設定] > \[管理家庭成員] 中，為您的設定檔自訂 XBOX 隱私權設定。 |
| 分享至社交網路 | 220 | XPRIVILEGE\_SOCIAL\_NETWORK\_SHARING | \* **GDK**：遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 XUserCheckPrivilege 和 XUserResolvePrivilegeWithUiAsync API)。<br /> \* **XDK**：遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 Store::Product::CheckPrivilegeAsync API)。<br /> \* **XSAPI**：建議的訊息為「很抱歉，您目前無法在社交網路上分享。」<br /> \* 如果您的帳戶由父母或監護人管理，他們可以在 \[設定] > \[帳戶] > \[家庭設定] > \[管理家庭成員] 中，為您的設定檔自訂 XBOX 隱私權設定。 |

**XBOX 網路連線問題：** 如果遊戲因無法連線至 XBOX 服務而收到失敗 (不論是透過 API，或是因為無法擷取 XBOX Live 權杖)，遊戲應封鎖對所要求動作的存取。在這種情況下，遊戲應依照 XR-074「與 XBOX 及合作夥伴服務的連線中斷」中所述，妥善處理失敗。

## 最佳做法

## 其他資源

如需權限和使用者權杖的詳細資訊，請參閱 Microsoft Game Development Kit (GDK) 或 XBOX Application Development Kit 文件中的「使用者權杖」。

就此 XR 而言，社交網路是指 XBOX 網路以外，預設允許個人與其他使用者分享內容的網站或服務。如果外部網站的預設選項為啟用與好友或所有人分享，則就此 XR 而言，外部網站不需要允許使用者在上傳時選擇限制分享。

## 豁免

無論使用者的影片內容權限設定為何，付費交易型影片服務都可以提供給所有 XBOX 使用者。如果應用程式同時提供付費內容和付費交易型影片服務，則付費內容必須遵守此需求。

如果應用程式是在 XBOX 平台上提供該應用程式之國家/地區內的公共廣播機構，則無論使用者的影片內容權限設定為何，所有非商業化的內容服務都必須提供給該國家/地區的所有 XBOX 使用者。

在 XBOX One 主機與非主機裝置之間提供非同步多人遊戲的遊戲，不需要針對非主機裝置上的體驗檢查多人遊戲權限。

## 認證測試案例

**045-01 遵守使用者權限**

> **測試步驟**
>
> 1. 登入 XBOX 設定檔並啟動遊戲。
>
> 2. 針對 XR 備註中所列的每項權限，確認遊戲是否支援相關聯的活動。
>
> 3. 針對步驟 \[2] 中找出的每項適用權限的每種可能設定，執行下列動作：
>
> * 結束遊戲，並變更使用者的該權限設定。
> * 重新啟動主機。
> * 登入相同的設定檔並啟動遊戲。
> * 瀏覽遊戲的所有相關區域，使用與該權限相關的所有遊戲功能，並確認遊戲遵守使用者目前的權限設定。
> * 嘗試使用 Silver XBOX 設定檔存取所有離線和線上區域。
>
> **預期結果**<br />遊戲必須遵守使用者的權限設定。
>
> **通過範例**
>
> 1. 遊戲遵守使用者的權限設定。
> 2. 遊戲將部分允許的權限設定視為停用/不允許該權限 (例如，當使用者產生的內容 (UGC) 權限設定為僅限好友時，遊戲的行為如同該權限設定為封鎖)。
> 3. 對於使用 XDK 的遊戲，遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 Store::Product::CheckPrivilegeAsync API)。當無法叫用系統 UI 時 (權限 252、189、247)，遊戲會顯示資訊性訊息，讓使用者知道他們無法參與。
> 4. 對於使用 GDK 的遊戲，遊戲叫用系統 UI，提醒使用者任何權限衝突。在遊戲無法叫用系統 UI 的情況下 (252、189、247)，遊戲會顯示資訊性訊息，讓使用者知道他們無法參與。遊戲必須使用 XUserCheckPrivilege 和 XUserResolvePrivilegeWithUiAsync API。
> 5. 對於使用 XSAPI 的遊戲，遊戲會顯示資訊性訊息，讓使用者知道他們無法參與。
>
> **失敗範例**
>
> 1. 遊戲保留使用者的權限設定，且在權限變更之後未反映使用者的實際權限。
> 2. 遊戲將部分允許的權限設定視為該權限設定為限制最少的設定 (例如，當使用者產生的內容 (UGC) 權限設定為僅限好友時，遊戲的行為如同該權限設定為允許)。
> 3. 對於使用 XDK 或 GDK 的遊戲，遊戲使用遊戲內訊息提醒使用者任何權限衝突，而未顯示系統 UI。
> 4. 對於使用 XSAPI 的遊戲，遊戲未顯示資訊性訊息讓使用者知道他們無法參與。

<br />

**045-02 遵守使用者權限 - XBOX Family**

> **測試設定與組態**<br />[XBOX Family](https://www.xbox.com/en-US/family-hub)  其中包含下列 Microsoft 帳戶：
>
> * 指定為召集人的成人 (年滿 18 歲)。
> * 具有 *兒童預設* 權限設定的兒童 (未滿 13 歲)：
>
> | **活動** | **兒童預設權限設定** |
> | - | - |
> | 您可以加入多人遊戲 | 封鎖 |
> | 您可以加入跨網路遊玩 | 封鎖 |
> | 您可以透過語音、文字或邀請進行通訊 | 好友 |
> | 您可以在 XBOX 網路以外透過語音和文字進行通訊 | 封鎖 |
> | 您可以查看及上傳社群創作 | 封鎖 |
> | 您可以在 XBOX 以外分享 | 封鎖 |
>
> **參考資料與連結**：
>
> * [建立 XBOX Family](https://account.microsoft.com/family/home)
> * [透過網頁、Family 應用程式或 XBOX 主機新增家庭成員](https://support.microsoft.com/en-us/account-billing/add-people-to-your-family-group-4a07b974-8103-16ad-6ea2-46549ca19e03)
> * [管理家長同意](https://support.xbox.com/en-US/help/family-online-safety/online-safety/manage-online-safety-and-privacy-settings-xbox-one)
>
> **測試步驟**
>
> 1. 登入成人和兒童的 Microsoft 帳戶，並使用兒童帳戶啟動遊戲。
> 2. 針對 XR 備註中所列的每項權限，確認遊戲是否支援相關聯的活動。
> 3. 針對步驟 \[2] 中找出的每項適用權限的每種可能設定，執行下列動作：
>
> <ul><li>根據帳戶權限，確認相關聯的活動是否允許。<i>例如</i>：遊戲支援多人遊戲，而兒童帳戶的多人遊戲權限遭到封鎖。確認遊戲會為該兒童封鎖所有多人遊戲活動，且當兒童嘗試參與多人遊戲活動時，會顯示家長許可提示 (系統 UI)。</li>
> <li>結束遊戲，並針對遊戲支援的權限活動變更使用者之兒童的權限設定，從封鎖改為允許。<i>例如</i>：將多人遊戲或使用者產生的內容從封鎖變更為允許。</li><li>重新啟動主機。</li><li>登入相同的設定檔並啟動遊戲。</li><li>瀏覽遊戲的所有相關區域，使用與該權限相關的所有遊戲功能，並確認遊戲遵守使用者目前的權限設定。<i>例如</i>：遊戲支援多人遊戲。兒童原本遭到封鎖，但現在已獲授予多人遊戲權限。遊戲正確地允許兒童存取多人遊戲模式。</li></ul>
>
> 4. 在家長帳戶<b>未</b>登入主機的情況下，重複步驟 \[2]-\[3]。
>
> **預期結果**<br />遊戲必須遵守所有 XBOX Family 成員的權限設定。
>
> **通過範例**
>
> 1. 遊戲遵守兒童的權限設定。
> 2. 當某項活動的權限為允許時，遊戲允許兒童參與該活動。
> 3. 當某項活動的權限為封鎖時，遊戲不允許兒童參與該活動。
> 4. 當某項活動遭到封鎖，但家長 (透過家長許可 UI) 允許該活動的許可時，遊戲允許兒童參與該活動。
> 5. 當某項活動遭到封鎖，且家長 (透過家長許可 UI) 未允許該活動的許可時，遊戲不允許兒童參與該活動。
> 6. 遊戲將部分允許的權限設定視為停用/不允許該權限 (例如，當使用者產生的內容 (UGC) 權限設定為僅限好友時，遊戲的行為如同該權限設定為封鎖)。
> 7. 對於使用 XDK 的遊戲，遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 Store::Product::CheckPrivilegeAsync API)。當無法叫用系統 UI 時 (權限 252、189、247)，遊戲會顯示資訊性訊息，讓使用者知道他們無法參與。
> 8. 對於使用 GDK 的遊戲，遊戲叫用系統 UI，提醒使用者任何權限衝突 (遊戲必須使用 XUserCheckPrivilege 和 XUserResolvePrivilegeWithUiAsync API)。當無法叫用系統 UI 時 (權限 252、189、247)，遊戲會顯示資訊性訊息，讓使用者知道他們無法參與。
> 9. 對於使用 XSAPI 的遊戲，遊戲會顯示資訊性訊息，讓使用者知道他們無法參與。
>
> **失敗範例**
>
> 1. 遊戲未遵守兒童的權限設定。
>
> * 範例：遊戲支援多人遊戲，並允許多人遊戲遭封鎖的兒童存取多人遊戲模式。
>
> 2. 遊戲未叫用適當的 UI 來提醒及告知兒童權限衝突。
>
> * 範例：遊戲支援多人遊戲，但在權限遭封鎖時，從未提示兒童取得家長許可。
>
> 3. 當某項活動的權限為封鎖時，遊戲允許兒童參與該活動。
>
> 4. 當某項活動的權限為允許時，遊戲不允許兒童參與該活動。
>
> 5. 當某項活動遭到封鎖，且家長 (透過家長許可 UI) 未允許該活動的許可時，遊戲允許兒童參與該活動。
>
> 6. 當某項活動遭到封鎖，且家長 (透過家長許可 UI) 已允許該活動的許可時，遊戲不允許兒童參與該活動。
>
> 7. 遊戲保留使用者的權限設定，且在權限變更之後未反映使用者的實際權限。
>
> * 範例：遊戲支援多人遊戲。兒童帳戶的多人遊戲遭到封鎖，但家長透過系統 UI 授予了許可。即使權限已獲授予，遊戲仍持續封鎖多人遊戲。
>
> 8. 遊戲將部分允許的權限設定視為該權限設定為限制最少的設定。*例如*：當使用者產生的內容 (UGC) 權限設定為僅限好友時，遊戲的行為如同該權限設定為允許。
> 9. 對於使用 XDK 的遊戲，遊戲未叫用系統 UI 來提醒使用者任何權限衝突 (遊戲必須使用 Store::Product::CheckPrivilegeAsync API)。當無法叫用系統 UI 時 (權限 252、189、247)，遊戲未顯示資訊性訊息讓使用者知道他們無法參與。
> 10. 對於使用 GDK 的遊戲，遊戲未叫用系統 UI 來提醒使用者任何權限衝突 (遊戲必須使用 XUserCheckPrivilege 和 XUserResolvePrivilegeWithUiAsync API)。當無法叫用系統 UI 時 (權限 252、189、247)，遊戲未顯示資訊性訊息讓使用者知道他們無法參與。
> 11. 對於使用 XSAPI 的遊戲，遊戲未顯示資訊性訊息讓使用者知道他們無法參與。

<br />

## 變更歷程記錄

| 日期 | 文件版本 | 變更描述 |
| - | - | - |
| 2023 年 3 月 1 日 | 2.0 | 已更新以納入 XBOX Family 成員帳戶權限的需求與驗證。<br /><br />新增測試案例 045-02 以驗證 XBOX Family 成員的權限設定。 |


## Related topics

- [XBOX 遊戲的 XBOX 需求](/zh-TW/publishing/certification/xbox-requirements.md)
- [XBOX 遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [XR-015 管理玩家通訊](/zh-TW/publishing/certification/xr/xr-015.md)
- [XBOX 需求與原則支援內容](/zh-TW/publishing/certification/xr/overview.md)
- [Beta 版與 XBOX Game Preview 遊戲產品的需求](/zh-TW/publishing/certification/cert-beta-game-preview.md)