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

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

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

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

## 命令

| 命令                   | 说明                                                                                                                                                           |
| :------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| listconfigs          | 列出主机支持的流式传输基础配置。                                                                                                                                             |
| startlistening       | 开始在主机上侦听直连流式传输连接。                                                                                                                                            |
| stoplistening        | 停止在主机上侦听直连流式传输连接。                                                                                                                                            |
| status               | 查询主机的流式传输状态。                                                                                                                                                 |
| enableremoteconnect  | 为指定用户启用远程连接。此设置在设备重启后仍会保留。                                                                                                                                   |
| disableremoteconnect | 为指定用户禁用远程连接。此设置在设备重启后仍会保留。                                                                                                                                   |
| remoteconnectstatus  | 查询指定用户的远程连接状态。                                                                                                                                               |
| setconfigoverride    | 设置一个或多个基础流配置的设置覆盖。直连的基础流配置由 “startlistening” 命令的 “config” 参数指定。远程连接的基础流配置由 XBOX 服务确定。设置覆盖对直连在 “startlistening” 时应用,对远程连接在新流连接时应用。覆盖不会在重启之间保留,如需保留,应在重启后重新设置。 |
| clearconfigoverride  | 清除通过 “setconfigoverride” 命令设置的一个或多个设置覆盖。                                                                                                                     |
| dumpconfigoverride   | 将通过 “setconfigoverride” 命令为主机设置的所有设置覆盖写出。                                                                                                                    |
| /LC                  | 指定区域设置代码。用于覆盖默认的区域设置代码。                                                                                                                                      |

## 全局标志

下表中的标志适用于所有命令。

| 列 1                                                  |
| ---------------------------------------------------- |
| **xbgamestream** \[/X\[*:address*] \[*+accesskey*] ] |

| 标志                              | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| /X\[*:address*] \[*+accesskey*] | - 使用此选项可指定目标主机的主机名或地址(在主机上显示为 **Tools IP**),而不更改默认主机。有关为主机设置主机名的详细信息,请参阅[为主机 IP 地址设置主机名](/home/setup-install/dev-kit-settings/setting-a-hostname)。<br />- 如果不使用此选项,则使用默认主机(先前由 [Connect (xbconnect.exe)](/tools/tools-console/commandlinetools/xbconnect) 设置)。<br />- 使用 *accesskey* 字符串仅向持有访问密钥的人员提供主机访问权限。<br />- 通过命令 **xbconfig** **accesskey=your-key** 设置访问密钥,然后重启主机使访问密钥生效。<br />- 若要访问配置了访问密钥的主机,请在主机的 IP 地址或主机名后加上加号 (+) 和访问密钥。<br />- 如果在通过 [xbconnect](/tools/tools-console/commandlinetools/xbconnect) 设置默认主机时提供了访问密钥,则该访问密钥将作为默认主机地址的一部分存储。<br />- 有关访问密钥的详细信息,请参阅 [xbconfig accesskey](/tools/tools-console/commandlinetools/xbconfig)。<br />- 如果将 **/title** 附加到 **/X**(在地址之后或单独使用),则会使用正在运行的独占应用所看到的分区映射。例如,指定 **/X/title xd:** 将访问对正在运行的独占应用可见的默认主机暂存驱动器分区。 |

## 命令详细信息

### startlistening

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

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

### status

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

### enableremoteconnect

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

### disableremoteconnect

| 参数           | 说明                                  |
| :----------- | :---------------------------------- |
| accountEmail | 指定要为其禁用远程连接的电子邮件帐户。请注意,这应是之前登录过的帐户。 |

### remoteconnectstatus

| 参数           | 说明                   |
| :----------- | :------------------- |
| accountEmail | 指定要检索其远程连接状态的电子邮件帐户。 |

### setconfigoverride

| 参数                 | 说明                                                 |
| :----------------- | :------------------------------------------------- |
| 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>。 |

### clearconfigoverride

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

| 标志 | 说明      |
| :- | :------ |
| /A | 清除所有覆盖。 |

## 示例

以下示例展示了使用 **xbgamestream** 的几种方式。

```text theme={null}

C:\Working Directory> xbgamestream status
Game Streaming Server Status:
Not Listening

C:\Working Directory> xbgamestream listconfigs
default    : xxxx Default
5.5mbps    : Max 1280 x 720 @5.5Mbps
12mbps     : Max 1920 x 1080 @12Mbps

C:\Working Directory> xbgamestream startlistening
Listening started

C:\Working Directory> xbgamestream stoplistening
Listening stopped

C:\Working Directory> xbgamestream startlistening /X:255.255.255.255
Listening started

C:\Working Directory> xbgamestream status /X:255.255.255.255
Game Streaming Server Status:
Listening
  - Protocol Version: ANY
  - Stream Configuration: default

C:\Working Directory> xbgamestream status /B /S /X:255.255.255.255
Listening

C:\Working Directory> xbgamestream enableremoteconnect accountEmail=xxxx@y.com
Remote connect enabled for account xxxx@y.com

C:\Working Directory> xbgamestream disableremoteconnect accountEmail=xxxx@y.com
Remote connect disabled for account xxxx@y.com

C:\Working Directory> xbgamestream remoteconnectstatus accountEmail=xxxx@y.com
Remote connect status for account xxxx@y.com: enabled

C:\Working Directory> xbgamestream setconfigoverride maxBitrate=12000000 minBitrate=6000000
Stream config override(s) set

C:\Working Directory> xbgamestream setconfigoverride minResolution=1080p
Stream config override(s) set

C:\Working Directory> xbgamestream clearconfigoverride maxBitrate minBitrate
Stream config override(s) cleared

C:\Working Directory> xbgamestream clearconfigoverride /A
Stream config override(s) cleared

C:\Working Directory> xbgamestream dumpconfigoverride
maxBitrate           : 12000000
minBitrate           : 6000000
minResolution        : 1080p
```

## 另请参阅

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

[命令行工具](/tools/tools-console/commandlinetools/commandlinetools)

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


## Related topics

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