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

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

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

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

## 要注意的事項

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

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

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

<img src="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" alt="正確顯示的 XBOX 標誌" width="200" height="200" data-path="images/gdk/features/common/game-streaming-good-logo.png" />

### 請注意下列問題：

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

<img src="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" alt="被拉長為錯誤外觀比例的 XBOX 標誌" width="200" height="300" data-path="images/gdk/features/common/game-streaming-logo-stretched.png" />

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

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

<img src="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" alt="一側被截斷的 XBOX 標誌" width="122" height="200" data-path="images/gdk/features/common/game-streaming-logo-cutoff.png" />

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

#### UI 重疊

<img src="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" alt="文字錯誤地與影像重疊的 XBOX 標誌" width="339" height="151" data-path="images/gdk/features/common/game-streaming-logo-overlap.png" />

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

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

<img src="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" alt="兩側有黑邊的 XBOX 標誌" width="400" height="200" data-path="images/gdk/features/common/game-streaming-logo-letterbox.png" />

## 設定測試

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

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

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

## 確保測試涵蓋範圍

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

1. 最大像素數：以達到您傳遞給 [XGameStreamingGetDisplayDetails](/zh-TW/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails) 之 `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 的外觀比例。

## 另請參閱

[自訂解析度概觀](/zh-TW/build/core-features/common/game-streaming/game-streaming-custom-resolution-overview)


## Related topics

- [認證 PC BVT 指南](/zh-TW/publishing/game-publishing/concepts/certification/certification-pc-bvt-guide.md)
- [最常失敗的測試案例](/zh-TW/publishing/certification/xr-top-failing.md)
- [認證逐步指南](/zh-TW/publishing/game-publishing/concepts/certification/certification-guide.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [XR-003 提交的遊戲品質](/zh-TW/publishing/certification/xr/xr-003.md)