Skip to main content
XBOX Game Streaming vous permet de personnaliser la résolution de vos jeux en fonction de la résolution de sortie d’appareils autres que les téléviseurs, tels que les téléphones, les tablettes et d’autres appareils. Cela contribue à offrir une expérience plus riche sur l’ensemble des appareils. XGameStreamingGetDisplayDetails et XGameStreamingSetResolution ont été introduites pour vous permettre de faire passer votre flux du rapport d’aspect 16:9 de la XBOX à un rapport d’aspect adapté à de nombreux appareils différents, tels que les téléphones, les tablettes, etc. Par exemple, l’image ci-dessous illustre la façon dont un jeu XBOX s’affiche sur un écran de téléviseur 16:9 classique par rapport à une tablette ou à un téléphone en mode portrait dans l’environnement de streaming, sans aucune modification. Le logo XBOX sur une tablette en mode paysage, avec des bandes noires en haut et en bas Le logo XBOX sur une tablette en mode portrait, avec des bandes noires en haut et en bas Figure 1. Rendu du jeu sur différents appareils sans XGameStreamingGetDisplayDetails ni XGameStreamingSetResolution À l’inverse, l’image suivante illustre la façon dont le même jeu s’affiche sur différents appareils lorsque les API ci-dessus sont utilisées pour définir le rapport d’aspect sur 4:3. Notez la disparition des espaces lors du rendu sur la tablette. Le logo XBOX remplissant l'écran d'une tablette en mode paysage Le logo XBOX remplissant l'écran d'un téléviseur 16:9 Figure 2. Rendu du jeu sur différents appareils avec XGameStreamingGetDisplayDetails et XGameStreamingSetResolution XGameStreamingGetDisplayDetails renvoie les détails d’affichage du client spécifié. Cela permet de prendre des décisions éclairées, par exemple sur les rapports d’aspect personnalisés à utiliser pour le rendu ou sur la résolution à utiliser pour activer DirectCapture. DirectCapture a été conçu pour réduire au minimum la latence du serveur lorsque le titre présente une image compatible, ce qui élimine environ 16 à 72 millisecondes de latence. Cette réduction de latence varie d’un jeu à l’autre, car elle dépend de la sortie de rendu du jeu. XGameStreamingSetResolution doit être utilisée une fois que le titre a choisi une résolution. Cette API définit la résolution du flux. Les API exposent les exigences de DirectCapture et la résolution préférée du client afin que différents titres puissent les adopter.
Les exigences minimales et maximales ainsi que les autres règles de DirectCapture doivent être respectées.
 Notez que, bien que ces API existent sur les consoles de salon, elles n’autorisent que les résolutions standard afin de préserver la compatibilité avec les téléviseurs (ce qui les rend de fait sans effet).

​
Comment utiliser correctement les API

  1. Connecter un flux
Si vous n’avez encore jamais diffusé votre jeu en streaming, suivez les instructions disponibles ici : Prérequis pour les tests de streaming de jeux
  1. Obtenir les détails de l’affichage Pour obtenir les détails de l’affichage, les jeux peuvent appeler XGameStreamingGetDisplayDetails, qui renvoie les détails d’affichage du client spécifié.
  2. Choisir une résolution Cela dépend du jeu. Plusieurs options sont possibles, par exemple : a. Utiliser preferredWidth/preferredHeight comme meilleure correspondance. b. Utiliser XGameStreamingDisplayDetails pour trouver la correspondance la plus proche parmi un ensemble préconfiguré de résolutions testées. c. Activer le sélecteur de résolution de la version PC du jeu pour permettre au joueur de choisir la résolution. Envisagez de limiter le choix aux résolutions comprises dans les limites maxWidth, maxHeight et maxPixels.
  3. Définir la résolution du flux Appelez XGameStreamingSetResolution pour remplacer la résolution du streaming par votre nouvelle résolution de rendu. Il est préférable de l’appeler en réponse à une action de l’utilisateur, telle que le début du flux, un redimensionnement, la rotation de l’appareil, etc. Notez que cette résolution n’a pas besoin de correspondre à preferredWidth/preferredHeight. Si elle ne correspond pas, le flux peut être mis à l’échelle pour s’adapter à l’écran, avec des bandes noires horizontales ou verticales ajoutées pour remplir l’espace restant.
    [!NOTE] Il est important de noter que la définition de la résolution du flux prend du temps, utilise des ressources limitées et a des effets visibles par le joueur ; cette API ne doit donc être appelée que rarement, par exemple lorsqu’un nouveau client se connecte ou modifie sa résolution préférée.
    Appeler XGameStreamingSetResolution plus d’une fois toutes les 200 ms provoque un bref étirement de l’image. Cette API n’est PAS sûre en temps réel.
  4. Démarrer le rendu Le rendu de résolutions personnalisées doit être identique au rendu d’autres résolutions : définissez la taille de votre fenêtre et configurez votre backbuffer avec la nouvelle résolution.
Si vous voulez l’essayer, suivez nos exemples ici.

​
Voir aussi

Bonnes pratiques relatives à la résolution personnalisée Test avec la résolution personnalisée (rubrique sous NDA)
Last modified on October 6, 2026