> ## 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 rapports d'aspect des téléphones, tablettes et autres clients au lieu du 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, 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](/fr/reference/system/xgamestreaming/functions/xgamestreaminggetdisplaydetails) et [XGameStreamingSetResolution](/fr/reference/system/xgamestreaming/functions/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](/fr/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 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](/fr/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 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](https://github.com/microsoft/Xbox-GDK-Samples/tree/main/Samples/xCloud/CustomResolution). ## Voir aussi [Bonnes pratiques relatives à la résolution personnalisée](/fr/build/core-features/common/game-streaming/game-streaming-custom-resolution-best-practices) [Test avec la résolution personnalisée (rubrique sous NDA)](/fr/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)