Commandes
| Commande | Description |
|---|---|
| listconfigs | Répertorie les configurations de streaming de base prises en charge par la console. |
| startlistening | Commence l’écoute des connexions de streaming en connexion directe sur la console. |
| stoplistening | Arrête l’écoute des connexions de streaming en connexion directe sur la console. |
| status | Interroge l’état du streaming de la console. |
| enableremoteconnect | Active la connexion à distance pour l’utilisateur spécifié. Ce paramètre est conservé après le redémarrage de l’appareil. |
| disableremoteconnect | Désactive la connexion à distance pour l’utilisateur spécifié. Ce paramètre est conservé après le redémarrage de l’appareil. |
| remoteconnectstatus | Interroge l’état de la connexion à distance pour l’utilisateur spécifié. |
| setconfigoverride | Définit un ou plusieurs remplacements de paramètres de la configuration de flux de base. La configuration de flux de base pour la connexion directe est spécifiée par le paramètre ‘config’ de la commande ‘startlistening’. La configuration de flux de base pour la connexion à distance est déterminée par les services XBOX. Les remplacements de paramètres sont appliqués lors de ‘startlistening’ pour la connexion directe et lors des nouvelles connexions de flux pour la connexion à distance. Les remplacements ne sont pas conservés après un redémarrage et doivent être redéfinis après le redémarrage si nécessaire. |
| clearconfigoverride | Efface un ou plusieurs remplacements de paramètres définis avec la commande ‘setconfigoverride’. |
| dumpconfigoverride | Écrit tous les remplacements de paramètres définis à l’aide de la commande ‘setconfigoverride’ sur la console. |
| /LC | Spécifiez le code de paramètres régionaux. Permet de remplacer le code de paramètres régionaux par défaut |
Indicateurs globaux
Les indicateurs du tableau suivant s’appliquent à toutes les commandes.| Colonne 1 |
|---|
| xbgamestream [/X[:address] [+accesskey] ] |
| Indicateur | Description |
|---|---|
| /X[:address] [+accesskey] | - Utilisez cette option pour spécifier le nom d’hôte ou l’adresse (affichée en tant que Tools IP sur la console) d’une console cible sans modifier la console par défaut. Pour plus d’informations sur la définition d’un nom d’hôte pour une console, consultez Définir un nom d’hôte pour l’adresse IP de la console. - Si vous n’utilisez pas cette option, la console par défaut (définie précédemment à l’aide de Connexion (xbconnect.exe)) est utilisée. - Utilisez la chaîne accesskey pour limiter l’accès à la console aux seules personnes qui disposent de la clé d’accès. - Définissez la clé d’accès à l’aide de la commande xbconfig accesskey=your-key, puis redémarrez votre console pour que la clé d’accès prenne effet. - Pour accéder à une console configurée avec une clé d’accès, ajoutez un signe plus (+) suivi de la clé d’accès après l’adresse IP ou le nom d’hôte de la console. - Si une clé d’accès est fournie lors de la définition de la console par défaut avec xbconnect, la clé d’accès est stockée dans l’adresse de la console par défaut. - Pour plus d’informations sur les clés d’accès, consultez xbconfig accesskey. - Si vous ajoutez /title à /X, après l’adresse ou seul, c’est le mappage de partitions vu par une application exclusive en cours d’exécution qui est utilisé. Par exemple, la spécification de /X/title xd: donne accès à la partition du lecteur temporaire de la console par défaut visible par les applications exclusives en cours d’exécution. |
Détails des commandes
startlistening
Pour une compatibilité optimale, il est recommandé de ne pas définir
version ni config| Paramètre | Description |
|---|---|
| version | Paramètre facultatif qui spécifie la version du protocole à utiliser. La valeur par défaut est la dernière version du protocole prise en charge par la console. |
| config | Paramètre facultatif permettant de spécifier la configuration de flux à utiliser. La valeur par défaut est la configuration au débit le plus élevé prise en charge par le kit de développement ciblé. |
status
| Indicateur | Description |
|---|---|
| /B | Spécifie le format brut. Lorsque cette option est activée, la commande status affiche uniquement une sortie brute. Le mode brut doit être utilisé avec au moins un autre indicateur précisant les données d’état que vous souhaitez récupérer (par exemple, /S). |
| /S | Spécifie l’état du streaming uniquement. Lorsque cette option est activée, la commande status affiche uniquement l’état du streaming de la console. |
enableremoteconnect
| Paramètre | Description |
|---|---|
| accountEmail | Spécifie le compte de messagerie pour lequel la connexion à distance doit être activée. Notez que ce compte doit être actuellement connecté sur la XBOX pour activer la connexion à distance et doit être utilisé pour se connecter au client de streaming. |
disableremoteconnect
| Paramètre | Description |
|---|---|
| accountEmail | Spécifie le compte de messagerie pour lequel la connexion à distance doit être désactivée. Notez qu’il doit s’agir d’un compte avec lequel une connexion a déjà été effectuée. |
remoteconnectstatus
| Paramètre | Description |
|---|---|
| accountEmail | Spécifie le compte de messagerie dont l’état de la connexion à distance doit être récupéré. |
setconfigoverride
| Paramètre | Description |
|---|---|
| allowDirectCapture | Booléen facultatif qui active ou désactive la capture directe. Valeur par défaut : true. |
| maxBitrate | Paramètre facultatif qui remplace le débit maximal du flux. Exemple de valeur : 12000000. |
| minBitrate | Paramètre facultatif qui remplace le débit minimal du flux. Exemple de valeur : 6000000. |
| maxResolution | Paramètre facultatif qui remplace la résolution maximale suggérée du flux vidéo. Exemples de valeurs : 720p, 1080p. |
| minResolution | Paramètre facultatif qui remplace la résolution minimale suggérée du flux vidéo. Exemples de valeurs : 720p, 1080p. |
clearconfigoverride
| Paramètre | Description |
|---|---|
| allowDirectCapture | Paramètre facultatif permettant d’effacer le remplacement de la capture directe. |
| maxBitrate | Paramètre facultatif permettant d’effacer le remplacement du débit maximal. |
| minBitrate | Paramètre facultatif permettant d’effacer le remplacement du débit minimal. |
| maxResolution | Paramètre facultatif permettant d’effacer le remplacement de la résolution maximale. |
| minResolution | Paramètre facultatif permettant d’effacer le remplacement de la résolution minimale. |
| Indicateur | Description |
|---|---|
| /A | Efface tous les remplacements. |
Exemples
Les exemples suivants présentent quelques-unes des façons d’utiliser 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