> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Vue d'ensemble de la résolution personnalisée > Utilisez XGameStreamingSetResolution pour adapter la sortie de XBOX Game Streaming aux proportions des téléphones, des tablettes et d'autres clients plutôt qu'au format 16:9. 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](/fr-CA/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails) et [XGameStreamingSetResolution](/fr-CA/reference/system/xgamestreaming/functions/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](/fr-CA/build/core-features/common/game-streaming/game-streaming-directcapture-overview). 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](/fr-CA/build/core-features/common/game-streaming/game-streaming-stream-your-game) 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](https://github.com/microsoft/Xbox-GDK-Samples/tree/main/Samples/xCloud/CustomResolution). ## Voir aussi [Pratiques exemplaires pour la résolution personnalisée](/fr-CA/build/core-features/common/game-streaming/game-streaming-custom-resolution-best-practices) [Tests avec la résolution personnalisée (rubrique sous NDA)](/fr-CA/build/core-features/common/game-streaming/game-streaming-testing-custom-resolution) ## Related topics - [Vue d'ensemble de XBOX Series X|S](/fr/paths/series-xs/overview.md) - [Vue d'ensemble de l'accessibilité GDK](/fr/build/game-principles/accessibility/accessibility-overview.md) - [Vue d'ensemble de Windows & ROG XBOX Ally](/fr/paths/windows/overview.md) - [Vue d'ensemble de Godot et des moteurs communautaires](/fr/paths/community-engines/overview.md) - [Vue d'ensemble de Play Anywhere (console + PC)](/fr/paths/play-anywhere/overview.md)