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, comme les téléphones, les tablettes et d’autres appareils. Cela contribue à offrir une expérience plus riche sur tous les appareils. XGameStreamingGetDisplayDetails et XGameStreamingSetResolution ont été introduites pour vous permettre de faire passer votre diffusion des proportions 16:9 de la XBOX à des proportions qui correspondent à de nombreux appareils différents, comme 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 ordinaire par rapport à une tablette ou à un téléphone en mode portrait dans l’environnement de diffusion en continu, 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 et XGameStreamingSetResolution En revanche, 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 régler les proportions à 4:3. Remarquez que les espaces ont disparu 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é. Ces détails peuvent servir à prendre des décisions éclairées, comme les proportions personnalisées à utiliser pour le rendu ou 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 la 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 de la diffusion. 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.
 Veuillez tenir compte du fait que, même si ces API existeront sur les consoles de salon, elles ne permettront d’utiliser que des résolutions standard afin de maintenir la compatibilité avec les téléviseurs (elles seront donc sans effet).

​
Comment utiliser correctement les API

  1. Connecter une diffusion
Si vous n’avez jamais diffusé votre jeu en continu, veuillez suivre les instructions ici : Prérequis pour les tests de diffusion de jeux en continu
  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 s’offrent à vous, 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 vous limiter aux résolutions comprises dans les limites maxWidth, maxHeight et maxPixels.
  3. Définir la résolution de la diffusion Appelez XGameStreamingSetResolution pour faire passer la résolution de diffusion à votre nouvelle résolution de rendu. Il est préférable de l’appeler en réponse à une action de l’utilisateur, comme le début de la diffusion, 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, la diffusion pourrait être mise à 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 de diffusion prend du temps, utilise des ressources limitées et a des effets visibles pour 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 entraînera un bref étirement. Cette API n’est PAS sécuritaire en temps réel.
  4. Commencer le rendu Le rendu de résolutions personnalisées doit se faire de la même façon que le rendu d’autres résolutions : définissez la taille de votre fenêtre et configurez votre tampon d’arrière-plan avec la nouvelle résolution.
Si vous souhaitez l’essayer, veuillez consulter nos exemples ici.

​
Voir aussi

Pratiques exemplaires pour la résolution personnalisée Tests avec la résolution personnalisée (rubrique sous NDA)
Last modified on October 6, 2026