跳轉到主要內容
Web 內容測試應用程式 (CTA) 開發人員工具可在 xbox.com/play 上使用,這是目前的 XBOX 雲端遊戲 Web 體驗。這些工具的設計是搭配 Windows 上的 Edge 和 Chrome,以及 Mac、iOS 和 iPadOS 上的 Safari 使用。 本文涵蓋 xbox.com/play。全新體驗目前正在 play.xbox.com 上預覽。若要使用其開發人員工具,請參閱 Web 內容測試應用程式 (CTA) 概觀。

選擇體驗

Web CTA 可在兩種 XBOX 雲端遊戲 Web 體驗上執行:xbox.com/play,以及處於預覽階段的 play.xbox.com。請使用下表為您的案例選擇其中一種: 這兩種體驗都支援私人供應項目、沙箱測試帳戶、地區選取,以及滑鼠和鍵盤。

開啟開發人員工具

若要開始使用開發人員工具,請前往 xbox.com/play/dev-tools。如果您尚未登入,頁面會要求您登入,並包含一個沙箱欄位。
  • 若為零售帳戶,請將沙箱保留空白,並使用在 XBOX Development Kit 上登入或已設定為可存取私人供應項目的相同帳戶登入。
  • 若為沙箱測試帳戶,請在登入前輸入沙箱識別碼。
沙箱是您遊戲的隔離開發環境,每個沙箱測試帳戶都屬於一個沙箱。沙箱識別碼不是您的供應項目識別碼;請向建立您測試帳戶的人員取得。如需詳細資訊,請參閱 XBOX 服務沙箱概觀。
如果您登入沙箱測試帳戶時未提供其沙箱識別碼,某些功能可能無法運作,因為這些帳戶無法存取零售功能。
如果您登入時未提供沙箱識別碼,請造訪其他 Microsoft 網站 (例如 outlook.com) 登出。然後使用正確的沙箱識別碼重新登入。 您也可以從 xbox.com/play 目錄開啟開發人員設定。選取您的設定檔相片,然後選取 [設定] > [開發人員]。如果沒有顯示 [開發人員],請快速連續選取 [帳戶] 10 次以顯示它。在開發人員設定中,[開發人員工具首頁] 會返回開發人員工具頁面。
在 iOS 或 iPadOS 上,您可以將此頁面儲存為漸進式 Web 應用程式 (PWA)。選取分享按鈕,然後選取 [加入主畫面]。此 PWA 會記住您的帳戶和設定,因此您稍後可以返回繼續測試。

選取供應項目

供應項目是用來驗證在資料中心硬體上執行之遊戲的私人測試環境。如需供應項目的詳細資訊,請參閱遊戲串流概觀。 若要使用特定供應項目:
  1. 前往 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。
  2. 在 [Dev Home] > [串流] 中,確定 [直接連線] 正在接聽。每次開發套件重新啟動時,它都會停止接聽。
  3. 確定您的用戶端裝置與 XBOX Development Kit 位於相同的網路上,或透過 VPN 連線。
  4. 確定您的網路允許傳送至 XBOX Development Kit 連接埠 9002 的 TCP 和 UDP 流量。瀏覽器會使用 WebSocket 連線進行訊號處理,並使用 UDP 進行串流。
若要透過 IP 位址連線:
  1. 前往 xbox.com/play/dev-tools。輸入沙箱識別碼,然後使用該沙箱的測試帳戶登入。
  2. 前往 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,並使用相同的帳戶登入。若為沙箱測試帳戶,請在登入前輸入沙箱識別碼。
  2. 選取 [遠端連線]。當您登入的帳戶有已設定遠端連線的開發套件,或您使用沙箱測試帳戶登入時,即可使用此選項。
  3. 在清單中找到您的 XBOX Development Kit,然後選取 [連線]。
XBOX Development Kit 和您用來連線的裝置都需要網際網路連線。與 IP 連線不同,遠端連線不需要兩部裝置位於相同的網路上。

開發人員設定

