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

# 使用自訂解析度進行測試

> 使用自訂解析度進行測試

以不同的解析度和外觀比例進行轉譯，可能會影響遊戲的效能或視覺配置。Microsoft 建議以不同的解析度和外觀比例測試您的遊戲，以確保它在串流目標的每部裝置上都能順利執行。

## 要注意的事項

最可能發生的問題類別如下：

1. 效能相關：以較高或較低解析度轉譯時的效能差異所造成的畫面播放速率下降、當機或競爭情形。這些也可能受到視野變更的影響 (例如，較寬的螢幕一次顯示更多敵人，導致畫面播放速率降低)。您通常用於效能測試的工具 (例如 PIX) 也適用於自訂解析度。
2. 視覺/UI 配置：可能會發生類似下列範例的問題，尤其是 UI 重疊。

### 對於預期外觀如下的遊戲：

![正確顯示的 XBOX 標誌](https://mintcdn.com/microsoft-4404708b/UZTRJSf0emX1fheE/images/gdk/features/common/game-streaming-good-logo.png?fit=max\&auto=format\&n=UZTRJSf0emX1fheE\&q=85\&s=ac24f506455ef421f021672b49e6fe1b)

### 請注意下列問題：

拉長或壓扁的影像/文字。如果整個畫面看起來像下圖一樣被拉長，可能是背景緩衝區解析度與傳遞給 XGameStreamingSetResolution 的值不相符。

![被拉長為錯誤外觀比例的 XBOX 標誌](https://mintcdn.com/microsoft-4404708b/UZTRJSf0emX1fheE/images/gdk/features/common/game-streaming-logo-stretched.png?fit=max\&auto=format\&n=UZTRJSf0emX1fheE\&q=85\&s=6b217862400158ae97155cd7b190cc1f)

如果轉譯對外觀比例做出不正確的假設，就可能會發生這種情況。

#### 被截斷的影像/文字

![一側被截斷的 XBOX 標誌](https://mintcdn.com/microsoft-4404708b/UZTRJSf0emX1fheE/images/gdk/features/common/game-streaming-logo-cutoff.png?fit=max\&auto=format\&n=UZTRJSf0emX1fheE\&q=85\&s=91a34dc5cdcd55e6047079170137551f)

如果 UI 配置對解析度或外觀比例做出不正確的假設，就可能會發生這種情況。

#### UI 重疊

![文字錯誤地與影像重疊的 XBOX 標誌](https://mintcdn.com/microsoft-4404708b/UZTRJSf0emX1fheE/images/gdk/features/common/game-streaming-logo-overlap.png?fit=max\&auto=format\&n=UZTRJSf0emX1fheE\&q=85\&s=526778e85eec94850453a3340542ab30)

如果 UI 元素的大小和位置沒有針對不同的解析度或外觀比例適當縮放，就可能會發生這種情況。

> [!NOTE]
>
> 如果您裝置的螢幕或視窗與串流解析度不相符，系統會自動加入黑色的上下黑邊或左右黑邊，因此類似下列的情況可能是預期的結果：

![兩側有黑邊的 XBOX 標誌](https://mintcdn.com/microsoft-4404708b/UZTRJSf0emX1fheE/images/gdk/features/common/game-streaming-logo-letterbox.png?fit=max\&auto=format\&n=UZTRJSf0emX1fheE\&q=85\&s=165776daec803b213aebd528f22ca449)

## 設定測試

若要測試自訂解析度，您需要從 XBOX Series X Dev Kit 進行串流。如需設定串流的指示，請參閱[這裡](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-web-content-test-application.md)。雖然可以使用各種用戶端裝置進行測試，但測試自訂解析度最簡單的方式是串流到 PC 上的 Edge。在該 PC 上，您可以將串流視窗調整為不同的解析度來進行測試。

使用 Edge 開發人員工具，您可以將視窗設定為您選擇的特定大小，以確保測試的一致性。若要執行此操作：

1. 開啟 XBOX Game Streaming 遠端連線頁面，並連線到您的開發套件
2. 從「…」>「更多工具」子功能表開啟 Edge 開發人員工具
3. 按一下左上角帶有手機/平板電腦圖示的「切換裝置模擬」按鈕
4. 從頂端解析度旁的預設選項功能表中選擇裝置，或從功能表中選擇「編輯」並按一下「新增自訂裝置」來新增您自己的解析度。如果您新增自訂裝置，請將「裝置像素比例」設定為 1。請注意，可讓您變更解析度的「回應式」設定會根據 PC 的縮放設定，對您選擇的像素值套用乘數，因此使用該設定較難確保解析度正確。
5. 變更模擬的裝置或按一下「旋轉」按鈕，以觸發 DisplayDetails 更新事件

## 確保測試涵蓋範圍

如果您的遊戲支援一組固定的解析度，則確保每個解析度都能正常運作應可提供良好的涵蓋範圍。不過，如果您的遊戲可以縮放至任意解析度，則測試下列四種邊界案例應有助於找出大部分問題：

1. 最大像素數：以達到您傳遞給 [XGameStreamingGetDisplayDetails](https://docs.xbox.com/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails.md) 之 `maxPixelCount` 值的解析度執行遊戲。這應有助於找出任何效能問題。請注意，您傳遞的值可能大於 XBOX Game Streaming 目前支援的值 (截至 2022 年 9 月，最大串流解析度相當於 1080p：2073600 像素；未來可能會增加)。若要以高於串流目前支援的解析度進行測試，您可以使用 16:9 外觀比例進行轉譯，並在不串流的情況下測試遊戲。如果您將 `maxPixelCount` 設定為遊戲在目前系統裝置類型上通常會轉譯的像素數，您的一般測試可能也會涵蓋此情況。
2. 最小解析度：最小串流解析度為 640x360。測試此解析度 (或遊戲的最小解析度，以較大者為準)，以找出異常快速轉譯所造成的競爭情形，並找出在低解析度下會被截斷的 UI 元素。
3. 支援的最寬外觀比例：選擇符合您 `widestSupportedAspectRatio` 值的解析度，以找出 UI 配置或寬廣攝影機視野的問題。截至 2022 年 9 月，串流的最大寬度為 2560 像素 (未來可能會增加)；以最小高度 360 像素計算，即為 64:9 的外觀比例。
4. 支援的最高外觀比例：選擇符合您 `tallestSupportedAspectRatio` 值的解析度，以找出 UI 配置或高聳攝影機視野的問題。截至 2022 年 9 月，串流的最大高度為 1440 像素 (未來可能會增加)；以最小寬度 640 像素計算，即為 4:9 的外觀比例。

## 另請參閱

[自訂解析度概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-custom-resolution-overview.md)


## Related topics

- [自訂解析度概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-custom-resolution-overview.md)
- [遊戲串流自訂解析度的最佳做法](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/game-streaming-custom-resolution-best-practices.md)
- [XBOX Cloud Gaming 觸控與串流支援](https://docs.xbox.com/zh-TW/build/core-features/common/game-streaming/index.md)
- [執行 HTTP 伺服器進行測試](https://docs.xbox.com/zh-TW/services/playfab/identity/player-identity/platform-specific-authentication/running-an-http-server-for-testing.md)
- [方向鍵](https://docs.xbox.com/zh-TW/reference/system/touchadaptationkit/controls/game-streaming-touch-directionalpad.md)