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

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

## 命令详细信息

### startlistening

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

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

### status

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

### enableremoteconnect

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

### disableremoteconnect

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

### remoteconnectstatus

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

### setconfigoverride

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

### 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)](https://docs.xbox.com/zh-CN/tools/tools-console/console_commandlinetools/wdgamestream.md)

[命令行工具](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/commandlinetools.md)

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


## Related topics

- [管理游戏流式传输 (wdgamestream.exe)](https://docs.xbox.com/zh-CN/tools/tools-console/console_commandlinetools/wdgamestream.md)
- [流式传输页面 (Dev Home)](https://docs.xbox.com/zh-CN/tools/tools-console/devhome/devhome-streaming.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)
- [基于主机的命令行工具](https://docs.xbox.com/zh-CN/tools/tools-console/console_commandlinetools/consolecommandlinetools.md)
