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

# 管理游戏流式传输 (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` 命令为开发套件设置的任何流设置覆盖写出。 |

<a id="wdgamestream_startlistening" />

## wdgamestream startlistening

开始在开发套件上侦听直连流式传输连接。

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

<Note>为获得最佳兼容性,建议**不要**设置 `version` 或 `config`。</Note>

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

<a id="wdgamestream_stoplistening" />

## wdgamestream stoplistening

停止在开发套件上侦听直连流式传输连接。

`wdgamestream stoplistening`

<a id="wdgamestream_status" />

## wdgamestream status

查询开发套件的流式传输状态。

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

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

<a id="wdgamestream_listconfigs" />

## wdgamestream listconfigs

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

`wdgamestream listconfigs`

<a id="wdgamestream_enableremoteconnect" />

## wdgamestream enableremoteconnect

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

`wdgamestream enableremoteconnect accountEmail=xxxx@y.com`

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

<a id="wdgamestream_disableremoteconnect" />

## wdgamestream disableremoteconnect

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

`wdgamestream disableremoteconnect accountEmail=xxxx@y.com`

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

<a id="wdgamestream_remoteconnectstatus" />

## wdgamestream remoteconnectstatus

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

`wdgamestream remoteconnectstatus accountEmail=xxxx@y.com`

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

<a id="wdgamestream_setconfigoverride" />

## wdgamestream setconfigoverride

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

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

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

<a id="wdgamestream_clearconfigoverride" />

## wdgamestream clearconfigoverride

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

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

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

<a id="wdgamestream_dumpconfigoverride" />

## wdgamestream dumpconfigoverride

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

`wdgamestream dumpconfigoverride`

## 另请参阅

[管理游戏流式传输 (xbgamestream.exe)](/tools/tools-console/commandlinetools/xbgamestream)

[开发套件命令行工具](/tools/tools-console/console_commandlinetools/consolecommandlinetools)

[XTF 传输错误](/tools/tools-console/commandlinetools/xtf-transport-errors)


## Related topics

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