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

# 管理游戏流式传输 (wdgamestream.exe)

> 管理游戏流式传输 (wdgamestream.exe)

使用此工具查询主机当前是否已启用游戏流式传输,并管理此状态。

| 命令 | 说明 |
| :- | :- |
| [startlistening](#wdgamestream_startlistening) | 开发工具包开始侦听连接。 |
| [stoplistening](#wdgamestream_stoplistening) | 开发工具包停止侦听连接。 |
| [status](#wdgamestream_status) | 查询开发工具包的流式传输状态。 |
| [listconfigs](#wdgamestream_listconfigs) | 列出所支持的流式传输基础配置。 |
| [enableremoteconnect](#wdgamestream_enableremoteconnect) | 为指定用户启用远程连接。此设置在设备重启后仍会保留。 |
| [disableremoteconnect](#wdgamestream_disableremoteconnect) | 为指定用户禁用远程连接。此设置在设备重启后仍会保留。 |
| [remoteconnectstatus](#wdgamestream_remoteconnectstatus) | 查询指定用户的远程连接状态。 |
| [setconfigoverride](#wdgamestream_setconfigoverride) | 为基础流配置设置流设置覆盖。 |
| [clearconfigoverride](#wdgamestream_clearconfigoverride) | 清除通过 `setconfigoverride` 命令设置的流设置覆盖。 |
| [dumpconfigoverride](#wdgamestream_dumpconfigoverride) | 将通过 `setconfigoverride` 命令为开发工具包设置的任何流设置覆盖写出。 |

## wdgamestream startlistening

开始在开发工具包上侦听直连流式传输连接。

`wdgamestream startlistening [version=<version>] [config=<config>]`

> [!NOTE]
>
> 为获得最佳兼容性,建议**不要**设置 `version` 或 `config`。

| 参数 | 说明 |
| :- | :- |
| version | 可选参数,用于指定要使用的协议版本。默认为主机支持的最新协议版本。 |
| config | 可选参数,用于指定要使用的流配置。默认为目标开发工具包支持的最高比特率配置。 |

## wdgamestream stoplistening

停止在开发工具包上侦听直连流式传输连接。

`wdgamestream stoplistening`

## wdgamestream status

查询开发工具包的流式传输状态。

`wdgamestream status [/B] [/S]`

| 选项 | 说明 |
| - | - |
| `/B` | 指定简洁格式。启用后,**status** 命令仅输出简洁的结果。简洁模式必须与至少一个其他标志一起使用,以指明要检索哪些状态数据(例如 **/S**)。 |
| `/S` | 仅指定流式传输状态。启用后,**status** 命令仅打印开发工具包的流式传输状态。 |

## wdgamestream listconfigs

列出所支持的流式传输基础配置。提供一种方式列出开发工具包可用的流式传输配置选项。

`wdgamestream listconfigs`

## wdgamestream enableremoteconnect

为指定用户启用远程连接。

`wdgamestream enableremoteconnect accountEmail=xxxx@y.com`

| 选项 | 说明 |
| - | - |
| `accountEmail` | 必需参数。指定要为其启用远程连接的电子邮件帐户。请注意,该帐户必须当前已在 XBOX 上登录才能启用远程连接,并且应在登录流式传输客户端时使用该帐户。 |

## wdgamestream disableremoteconnect

为指定用户禁用远程连接。

`wdgamestream disableremoteconnect accountEmail=xxxx@y.com`

| 选项 | 说明 |
| - | - |
| `accountEmail` | 必需参数。指定要为其启用远程连接的电子邮件帐户。请注意,该帐户必须当前已在 XBOX 上登录才能启用远程连接,并且应在登录流式传输客户端时使用该帐户。 |

## wdgamestream remoteconnectstatus

查询指定用户的远程连接状态。

`wdgamestream remoteconnectstatus accountEmail=xxxx@y.com`

| 选项 | 说明 |
| - | - |
| `accountEmail` | 必需参数。指定要为其启用远程连接的电子邮件帐户。请注意,该帐户必须当前已在 XBOX 上登录才能启用远程连接,并且应在登录流式传输客户端时使用该帐户。 |

## wdgamestream setconfigoverride

设置一个或多个基础流配置的设置覆盖。直连的基础流配置由 `startlistening` 命令的 `config` 参数指定。远程连接的基础流配置由 XBOX 服务确定。设置覆盖对直连在 `startlistening` 时应用,对远程连接在新流连接时应用。覆盖不会在重启之间保留,如需保留,应在重启后重新设置。

`wdgamestream setconfigoverride [maxBitrate=<value>] [minBitrate=<value>] [maxResolution=<value>] [minResolution=<value>] [allowDirectCapture=<true | false>]`

| 选项 | 说明 |
| - | - |
| `allowDirectCapture` | 可选布尔值,用于启用或禁用直接采集。默认值:*true*。 |
| `maxBitrate` | 可选参数,用于覆盖流的最大比特率。示例值:*12000000*。 |
| `minBitrate` | 可选参数,用于覆盖流的最小比特率。示例值:*6000000*。 |
| `maxResolution` | 可选参数,用于覆盖视频流建议的最大分辨率。示例值:*720p*、*1080p*。 |
| `minResolution` | 可选参数,用于覆盖视频流建议的最小分辨率。示例值:*720p*、*1080p*。 |

## wdgamestream clearconfigoverride

清除通过 `setconfigoverride` 命令设置的一个或多个设置覆盖。

`wdgamestream clearconfigoverride [/A] [maxBitrate] [minBitrate] [maxResolution] [minResolution] [allowDirectCapture]`

| 选项 | 说明 |
| - | - |
| `/A` | 清除所有覆盖。 |
| `allowDirectCapture` | 可选参数,用于清除直接采集覆盖。 |
| `maxBitrate` | 可选参数,用于清除最大比特率覆盖。 |
| `minBitrate` | 可选参数,用于清除最小比特率覆盖。 |
| `maxResolution` | 可选参数,用于清除最大分辨率覆盖。 |
| `minResolution` | 可选参数,用于清除最小分辨率覆盖。 |

## wdgamestream dumpconfigoverride

将通过 `setconfigoverride` 命令为开发工具包设置的所有设置覆盖写出。

`wdgamestream dumpconfigoverride`

## 另请参阅

[管理游戏流式传输 (xbgamestream.exe)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xbgamestream.md)

[开发工具包命令行工具](https://docs.xbox.com/zh-CN/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)

[XTF 传输错误](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xtf-transport-errors.md)


## Related topics

- [管理游戏流式传输 (xbgamestream.exe)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xbgamestream.md)
- [基于主机的命令行工具](https://docs.xbox.com/zh-CN/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
- [所有平台通用的 GDK 功能](https://docs.xbox.com/zh-CN/build/core-features/common/common-features-overview.md)
- [错误代码](https://docs.xbox.com/zh-CN/reference/errorcodes.md)
- [流式传输页面 (Dev Home)](https://docs.xbox.com/zh-CN/tools/tools-console/devhome/devhome-streaming.md)