> ## 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 Gaming Explorer

> XBOX Gaming Explorer

XBOX Gaming Explorer 是裝載於 Visual Studio 整合式開發環境 (IDE) 中的視窗，可簡化與主機相關的常見開發人員工作流程，主要包括偵錯、啟動處理序以及監視主機狀態。

XBOX Gaming Explorer 整合了 [xbWatson](https://docs.xbox.com/zh-TW/tools/tools-console/xbWatson/xbwatson.md) 與 [XBOX Manager](https://docs.xbox.com/zh-TW/tools/tools-console/xbom/xbom.md) 中一些常見的開發人員導向功能，並簡化了常見偵錯情境的存取。使用 XBOX Gaming Explorer，即可直接在 Visual Studio IDE 中完成更多工作。

您可以使用 Visual Studio 中的 XBOX 功能表存取 XBOX Gaming Explorer。XBOX 功能表位於延伸模組功能表底下，如下圖所示。

![Visual Studio 2019 中的 XBOX Gaming Explorer](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-vs2019-menu.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=9563103e1329f5648dfd3d2c5f32ec4b)

XBOX Gaming Explorer 中的功能分為三個索引標籤：主機詳細資料、主機與 XBOX 開發人員工具啟動器。用於選取四個索引標籤其中之一的功能區，也提供檢視此說明頁面以及存取 [XBOX Manager](https://docs.xbox.com/zh-TW/tools/tools-console/xbom/xbom.md) 等其他工具中常見之 *Report A Problem* 功能的能力。

## 主機詳細資料

使用主機詳細資料索引標籤監視主機上執行的遊戲處理序、啟動與偵錯已註冊的遊戲、讓遊戲在各種[處理序生命週期管理](https://docs.xbox.com/zh-TW/build/console-features/console-workflows/xbox-game-life-cycle.md) (PLM) 狀態之間循環、儲存迷你傾印，以及在主機上執行可執行檔，如下圖所示。

![主機詳細資料索引標籤](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-console-details-tab.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=a3fdc90f6945477318da27e64ea2e4c3)

### 遊戲處理序

遊戲處理序以及在 Game OS 中執行的任何公用程式，都會列在 *Game Processes* 表格中。表格中顯示的欄會顯示處理序的目前狀態，以及其處理序識別碼 (PID)、執行中的執行緒數量與開啟的控制代碼數量。您可以使用表格標題旁的齒輪圖示變更表格中顯示的欄集合。

![用於變更要顯示之欄集合的圖示](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-console-details-tab-gear-icon.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=d0c9ed368fea9ae0905f063d253e66b8)

*Status* 欄包含下列三個圖示。

* 當處理序資料在過去五秒內發生變更時，三角形圖示會變成綠色。
* 當處理序已結束時，方形圖示會變成紅色。
* 當偵錯工具附加至處理序時，雙方塊圖示會變成淺藍色。

這三個圖示如下圖所示。

![顯示三個圖示的狀態欄](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-console-details-tab-status-column.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=e0eee1cff69aa747bf70cdb6b823679f)

選取處理序旁的箭號，或以滑鼠右鍵按一下表格資料列，即可顯示內容功能表，如下圖所示。內容功能表提供下列動作：

* 附加至處理序
* 終止處理序
* 儲存迷你傾印
* 更新包含該處理序相關資訊的 Visual Studio 屬性視窗。

![遊戲處理序與內容功能表](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-console-details-process-context-menu.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=c9e6a49098d2dd40a23f1632c45e8df9)

從內容功能表選取 *Save Dump As...* 會顯示一個對話方塊，可讓您指定迷你傾印的類型，以及迷你傾印要儲存至開發電腦上的哪個檔案，如下圖所示。

![儲存迷你傾印](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-console-details-minidump.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=3b21b33dce832d6c969b0a06544230ba)

### 遊戲

主機詳細資料索引標籤包含目前主機上已註冊的遊戲清單。*Games* 清單包含如下圖所示的內容功能表，可用於執行下列動作：

* 啟動、終止或附加至遊戲
* 選擇要啟動的遊戲可執行檔
* 設定遊戲的命令列引數
* 儲存迷你傾印
* 將遊戲轉換至不同的 PLM 狀態
* 在 Visual Studio 屬性視窗中檢視遊戲的屬性。

![遊戲內容功能表](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-console-details-registered-titles.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=fdc7b3bcce81226cb8350b514b7c1cbe)

選取 **Set Command Arguments...** 內容功能表會顯示一個編輯方塊，您可以用它輸入在遊戲啟動時要傳遞給遊戲的引數。輸入引數後，選取 **Save Parameters** 按鈕，即可在下次啟動遊戲時將參數傳遞給遊戲。

![設定命令引數](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-console-details-command-arguments.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=d1b55aaee926960a7514569e16db71fc)

#### 編輯遊戲屬性

在主機詳細資料檢視的 **Games** 區段中選取 **Show/Edit Title Properties** 功能表項目，會在 Visual Studio 屬性頁中填入一組遊戲屬性。屬性會依類別分組。以粗體顯示的屬性可以編輯。**Debugging** 類別包含在各種偵錯情境中常設定的屬性。

![所選遊戲的屬性頁](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-console-details-game-properties.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=134d61069deda3e4f8ad807809981e64)

從 **Break on Suspend Timeout** 下拉式清單選取 **True**，會在暫停處理常式花費超過 1 秒才完成時，讓偵錯工具中斷進入您的遊戲。

從 **Log Module Loading** 下拉式清單選取 **True**，會在偵錯期間於 Visual Studio 輸出視窗中顯示作業系統載入器的輸出。載入器的記錄包含作業系統所載入之所有模組的資訊，包括重新導向。偵錯 DLL 載入失敗 (包括「找不到相依 dll」) 是此記錄的常見用途。

從 **Stop at Entry Point** 下拉式清單選取 **True**，會讓偵錯工具在遊戲的主要進入點中斷。此選項適用於偵錯遊戲啟動早期發生的問題。

如需這些屬性的詳細資訊，請參閱 [XBOX 開發的 Visual Studio 屬性](https://docs.xbox.com/zh-TW/tools/tools-console/visualstudio/durango-property-pages.md)。

> [!NOTE]
>
> 使用遊戲屬性頁設定的屬性，只有在從 XBOX Gaming Explorer 啟動遊戲時才會生效。如果您使用 F5 啟動專案，這些設定不會生效。若要為透過 F5 啟動設定這些屬性，請使用在 **方案總管** 中以滑鼠右鍵按一下專案並選取 **屬性** 內容功能表項目所存取的屬性頁。

### 執行可執行檔

主機詳細資料索引標籤提供在主機上啟動工具可執行檔的功能。這些工具包括作業系統所提供的工具，或您的工作室所開發的任何工具。使用 XBOX Gaming Explorer 啟動的工具會在 Game OS 中執行，而不是在 System OS 中執行。使用主機詳細資料索引標籤的 **Run Executable** 部分，指定工具在主機上的路徑以及任何啟動引數。使用 **Run Executable** 啟動之任何工具的輸出，會顯示在 Visual Studio 的 **Gaming** 輸出視窗中。在下圖中，已使用 **Run Executable** 執行作業系統公用程式 **filever.exe**，以列出目前執行中遊戲之所有可執行檔的版本資訊。

![執行可執行檔](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-console-details-run-executable.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=062b0bba3332517d24c23b729620fc76)

您必須指定要執行之可執行檔的完整路徑，除非該可執行檔位於主機上 Game OS 中的 C:\windows\system32 目錄中。

> [!NOTE]
>
> **Run Executable** 只能用於啟動工具可執行檔，不能用於啟動遊戲。遊戲可以透過多種方式啟動，包括 XBOX Gaming Explorer 中的 **Games** 清單、Visual Studio F5 與 Ctrl+F5 命令、[XBOX Manager](https://docs.xbox.com/zh-TW/tools/tools-console/xbom/xbom.md)、[Windows Device Portal](https://docs.xbox.com/zh-TW/tools/tools-console/wdp/wdp.md) 以及 [xbapp](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbapp.md)。

## 主機

主機索引標籤提供您可以連線並搭配 XBOX Gaming Explorer 使用的主機清單。如果您已使用 [XBOX Manager](https://docs.xbox.com/zh-TW/tools/tools-console/xbom/xbom.md) 或 [xbconnect](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconnect.md) 指定預設主機，該主機會自動出現在 XBOX Gaming Explorer 中。預設主機會以代表主機之圖示旁的星號 (\*) 來識別。

您可以使用主機索引標籤上的 *Add a Console* 按鈕新增其他主機，如下圖所示。

![新增主機](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-console-add-console.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=ae16f8648ee6385950a783dcd3b95606)

從清單中選取主機會連線至該主機，並以該主機的處理序與遊戲更新主機詳細資料索引標籤。

> [!NOTE]
>
> XBOX Gaming Explorer 中顯示的主機清單與 XBOX Manager 中顯示的主機清單可能會不同步。這些清單將在未來的版本中同步。

主機清單具有如下圖所示的內容功能表，可對主機執行各種動作，包括在 Visual Studio 屬性視窗中填入主機的相關資訊。以粗體顯示的屬性可直接從屬性視窗編輯。

![主機索引標籤與內容功能表](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-console-console-properties.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=fe6504309cc04e3d5cd48c3ae1d91408)

## XBOX 開發人員工具啟動器

如下圖所示的 XBOX 開發人員工具啟動器索引標籤，提供一種方便的方式來啟動 Microsoft Game Development Kit (GDK) 中隨附的其他工具。選取工具的名稱或圖示即可啟動該工具。

![XBOX 開發人員工具啟動器](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/gaming-explorer-launcher.png?fit=max\&auto=format\&n=z-rLYkO3Ax6HPtgm\&q=85\&s=6ce8e26e1d6c917c0eaae0e4128286b0)

## 另請參閱

[Visual Studio](https://docs.xbox.com/zh-TW/tools/tools-console/visualstudio/visualstudio.md) [擷取當機傾印](https://docs.xbox.com/zh-TW/build/console-features/debugging-diagnostics/retrieving-crash-dumps.md)


## Related topics

- [使用 Visual Studio 偵錯 XBOX 專案](https://docs.xbox.com/zh-TW/tools/tools-console/visualstudio/debugging-with-visualstudio.md)
- [XBOX System Monitor](https://docs.xbox.com/zh-TW/tools/tools-console/visualstudio/xbox-system-monitor.md)
- [Visual Studio](https://docs.xbox.com/zh-TW/tools/tools-console/visualstudio/index.md)
- [用於主機開發的 Visual Studio](https://docs.xbox.com/zh-TW/tools/tools-console/visualstudio/visualstudio.md)
- [XBOX Game View](https://docs.xbox.com/zh-TW/tools/tools-console/visualstudio/xbox-game-view.md)