若要開啟開發人員設定,請選取您的設定檔相片,然後選取 [設定] > [開發人員]。 開發人員設定包括目前的供應項目和串流設定。串流設定概觀包含可覆寫之特定串流設定的詳細資訊。 在 [串流設定] > [觸控調整] 下,您可以設定:
  • [啟用側載]:從 TAK CLI serve 命令載入觸控配置,而不是使用為您遊戲發佈的配置。
  • [側載伺服器位址]:側載伺服器的位址。
  • [啟用自動重新整理]:當您在側載伺服器上變更配置時,更新您裝置上的配置。
  • [以滑鼠模擬觸控]:將滑鼠點按視為觸控。

TAK 側載

這些步驟涵蓋從自訂供應項目或 XBOX Development Kit 進行串流。若要使用供應項目,請參閱選取供應項目。 開始之前,請在提供您配置的電腦上執行 tak serve。 若要從與瀏覽器相同的電腦進行側載:
  1. 開啟 [設定] > [開發人員],並找到 [觸控調整]。
  2. 開啟 [啟用側載]。
  3. 在 [側載伺服器位址] 中,輸入您側載伺服器的位址,例如 http://localhost:9269。如從另一部裝置側載中所述,localhost 以外的任何位址都必須使用 https。
  4. 在 [網路狀態] 下,檢查 [網路權限]。如果顯示 [必要],請選取 [要求權限]。當瀏覽器詢問是否允許網站 [存取此裝置上的其他應用程式和服務] 時,請選取 [允許]。
  5. 在沒有觸控螢幕的電腦上,開啟 [以滑鼠模擬觸控]。若未開啟,串流不會顯示任何觸控控制項,而且無法使用 [TAK] 功能表。
  6. 當 [伺服器連線] 顯示 [已連線] 時,開始串流。如果顯示 [無法連線],請確定 tak serve 正在執行,然後選取 [重新檢查]。
在串流期間變更 [啟用側載] 或 [以滑鼠模擬觸控],會提示您切換遊戲。 若要確認串流使用您的配置,請依照在串流期間切換 TAK 配置中的說明,在 [組合配置] 下檢查是否有您的配置。

從另一部裝置側載

若要在手機或平板電腦上測試,請在該裝置可透過本機網路連線的電腦上執行 tak serve。伺服器必須使用 https:
  1. 建立憑證。如需詳細資訊,請參閱憑證產生指示。
  2. 在電腦上,使用 --certificate-file 和 --certificate-password 選項執行 tak serve。
  3. 在手機或平板電腦上安裝憑證並信任該憑證。如需步驟,請參閱在不同用戶端上信任憑證。
  4. 在手機或平板電腦上,開啟 [設定] > [開發人員],開啟 [啟用側載],並在 [側載伺服器位址] 中輸入 https://<your PC's IP address>:9269。
  5. 依照 TAK 側載的步驟 4 和 6 中的說明,檢查 [網路權限] 和 [伺服器連線]。
若要要求密碼,請使用 --password 選項,並在裝置的開發人員設定中輸入相同的密碼。如需詳細資訊,請參閱 Serve 命令。

在串流期間切換 TAK 配置

在開發人員模式下,您可以在串流時切換使用中的配置:
  1. 在串流中,開啟左下角的 [開發人員工具功能表],然後選取 [TAK]。
  2. 在 [選取觸控控制項配置] 下,選取 [組合配置] 或 [系統配置] 下的配置。[組合配置] 會顯示為此串流載入的配置。側載正常運作時,這些就是您的配置。
  3. 選取 [關閉]。
[系統配置] 為 [標準] 和 [僅原生觸控 (空白)]。[標準] 會顯示標準控制器覆疊。[僅原生觸控 (空白)] 會移除觸控控制項。

滑鼠和鍵盤

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

試用全新體驗

若要切換至 play.xbox.com 上的全新體驗,請選取您的設定檔相片,然後選取 [試用全新體驗] > [立即試用]。若要返回 xbox.com/play,請從您的設定檔開啟 [帳戶設定],然後選取 [結束預覽]。
最後修改於 2026年11月6日