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

# XBOX 游戏开发文档

> 使用 XBOX Game Development Kit (GDK)、PlayFab 和 XBOX 服务，为 XBOX Series X|S、XBOX One 和 Windows PC 构建并发布游戏。

本站介绍如何为 **XBOX Series X|S 主机**、**XBOX One 系列主机**以及 **Windows PC** 构建并发布游戏。请按顺序完成下方四个步骤，将一个游戏创意逐步落地为可在真实硬件上运行的构建。

## 适用产品

* XBOX Series X|S 主机
* XBOX One 系列主机
* Windows PC

## 核心术语

* **XBOX Game Development Kit (GDK)：** XBOX 免费提供的用于构建 XBOX 与 Windows 游戏的工具包。
* **ID\@XBOX：** 面向独立工作室开放 GDK 访问权限并授权在 XBOX 上发布游戏的项目。
* **Partner Center：** Microsoft 开发者门户，用于注册你的工作室并提交完成后的游戏。
* **开发套件 (Dev kit)：** 一台专为开发配置的 XBOX 主机。起步阶段并不需要。

如果遇到不熟悉的术语，请参阅[术语表](/home/glossary)。

## 四步路径

<Steps>
  <Step title="加入 ID@XBOX 以获取构建权限" icon="id-card">
    在下载 GDK 或发布游戏之前，XBOX 需要先核实你的工作室。你需要提交一份简短的申请，签署保密协议，并让你的游戏概念获得审批。加入 ID\@XBOX 免费。

    请预留至少两周时间。其中大部分时间用于 XBOX 审核。

    <Card title="开始 ID@XBOX 注册流程" icon="arrow-right" href="/home/onboarding">
      按顺序讲解每一步，并给出实际耗时预期。
    </Card>

    <Tip>
      如果你已经完成注册与环境搭建，可直接前往[入门指南](/home/build-first-title/developing-new-titles)选择适合你的路径。
    </Tip>
  </Step>

  <Step title="安装工具" icon="download">
    在你的 Windows PC 上安装三个组件：用于代码编辑的 **Visual Studio**、提供 Windows 编程 API 的 **Windows SDK**，以及提供 XBOX 编程 API 的 **XBOX Game Development Kit (GDK)**。构建一个示例游戏以确认环境搭建成功。

    <Card title="设置并安装 GDK" icon="arrow-right" href="/home/setup-install/get-started">
      介绍 GDK 是什么，并提供分步安装指引。
    </Card>
  </Step>

  <Step title="构建你的第一个项目" icon="play">
    打开 Visual Studio，选择一个 XBOX 项目模板，构建一个最简版本的游戏。以此验证你的工具链、项目模板和目标硬件能够端到端正常工作。

    <Card title="构建你的第一款作品" icon="arrow-right" href="/home/build-first-title/developing-new-titles">
      项目模板与你的第一次构建。
    </Card>
  </Step>

  <Step title="选择你的入门指南" icon="compass">
    选择一份与你所构建内容相匹配的指南。你可以选择目标设备（XBOX Series X|S 主机、Windows PC 和 ROG XBOX Ally，或通过 Play Anywhere 同时覆盖两者）、你已经使用的引擎（Unreal、Unity、Godot、GameMaker 或自研引擎），也可以选择移植路径（如果你已经在其他平台发布过作品）。

    <Card title="浏览入门指南" icon="arrow-right" href="/home/build-first-title/developing-new-titles">
      七条精选路径。选择最适合你项目的一条。
    </Card>
  </Step>
</Steps>

## 常见范围类问题

<AccordionGroup>
  <Accordion title="我是个人开发者或独立工作室。XBOX 开发适合我吗？">
    适合。ID\@XBOX 支持独立工作室和个人开发者。加入无需费用，所使用的工具（GDK、Visual Studio、PlayFab）与大型工作室使用的完全一致。你可以完全在 Windows PC 上进行开发。只有当你准备好在 XBOX 硬件上测试时，才需要开发套件。
  </Accordion>

  <Accordion title="我使用的是 Unity、Unreal 或 Godot。我还需要 GDK 吗？">
    需要，但你很少会直接与它交互。你的引擎会代你调用 GDK。你仍需要在 PC 上安装 GDK，这样引擎才能将你的游戏打包到 XBOX，并使用成就、云存档等 XBOX 功能。请在步骤 4 中选择对应引擎的[入门指南](/home/build-first-title/developing-new-titles)。
  </Accordion>

  <Accordion title="我已经有一款 PC 或 Steam 游戏。可以移植吗？">
    可以。由于你的玩法代码已经写好，移植通常比从零开始更快。请从[移植路径](/paths/porting/overview)入手，或直接跳转到你的源平台：[来自 Steam](/paths/porting/from-steam)、[来自上一代 XBOX](/paths/porting/from-xbox-era)、[来自其他平台](/paths/porting/from-console) 或 [来自 PC（非 Steam）](/paths/porting/from-pc)。
  </Accordion>

  <Accordion title="我需要什么操作系统和硬件？">
    你需要一台 64 位的 **Windows 10 或 Windows 11 PC**，以及约 30 GB 的可用空间用于安装 GDK。开始阶段无需 XBOX 主机。你可以在本地构建并测试 Play Anywhere 的 PC 版本。当你准备好在 XBOX 硬件上测试时，可通过 Partner Center 订购开发套件。
  </Accordion>
</AccordionGroup>

## 文档章节

在入门指南带你深入文档之后，可以使用以下这些章节：

<Columns cols={2}>
  <Card title="构建" icon="code" href="/home/setup-install/get-started">
    GDK 主题：游戏配置、打包、存档、输入、网络以及跨设备开发。
  </Card>

  <Card title="服务" icon="server" href="/services/xbox-services/index">
    XBOX 服务与 PlayFab：身份、成就、多人游戏、经济系统以及运营。
  </Card>

  <Card title="主机特性" icon="tv" href="/build/console-features/index">
    Quick Resume、DirectStorage、Smart Delivery 以及其他仅限主机的能力。
  </Card>

  <Card title="工具" icon="screwdriver-wrench" href="/tools/index">
    Visual Studio 配置、XBOX 服务工具、性能分析器和诊断工具。
  </Card>

  <Card title="发布与商务" icon="store" href="/publishing/game-publishing/overview">
    认证、XR 要求、商店信息、定价与提交。
  </Card>

  <Card title="API 参考" icon="brackets-curly" href="/reference/system/gc-reference-system-toc">
    Gaming Runtime、XBOX 服务以及平台 API。
  </Card>
</Columns>

## 快速链接

<Columns cols={3}>
  <Card title="下载 GDK" icon="download" href="/home/setup-install/download-install">
    需要 ID\@XBOX 权限。
  </Card>

  <Card title="GDK 示例" icon="github" href="https://github.com/microsoft/Xbox-GDK-Samples">
    GitHub 上可构建的示例。
  </Card>

  <Card title="错误代码" icon="circle-exclamation" href="/reference/errorcodes">
    GDK 与 XBOX 服务错误查询。
  </Card>
</Columns>


## Related topics

- [XBOX 游戏开发文档](/zh-CN/index.md)
- [XBOX 主机游戏开发环境与工具](/zh-CN/tools/tools-console/gc-tools-console-toc.md)
- [开发](/zh-CN/services/xbox-services/develop/index.md)
- [Microsoft 游戏开发工具包网络简介](/zh-CN/build/console-features/networking/introduction-networking.md)
- [XBOX GDK 游戏的输入 API 与硬件](/zh-CN/build/core-features/common/input/index.md)