通过

如何使用远程 Windows 游戏开发工具

重要

Xbox 电脑工具箱应用处于预览状态。 若要了解详细信息，请联系Microsoft代表。

设置开发设备

  1. 在你的设备上，从 Windows 上的 Microsoft 应用商店下载并安装 Xbox 电脑工具箱。

  2. 打开应用。 选择“ 设置为开发设备”，然后选择“ 继续”。

  3. 选择“ 安装工具” ，为环境添加所需的组件。

    注意

    选择“ 安装工具” 即表示你接受 协议条款。 若要查看条款，请选择安装屏幕上的链接。

    Xbox 电脑工具箱应用设置先决条件安装屏幕

  4. 安装后，选择安全通道的网络适配器。 如果系统有一个适配器，则会自动选择它。

  5. 添加强通行短语来保护 SSH 密钥。 安全地保存通行短语。

  6. 选择“ 确认 ”以启动设备配置过程。

  7. 配置完成后，你将看到设备工作区屏幕。

设置远程目标设备

注意

这两个设备的设置步骤相同，只不过：

  • 步骤 2：改为选择“设置为远程迭代设备”
  • 步骤 5：不要在目标设备上创建 SSH 密钥或添加通行短语。

按照与开发设备相同的步骤执行到步骤 6，并执行上述调整。

配对设备

  1. 在远程目标设备上： 在工作区中，选择“ 配对此设备 ”以开始配对。

    配对此设备

  2. 在目标设备上： 选择 “开始配对”。 应用生成固定并显示连接详细信息。 请注意这些详细信息以设置和测试连接。

    远程设备连接详细信息

    注意

    在开发电脑上有 2 分钟的时间输入引脚过期。

  3. 在开发设备上： 在“设备工作区”屏幕上，选择“ 配对设备”。 这将打开配对屏幕，以输入从远程迭代设备获取的连接信息。 输入别名、IP 地址或设备名称、用户名和 PIN。 选择“确认”。

    配对新设备

  4. 在远程目标设备上： 配对成功后，选择“ 返回主页 ”以返回到工作区。 设备已准备好进行安全远程连接。

    配对成功

  5. 在开发设备上： 若要完成设置，请接受 SSH 指纹。 应用会打开终端，询问你是否要继续。 键入 yes，然后按 Enter。

    接受 SSH 指纹

    注意

    连接后，键入 exit 并按 Enter 关闭窗口。 使用 X 按钮关闭可能会导致已知问题。

  6. 在开发设备上 连接测试完成后，成功屏幕将确认设备已安全配对。 选择“ 返回”。

使用 Xbox 电脑设备管理器 (XDM)

Xbox 电脑设备管理器 (XDM) 是在安装过程中安装的 PowerShell 模块。 它在开发电脑和远程设备之间创建安全、加密的通信。 XDM 管理设备购置、OpenSSH 配置、信任，并通过设备状态管理启用远程命令执行。

启动交互式会话

在开发电脑上，转到 Xbox 电脑工具箱中的设备工作区。 找到要连接到的设备卡，然后选择“连接”。

“连接设备工作区”屏幕

这会在命令行终端中启动与远程设备的交互式会话。 在此处运行的命令在远程设备上执行。

预配远程迭代工具

wdRemote 和 wdEndpoint 是命令行实用工具，用于在与 Xbox 电脑工具箱建立安全连接后，在远程 Windows 设备上增量部署、启动和终止游戏。 配对期间安装的两个独立可执行文件。

  • wdRemote.exe：在开发电脑上运行并发送命令。
  • wdEndpoint.exe：在目标设备上运行并执行命令。

使用 wdRemote

在开发电脑上打开命令行终端以运行 wdRemote 命令。

部署游戏

指定远程计算机的路径时，请使用相对于 gameroot 目录的路径。 游戏根目录位于 C:\%ProgramData%\Microsoft GDK\wdEndpoint\gameroot 目标设备上。

# Syntax
wdRemote /action:deploy /device:<computername or ip address> /source:<source_directory> /destination:<destination_directory_under_gameroot>

# Example
wdRemote /action:deploy /device:mypc1 /source:c:\game /destination:gamedir

启动游戏

# Syntax  
wdRemote /action:launch /device:<computername or ip address> /path:<remote_path_to_exe_within_gameroot>

# Example
wdRemote /action:launch /device:mypc1 /path:gamedir\game.exe

终止游戏

# Syntax
wdRemote /action:terminate /device:<computername or ip address> /processid:<game_process_id>

# Example
wdRemote /action:terminate /device:mypc1 /processid:1234

发送反馈

在 Xbox 电脑工具箱标题栏中，选择“ 发送反馈”。 然后选择“ 报告问题”。

替换文字

报告问题时，包括：

  • 作系统版本 (Windows 10/11 版本)
  • Xbox 设备管理 $PSVersionTablePowerShell 模块问题的 PowerShell 版本 ()
  • 网络配置 (Wi-Fi/以太网、企业/家庭)
  • 错误消息 (确切文本)
  • 重现步骤
  • 使用哪个工具 (Xbox 电脑工具箱、Xbox 设备管理 PowerShell 模块、wdRemote 或 wdEndpoint)
  • 你正在使用的预览版
  • Last updated on