> ## 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.com/play 上的 Web 內容測試應用程式 (CTA)

> 說明如何在 xbox.com/play 上使用 Web 內容測試應用程式開發人員工具。

Web 內容測試應用程式 (CTA) 開發人員工具可在 [xbox.com/play](https://www.xbox.com/play) 上使用，這是目前的 XBOX 雲端遊戲 Web 體驗。這些工具的設計是搭配 Windows 上的 Edge 和 Chrome，以及 Mac、iOS 和 iPadOS 上的 Safari 使用。

本文涵蓋 xbox.com/play。全新體驗目前正在 [play.xbox.com](https://play.xbox.com/) 上預覽。若要使用其開發人員工具，請參閱 [Web 內容測試應用程式 (CTA) 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-web-content-test-application.md)。

* [選擇體驗](#choose-an-experience)
* [開啟開發人員工具](#open-developer-tools)
* [選取供應項目](#select-an-offering)
* [IP 連線](#ip-connect)
* [遠端連線](#remote-connect)
* [開發人員設定](#developer-settings)
* [TAK 側載](#tak-sideload)
* [在串流期間切換 TAK 配置](#switch-tak-layouts-during-a-stream)
* [滑鼠和鍵盤](#mouse-and-keyboard)
* [試用全新體驗](#try-the-new-experience)

## 選擇體驗

Web CTA 可在兩種 XBOX 雲端遊戲 Web 體驗上執行：xbox.com/play，以及處於預覽階段的 play.xbox.com。請使用下表為您的案例選擇其中一種：

| 案例 | xbox.com/play | play.xbox.com |
| :- | :- | :- |
| 以 IP 連線至 XBOX Development Kit | 僅支援搭配沙箱測試帳戶 | 支援 |
| 從同一部電腦進行 TAK 側載 | 支援 | 支援 |
| 從電腦將 TAK 側載至手機或平板電腦 | 透過 HTTPS 支援 | 尚不支援 |
| 在串流期間切換配置 | 支援 | 支援 |
| 遠端連線 | 支援 | 支援 |

這兩種體驗都支援私人供應項目、沙箱測試帳戶、地區選取，以及滑鼠和鍵盤。

## 開啟開發人員工具

若要開始使用開發人員工具，請前往 [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools)。如果您尚未登入，頁面會要求您登入，並包含一個沙箱欄位。

* 若為零售帳戶，請將沙箱保留空白，並使用在 XBOX Development Kit 上登入或已設定為可存取私人供應項目的相同帳戶登入。
* 若為沙箱測試帳戶，請在登入前輸入沙箱識別碼。

沙箱是您遊戲的隔離開發環境，每個沙箱測試帳戶都屬於一個沙箱。沙箱識別碼不是您的供應項目識別碼；請向建立您測試帳戶的人員取得。如需詳細資訊，請參閱 [XBOX 服務沙箱概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)。

> [!NOTE]
>
> 如果您登入沙箱測試帳戶時未提供其沙箱識別碼，某些功能可能無法運作，因為這些帳戶無法存取零售功能。

如果您登入時未提供沙箱識別碼，請造訪其他 Microsoft 網站 (例如 [outlook.com](https://www.outlook.com)) 登出。然後使用正確的沙箱識別碼重新登入。

您也可以從 xbox.com/play 目錄開啟開發人員設定。選取您的設定檔相片，然後選取 **\[設定]** > **\[開發人員]**。如果沒有顯示 **\[開發人員]**，請快速連續選取 **\[帳戶]** 10 次以顯示它。在開發人員設定中，**\[開發人員工具首頁]** 會返回開發人員工具頁面。

> [!NOTE]
>
> 在 iOS 或 iPadOS 上，您可以將此頁面儲存為漸進式 Web 應用程式 (PWA)。選取分享按鈕，然後選取 **\[加入主畫面]**。
>
> 此 PWA 會記住您的帳戶和設定，因此您稍後可以返回繼續測試。

## 選取供應項目

供應項目是用來驗證在資料中心硬體上執行之遊戲的私人測試環境。如需供應項目的詳細資訊，請參閱[遊戲串流概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-overview.md#what-are-private-offerings)。

若要使用特定供應項目：

1. 前往 [xbox.com/play/dev-tools/select-offering](https://www.xbox.com/play/dev-tools/select-offering)。
2. 從下拉式清單選取供應項目，或選取 **\[自訂供應項目識別碼]**，並在 **\[輸入雲端連線的供應項目識別碼]** 中輸入供應項目識別碼。
3. 選取 **\[連線]**。

您供應項目的目錄隨即開啟，頁面會顯示 **\[使用自訂供應項目]**，後面接著供應項目識別碼。如果您無法存取該供應項目，請確定您已使用獲授權可使用該特定供應項目的帳戶登入。

### 供應項目地區

供應項目不會自動將您路由至最近的資料中心。若要在其他地區進行測試，請開啟 **\[設定]** > **\[開發人員]**，並在 **\[串流地區]** 下選擇地區。請在開始串流之前選擇地區。**\[目前地區]** 會顯示您的選取項目。可用的地區必須事先設定。請連絡您的 Microsoft 帳戶代表，以調整您供應項目的可用地區。

## IP 連線

使用 IP 連線，即可透過 IP 位址直接從 XBOX Development Kit 串流。在 xbox.com/play 上，IP 連線需要沙箱測試帳戶，而且開發人員工具頁面不會提供其連結。

使用 IP 連線之前，請先完成下列必要條件：

1. 將您的 XBOX Development Kit 設定為可串流。如需詳細資訊，請參閱[設定 XBOX Development Kit](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-setup-xbox-developer-kit.md)。
2. 在 **\[Dev Home]** > **\[串流]** 中，確定 **\[直接連線]** 正在接聽。每次開發套件重新啟動時，它都會停止接聽。
3. 確定您的用戶端裝置與 XBOX Development Kit 位於相同的網路上，或透過 VPN 連線。
4. 確定您的網路允許傳送至 XBOX Development Kit 連接埠 9002 的 TCP 和 UDP 流量。瀏覽器會使用 WebSocket 連線進行訊號處理，並使用 UDP 進行串流。

若要透過 IP 位址連線：

1. 前往 [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools)。輸入沙箱識別碼，然後使用該沙箱的測試帳戶登入。
2. 前往 [xbox.com/play/dev-tools/ip-connect](https://www.xbox.com/play/dev-tools/ip-connect)。
3. 輸入 XBOX Development Kit 的 IP 位址和連接埠，例如 `192.168.1.10:9002`。
4. 選取 **\[連線]**。
5. 如果瀏覽器要求存取本機網路上裝置的權限，請選取 **\[允許]**。

連線成功後，在 XBOX Development Kit 上執行的應用程式會出現在瀏覽器中。如果您使用零售帳戶登入，IP 連線位址會將您導回開發人員工具頁面。

## 遠端連線

遠端連線會透過 XBOX 遠端遊玩服務，經由網際網路從您的 XBOX Development Kit 串流。它會透過您登入的帳戶尋找開發套件，因此您不需要輸入 IP 位址。

首先，設定 XBOX Development Kit：

1. 使用您將在 xbox.com/play 上使用的帳戶登入 XBOX Development Kit。該帳戶必須獲准在開發套件的沙箱中使用。
2. 前往 **\[Dev Home]** > **\[串流]**。在 **\[遠端連線]** 下，選取您的帳戶。
3. 在 **\[Dev Home]** > **\[串流]** 中，確定 **\[直接連線]** 未在接聽。直接連線是用於 IP 連線的另一種連線模式，它在接聽時會封鎖遠端連線。

然後從 xbox.com/play 連線：

1. 前往 [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools)，並使用相同的帳戶登入。若為沙箱測試帳戶，請在登入前輸入沙箱識別碼。
2. 選取 **\[遠端連線]**。當您登入的帳戶有已設定遠端連線的開發套件，或您使用沙箱測試帳戶登入時，即可使用此選項。
3. 在清單中找到您的 XBOX Development Kit，然後選取 **\[連線]**。

> [!NOTE]
>
> XBOX Development Kit 和您用來連線的裝置都需要網際網路連線。
>
> 與 IP 連線不同，遠端連線不需要兩部裝置位於相同的網路上。

## 開發人員設定

若要開啟開發人員設定，請選取您的設定檔相片，然後選取 **\[設定]** > **\[開發人員]**。

開發人員設定包括目前的供應項目和串流設定。[串流設定概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-content-test-application-stream-config.md)包含可覆寫之特定串流設定的詳細資訊。

在 **\[串流設定]** > **\[觸控調整]** 下，您可以設定：

* **\[啟用側載]**：從 [TAK CLI](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line.md) `serve` 命令載入觸控配置，而不是使用為您遊戲發佈的配置。
* **\[側載伺服器位址]**：側載伺服器的位址。
* **\[啟用自動重新整理]**：當您在側載伺服器上變更配置時，更新您裝置上的配置。
* **\[以滑鼠模擬觸控]**：將滑鼠點按視為觸控。

## TAK 側載

這些步驟涵蓋從自訂供應項目或 XBOX Development Kit 進行串流。若要使用供應項目，請參閱[選取供應項目](#select-an-offering)。

開始之前，請在提供您配置的電腦上執行 [`tak serve`](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command)。

若要從與瀏覽器相同的電腦進行側載：

1. 開啟 **\[設定]** > **\[開發人員]**，並找到 **\[觸控調整]**。
2. 開啟 **\[啟用側載]**。
3. 在 **\[側載伺服器位址]** 中，輸入您側載伺服器的位址，例如 `http://localhost:9269`。如[從另一部裝置側載](#sideload-from-another-device)中所述，`localhost` 以外的任何位址都必須使用 `https`。
4. 在 **\[網路狀態]** 下，檢查 **\[網路權限]**。如果顯示 **\[必要]**，請選取 **\[要求權限]**。當瀏覽器詢問是否允許網站 **\[存取此裝置上的其他應用程式和服務]** 時，請選取 **\[允許]**。
5. 在沒有觸控螢幕的電腦上，開啟 **\[以滑鼠模擬觸控]**。若未開啟，串流不會顯示任何觸控控制項，而且無法使用 **\[TAK]** 功能表。
6. 當 **\[伺服器連線]** 顯示 **\[已連線]** 時，開始串流。如果顯示 **\[無法連線]**，請確定 `tak serve` 正在執行，然後選取 **\[重新檢查]**。

在串流期間變更 **\[啟用側載]** 或 **\[以滑鼠模擬觸控]**，會提示您切換遊戲。

若要確認串流使用您的配置，請依照[在串流期間切換 TAK 配置](#switch-tak-layouts-during-a-stream)中的說明，在 **\[組合配置]** 下檢查是否有您的配置。

### 從另一部裝置側載

若要在手機或平板電腦上測試，請在該裝置可透過本機網路連線的電腦上執行 `tak serve`。伺服器必須使用 `https`：

1. 建立憑證。如需詳細資訊，請參閱[憑證產生指示](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md#certificate-generation-instructions)。
2. 在電腦上，使用 `--certificate-file` 和 `--certificate-password` 選項執行 `tak serve`。
3. 在手機或平板電腦上安裝憑證並信任該憑證。如需步驟，請參閱[在不同用戶端上信任憑證](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md#trusting-the-certificate-on-different-clients)。
4. 在手機或平板電腦上，開啟 **\[設定]** > **\[開發人員]**，開啟 **\[啟用側載]**，並在 **\[側載伺服器位址]** 中輸入 `https://<your PC's IP address>:9269`。
5. 依照 [TAK 側載](#tak-sideload)的步驟 4 和 6 中的說明，檢查 **\[網路權限]** 和 **\[伺服器連線]**。

若要要求密碼，請使用 `--password` 選項，並在裝置的開發人員設定中輸入相同的密碼。如需詳細資訊，請參閱 [Serve 命令](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md)。

## 在串流期間切換 TAK 配置

在開發人員模式下，您可以在串流時切換使用中的配置：

1. 在串流中，開啟左下角的 **\[開發人員工具功能表]**，然後選取 **\[TAK]**。
2. 在 **\[選取觸控控制項配置]** 下，選取 **\[組合配置]** 或 **\[系統配置]** 下的配置。**\[組合配置]** 會顯示為此串流載入的配置。側載正常運作時，這些就是您的配置。
3. 選取 **\[關閉]**。

**\[系統配置]** 為 **\[標準]** 和 **\[僅原生觸控 (空白)]**。**\[標準]** 會顯示標準控制器覆疊。**\[僅原生觸控 (空白)]** 會移除觸控控制項。

## 滑鼠和鍵盤

開始之前，請依照[開啟開發人員工具](#open-developer-tools)中的說明開啟開發人員工具。

1. 在 **\[設定]** > **\[開發人員]** 中的 **\[串流設定]** > **\[已啟用的輸入類型]** 下，開啟 **\[滑鼠和鍵盤]**。請在開始串流之前變更此設定。
2. 在 **\[觸控調整]** 下，關閉 **\[以滑鼠模擬觸控]**。兩者都開啟時，滑鼠點按會被視為觸控。
3. 開始串流。
4. 如果橫幅顯示 **\[進入全螢幕模式以使用滑鼠和鍵盤遊玩]**，請選取 **\[進入全螢幕]**。

若要釋放滑鼠，請按 **\[按 *按鍵* 以釋放滑鼠]** 通知中顯示的按鍵。

## 試用全新體驗

若要切換至 play.xbox.com 上的全新體驗，請選取您的設定檔相片，然後選取 **\[試用全新體驗]** > **\[立即試用]**。若要返回 xbox.com/play，請從您的設定檔開啟 **\[帳戶設定]**，然後選取 **\[結束預覽]**。


## Related topics

- [Web 內容測試應用程式 (CTA) 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-web-content-test-application.md)
- [內容測試應用程式 (CTA) 串流組態](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-content-test-application-stream-config.md)
- [其他獨立工具](https://docs.xbox.com/zh-TW/tools/additional-tools.md)
- [Android 內容測試應用程式 (CTA) 概觀 (已淘汰)](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-android-content-test-application.md)
- [Windows PC 內容測試應用程式 (CTA) 概觀 (已淘汰)](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-windows-pc-content-test-application.md)