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

# 來賓使用者概觀

> 在 XBOX 遊戲中支援受贊助來賓帳戶，讓玩家不必建立完整的 XBOX 帳戶即可加入本機或線上多人遊戲工作階段。

來賓使用者 (也稱為\_\_\_受贊助來賓\_\_\_或\_\_\_來賓帳戶\_\_\_) 可讓玩家與許多 XBOX services 互動，而不需要建立完整的 XBOX 帳戶。當遊戲允許來賓帳戶參與時，就是使用受贊助來賓來達成此目的。

<Note>另外還有一種來賓帳戶，稱為\_\_\_純來賓\_\_\_。這是在沒有已登入帳戶時存在的帳戶類型。它無法進行已驗證的 XBOX 服務呼叫，也無法遊玩任何需要 XBOX 使用者登入的遊戲。</Note>

來賓使用者是由已登入裝置的另一位 XBOX 使用者所贊助的單一工作階段帳戶。它可讓玩家與許多 XBOX services 互動，而不需要建立完整的 XBOX 帳戶，並會持續到符合下列其中一個條件為止：

* 來賓帳戶登出
* 贊助使用者登出
* 裝置關機

從終端使用者的角度來看，來賓帳戶透過降低進入門檻，讓玩家更容易從與贊助者相同的主機加入本機或線上多人遊戲。在單一遊戲工作階段中，該來賓可享有與贊助帳戶相同的許多好處，包括語音通訊。

## 在您的遊戲中支援來賓帳戶

在您的遊戲中支援來賓使用者並非必要，但這是很好的方式，可讓沒有 XBOX 帳戶的玩家在受贊助的裝置上體驗您的內容，而不需要大幅變更使用者處理方式。與完整的 XBOX 使用者類似，來賓使用者可以透過使用`XUserAddOptions::AllowGuests` 選項呼叫 [XUserAddAsync](/zh-TW/reference/system/xuser/functions/xuseraddasync) 來登入。登入時，來賓會被指派一個`XUserHandle`，可搭配所有以`XUserHandle` 作為參數的 API 使用。

<Note>XBOX 使用者與來賓使用者之間的一個主要差異，在於能否明確識別使用者。來賓登入時，無法控制選擇哪個帳戶來贊助它。如果一位來賓登出，然後又有一位來賓登入，您無法判斷是否為之前的同一位使用者。如果您考慮將玩家偏好設定或快取資料與特定使用者一起儲存，請記住這一點。</Note>

## 與 XBOX services 互動時的 XBOX 使用者與來賓使用者

接著可以對該使用者呼叫 [XblContextCreateHandle](/zh-TW/reference/live/xsapi-c/xbox_live_context_c/functions/xblcontextcreatehandle)，以便與 XBOX services 通訊。您可以使用使用者控制代碼呼叫 [XUserGetIsGuest](/zh-TW/reference/system/xuser/functions/xusergetisguest)，以檢查使用者是否為來賓。

XBOX 使用者與來賓使用者的差異取決於所使用的 API。對於完全支援來賓帳戶的服務 (例如查詢其他玩家的公開設定檔資訊)，這兩種使用者都會使用贊助帳戶的權限，行為完全相同。

不支援來賓使用者的 XBOX services 通常是儲存或管理與特定使用者相關聯之長期資料的服務 (例如統計資料、成就、社交關係等)。使用來賓使用者呼叫這些服務時，會傳回錯誤 (通常是 `HTTP_E_STATUS_BAD_REQUEST`)。

<Note>開發人員有責任避免將來賓帳戶用於不支援它們的 API。服務清單及其支援層級如下所示。</Note>

### XBOX 使用者帳戶訂閱狀態與家長監護

由於來賓帳戶會繼承贊助帳戶的功能，因此訂閱類型 (Gold 與 Silver) 所施加的任何限制，以及為該帳戶啟用的任何家長監護，也都會被繼承。例如，如果贊助帳戶有任何權限被 XBOX 社群原則與執行撤銷，來賓使用者的這些權限也會被移除。

## XBOX services 對來賓帳戶的支援

### XBOX services API 對來賓使用者的支援

* 雲端儲存空間
  * 不支援

* 一般
  * 即時活動 (RTA) 支援取決於所訂閱的服務

* 身分識別
  * 驗證
    * 繼承自贊助帳戶
  * 隱私權
    * 權限檢查 / 靜音 / 迴避清單
      * 繼承自贊助帳戶
  * 權限
    * 家長監護
      * 繼承自贊助帳戶
    * 隱私權設定
      * 繼承自贊助帳戶
    * 受贊助來賓帳戶被移除的權限
      * XPRIVILEGE\_BROADCAST
      * XPRIVILEGE\_MANAGE\_PROFILE\_PRIVACY\_SETTING
      * XPRIVILEGE\_GAME\_DVR
      * XPRIVILEGE\_SOCIAL\_NETWORK\_SHARING
      * XPRIVILEGE\_ADD\_FRIEND
  * 使用者設定檔 - 部分支援
    * 來賓可以檢視公開的 XBOX 設定檔資料

* 多人遊戲
  * 繼承自贊助帳戶

* 玩家資料
  * 成就 - 不支援
  * 統計資料 - 不支援

* 已驗證的自訂 Web 服務與服務對服務呼叫
  * 來賓帳戶可以對自訂 Web 服務進行已驗證的呼叫
  * 來賓帳戶可用於服務對服務呼叫

* 社交
  * 當地語系化字串 - 不支援
  * People-System - 不支援
  * 狀態 - 不支援
  * 信譽 - 不支援
  * Social Manager - 不支援

### PlayFab

* PlayFab Party 聊天
  * 來賓會繼承受贊助使用者的權限，如果受贊助帳戶具有多人遊戲和通訊權限，來賓便可參與

## 常見問題集

### 可以同時登入多個來賓帳戶嗎？

多個來賓帳戶可以有相同的贊助者，並可同時登入。

### 來賓帳戶可以存取裝置權利嗎？

裝置權利傳播到來賓帳戶的方式，與傳播到 XBOX 使用者的方式相同。

來賓帳戶對已安裝內容的存取權也與贊助帳戶相同

### 來賓帳戶如何與不支援來賓帳戶的平台 (例如 PC、行動裝置) 互動？

來賓帳戶會顯示為一般帳戶，具有與贊助帳戶相同的權限，且不需要額外的程式碼。

### 認證中如何測試來賓帳戶？

認證程序中不會特別測試來賓帳戶功能。此外，遊戲是否選擇支援來賓帳戶由開發人員決定。

## 另請參閱

[使用者身分識別與 XUser](/zh-TW/build/core-features/common/user/player-identity-xuser)

[XBOX services 使用者權限概觀](/zh-TW/services/xbox-services/fundamentals/identity/privileges/live-user-privileges-overview)

[XBOX services 使用者權限的用戶端使用方式](/zh-TW/services/xbox-services/fundamentals/identity/privileges/concepts/live-user-privileges-client)


## Related topics

- [在 Partner Center 設定你的組織](/zh-TW/home/onboarding-access/setup-organization.md)
- [服務 C API 概觀 - PFPushNotifications.h](/zh-TW/services/playfab/api-references/c/pfpushnotifications/pfpushnotifications_members.md)
- [服務 C API 概觀 - PFPlatformSpecific.h](/zh-TW/services/playfab/api-references/c/pfplatformspecific/pfplatformspecific_members.md)
- [最常失敗的測試案例](/zh-TW/publishing/certification/xr-top-failing.md)
- [XR-052 使用者狀態與遊戲存檔位置、漫遊及相依性](/zh-TW/publishing/certification/xr/xr-052.md)