コマンド
| コマンド | 説明 |
|---|---|
| listconfigs | コンソールがサポートするストリーミング ベース構成を一覧表示します。 |
| startlistening | コンソール上でダイレクト コネクト ストリーミング接続の待ち受けを開始します。 |
| stoplistening | コンソール上でダイレクト コネクト ストリーミング接続の待ち受けを停止します。 |
| status | コンソールのストリーミング状態を照会します。 |
| enableremoteconnect | 指定したユーザーに対してリモート コネクトを有効にします。この設定はデバイスの再起動後も保持されます。 |
| disableremoteconnect | 指定したユーザーに対してリモート コネクトを無効にします。この設定はデバイスの再起動後も保持されます。 |
| remoteconnectstatus | 指定したユーザーに対するリモート コネクトの状態を照会します。 |
| setconfigoverride | ベース ストリーム構成に対して 1 つ以上の設定オーバーライドを設定します。ダイレクト コネクトのベース ストリーム構成は、‘startlistening’ コマンドの ‘config’ パラメーターで指定します。リモート コネクトのベース ストリーム構成は XBOX services によって決定されます。設定オーバーライドは、ダイレクト コネクトでは ‘startlistening’ 時に、リモート コネクトでは新しいストリーム接続時に適用されます。オーバーライドは再起動間で保持されないため、必要な場合は再起動後に再設定する必要があります。 |
| clearconfigoverride | ’setconfigoverride’ コマンドで設定された 1 つ以上の設定オーバーライドをクリアします。 |
| dumpconfigoverride | ’setconfigoverride’ コマンドで設定されたすべての設定オーバーライドをコンソールに書き出します。 |
| /LC | ロケール コードを指定します。既定のロケール コードを上書きするために使用します。 |
グローバル フラグ
次の表のフラグは、すべてのコマンドに適用されます。| 列 1 |
|---|
| xbgamestream [/X[:address] [+accesskey] ] |
| フラグ | 説明 |
|---|---|
| /X[:address] [+accesskey] | - このオプションを使用すると、既定のコンソールを変更せずに、対象コンソールのホスト名またはアドレス（コンソール上に Tools IP として表示）を指定できます。コンソールにホスト名を設定する方法の詳細については、コンソールの IP アドレスにホスト名を設定する を参照してください。 - このオプションを使用しない場合は、既定のコンソール（以前に 接続 (xbconnect.exe) で設定されたもの）が使用されます。 - accesskey 文字列を使用して、アクセス キーを持つユーザーだけにコンソールへのアクセスを許可します。 - xbconfig accesskey=your-key コマンドでアクセス キーを設定し、コンソールを再起動してアクセス キーを有効にします。 - アクセス キーが設定されているコンソールにアクセスするには、コンソールの IP アドレスまたはホスト名の後にプラス記号 (+) とアクセス キーを付けます。 - xbconnect で既定のコンソールを設定する際にアクセス キーを指定した場合、そのアクセス キーは既定のコンソールのアドレスの一部として保存されます。 - アクセス キーの詳細については、xbconfig accesskey を参照してください。 - /X にアドレスと共に、またはそれ単独で /title を付加すると、実行中の排他アプリから見えるパーティション マッピングが使用されます。たとえば、/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