命令
| 命令 | 说明 |
|---|---|
| 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 地址设置主机名。 - 如果不使用此选项,则使用默认主机(先前由 Connect (xbconnect.exe) 设置)。 - 使用 accesskey 字符串仅向持有访问密钥的人员提供主机访问权限。 - 通过命令 xbconfig accesskey=your-key 设置访问密钥,然后重启主机使访问密钥生效。 - 若要访问配置了访问密钥的主机,请在主机的 IP 地址或主机名后加上加号 (+) 和访问密钥。 - 如果在通过 xbconnect 设置默认主机时提供了访问密钥,则该访问密钥将作为默认主机地址的一部分存储。 - 有关访问密钥的详细信息,请参阅 xbconfig accesskey。 - 如果将 /title 附加到 /X(在地址之后或单独使用),则会使用正在运行的独占应用所看到的分区映射。例如,指定 /X/title xd: 将访问对正在运行的独占应用可见的默认主机暂存驱动器分区。 |
命令详细信息
startlistening
为获得最佳兼容性,建议不要设置
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 的几种方式。
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