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

# 使用 GDK 專案範本開始新的 PC 遊戲

> 使用五個 GDK Visual Studio 專案範本開始新的 PC 桌面遊戲，涵蓋 Direct3D 12、Gaming Runtime、靜態程式庫、DLL 和 makefile 組建。

本主題說明如何使用 GDK 專案範本開始開發新遊戲。

<Note>
  對於使用 Gaming Runtime 並以 PC 桌面為目標的遊戲，您可以自由使用 Direct3D 12、Direct3D 11，甚至是舊版的 Direct3D 9。請注意，若使用舊版 DirectX SDK 元件 (例如 D3DX9、D3DX10、D3DX11 等)，會有一些特殊考量。如需詳細資訊，請參閱 [DirectX Framework 套件](/zh-TW/build/core-features/common/packaging/packaging-framework-packages)文件。
</Note>

## 使用 Gaming Runtime 的 Visual Studio 專案範本開始使用

在已安裝 Visual Studio 的開發 PC 上安裝 Microsoft Game Development Kit (GDK) 時，會安裝五個以 PC 桌面為目標的專案範本，如下表所示。

| 目標平台 | 範本 | 描述 |
| - | - | - |
| 桌面 | Direct3D 12 Desktop Game (Classic) | 在 Visual Studio 專案系統中建立專案，使用 Gaming Runtime 和標準 x64 MSBuild 平台建置獨立的 PC 遊戲可執行檔。 |
| | Direct3D 12 Desktop Game | 在 Visual Studio 專案系統中建立專案，建置獨立的 PC 遊戲可執行檔。 |
| | Direct3D 12 Desktop Game Makefile | 建立適合使用命令提示字元從 `makefile` 建置 PC 桌面遊戲的專案。 |
| | Desktop Static Library | 在 Visual Studio 專案系統中建立專案，使用 Gaming.Desktop.x64 自訂 MSBuild 平台建置靜態程式庫。適合納入以 PC 桌面為目標的遊戲中。 |
| | Desktop DLL | 在 Visual Studio 專案系統中建立專案，使用 Gaming.Desktop.x64 自訂 MSBuild 平台建置 DLL。適合納入以 PC 桌面為目標的遊戲中。 |

若要存取這些範本：

1. 開啟 Visual Studio。
2. 選取 **\[檔案]** > **\[新增]** > **\[專案]**。隨即出現 **\[新增專案]** 對話方塊。
3. 在 **\[新增專案]** 對話方塊中，將 **\[所有語言]** 篩選條件設定為 **C++**、將 **\[所有平台]** 篩選條件設定為 **Windows**，並將 **\[所有專案類型]** 設定為 **\[遊戲]**。您也可以搜尋上述專案名稱。
4. 從 Microsoft Game Development Kit 專案範本清單中，選取您要的專案範本。
5. 選取 **\[確定]**。

## 使用適當的範本

### 專門以 PC 桌面為目標的遊戲

如果您開發的遊戲專門以 PC 裝置為目標，Direct3D 12 Desktop Game 範本是常見的起點。此範本的一些重要層面包括：

* 使用 Windows API 系列 `WINAPI_FAMILY_DESKTOP_APP`，並連結典型的 PC 桌面程式庫，包括 *kernel32.lib*、*user32.lib* 等。因此，遊戲中可以使用完整的 PC 桌面 API。
* 包含必要的標頭和程式庫，讓範本可隨時新增與 PC 桌面相容的 Direct3D 12 圖形實作。範本提供簡單的交換鏈、Direct3D 裝置，以及基本的遊戲更新與轉譯迴圈。
* 連結 *XGameRuntime.lib* 並包含必要的標頭，讓所有 Gaming Runtime 功能都可立即使用。
* 預設也提供 XBOX Live API (XSAPI) 延伸程式庫。也可以新增其他 Microsoft Game Development Kit (GDK) 延伸程式庫。
* 宣告以「標準」x64 平台或自訂 MSBuild 平台 Gaming.Desktop.x64 為基礎的組建組態，建置 x64 目標，預期您會使用本機偵錯工具在本機 (您的開發 PC 上) 反覆開發遊戲。
* 建立包含預留位置資訊的 *MicrosoftGameConfig.mgc* 檔案，您需要以 Partner Center 中的遊戲資訊填入。

## 另請參閱

* [MicrosoftGame.Config 概觀](/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Overview)
* [開始使用 Gaming Runtime](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/pc-dev/archive/gr-get-started-with-pc-dev-toc)


## Related topics

- [開發新的 GDK 遊戲](/zh-TW/home/build-first-title/developing-new-titles.md)
- [XBOX 遊戲開發文件](/zh-TW/index.md)
- [使用 GDKX 建置並執行你的第一個主機遊戲](/zh-TW/home/build-first-title/first-console-title-walkthrough.md)
- [設定並安裝 GDK](/zh-TW/home/setup-install/get-started.md)
- [GDK 範例](/zh-TW/home/setup-install/samples.md)