> ## 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.

# Considérations supplémentaires pour les appareils portables

> Directives supplémentaires pour les appareils portables portant sur la détection du mode station d'accueil, les entrées de manette garanties, la gestion de l'alimentation avec GetSystemPowerStatus et la taille de l'écran.

Cet article traite d'autres éléments à garder à l'esprit lorsque vous développez des jeux destinés à fonctionner efficacement sur des appareils portables. Ces considérations complètent les vérifications de [Optimiser les jeux GDK pour les appareils Windows portables](/fr-CA/build/gdk-and-engines/handheld/handheld-guidance).

## Comportement d'un appareil portable dans une station d'accueil

Certains appareils portables sont utilisés dans une station d'accueil. Bien qu'il n'existe pas d'API pour vérifier si l'appareil portable est dans une station d'accueil, un appareil en station d'accueil peut avoir un écran externe connecté. Vous pouvez vérifier la présence d'un écran externe à l'aide des API [EnumDisplayDevices](https://learn.microsoft.com/windows/win32/api/winuser/nf-winuser-enumdisplaydevicesa) et [EnumDisplaySettings](https://learn.microsoft.com/windows/win32/api/winuser/nf-winuser-enumdisplaysettingsa).

Lorsqu'un appareil portable est dans une station d'accueil, utilisez ces méthodes pour vérifier la présence d'écrans externes connectés :

* Vérifiez la présence de manettes supplémentaires. La manette intégrée de l'appareil portable est toujours disponible, mais l'utilisateur peut également connecter des manettes supplémentaires.
* Vérifiez la taille des écrans connectés.
* Les recommandations relatives au clavier virtuel demeurent, car la manette reste le principal mécanisme d'entrée.
* Certains joueurs peuvent connecter une souris et un clavier, comme ils le font sur les consoles.

## Entrées garanties

Bien que divers appareils de jeu portables puissent offrir des options d'entrée supplémentaires, les appareils portables disposent des entrées suivantes.

* Boutons A, B, X et Y
* Gâchette haute gauche et gâchette haute droite
* Gâchette gauche et gâchette droite
* Manette analogique gauche et manette analogique droite
* Croix directionnelle
* Bouton Menu
* Bouton Affichage

Vérifiez toujours toutes les manettes et tous les périphériques d'entrée connectés, que l'appareil soit dans une station d'accueil ou non. En station d'accueil, vérifiez également le bouton Affichage.

## Alimentation

Pour vérifier si l'appareil portable est alimenté par le secteur plutôt que par la pile, appelez la fonction [GetSystemPowerStatus](https://learn.microsoft.com/windows/win32/api/winbase/nf-winbase-getsystempowerstatus). Elle indique si l'appareil est alimenté par le secteur et fournit un résumé de l'état de charge de la pile (élevé, faible, critique ou en charge).

Tenez compte de l'effet de votre jeu sur l'autonomie de la pile de l'appareil, car la puissance requise par votre jeu n'est pas toujours évidente. Les recommandations d'économie d'énergie du [XBOX Sustainability Toolkit](https://aka.ms/SustainabilityToolkit) peuvent également s'appliquer aux appareils portables.

Maximisez les économies d'énergie en :

* Activant la synchronisation verticale (VSync) pour donner plus de temps d'inactivité au GPU et réduire la consommation d'énergie.
* Réduisant la résolution de rendu interne et en appliquant une passe de mise à l'échelle.
* Réduisant la fréquence d'images pour économiser de l'énergie. Remarque : Une fréquence d'images plus faible peut nuire à la jouabilité.
* Arrêtant le rendu du monde lorsque des menus ou des éléments d'interface utilisateur en plein écran apparaissent, ou lorsque le jeu est en pause.
* Mettant le jeu en pause lorsqu'une inactivité des entrées est détectée et que le joueur est inactif.

## Dimensions de l'écran

Bien que les différents appareils de jeu portables aient des résolutions d'écran variées, vous pouvez vous fier aux normes suivantes :

* La taille diagonale de l'écran est d'au moins 7 pouces (17,8 cm).
* L'écran a un rapport d'aspect de 16:9 ou de 16:10.

Appelez la fonction [GetIntegratedDisplaySize](https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getintegrateddisplaysize) pour obtenir la taille diagonale de l'écran intégré à l'appareil portable.

## Exemples de pratiques exemplaires pour l'expérience sur appareil portable

Pour en savoir plus sur la création et l'optimisation de votre jeu pour les appareils portables, Microsoft a publié deux exemples : un exemple natif en C++ et un exemple managé en C# pour Unity. Les deux proposent un ensemble similaire de pratiques exemplaires sur l'utilisation des API pour gérer l'expérience de votre jeu sur appareil portable.

* Déterminer si un appareil est un appareil portable.
* Déterminer si un appareil fonctionne sur pile, est en charge ou utilise une alimentation externe.
* Rechercher les propriétés propres à l'appareil, y compris les propriétés de l'écran intégré.
* Gérer les changements de PPP et mettre l'interface utilisateur à l'échelle en conséquence.
* Utiliser des claviers virtuels pour la saisie de texte.
* Rechercher les périphériques et les types de réseau.
* Déterminer la connectivité réseau et Bluetooth®.
* Gérer les entrées provenant de la manette, du clavier et de la souris.
* Déterminer la modalité d'entrée. Par exemple, identifier le périphérique d'entrée utilisé le plus récemment.

Microsoft met à jour ces exemples à mesure que Windows ajoute des améliorations profitables aux scénarios de jeu sur appareil portable et que les développeurs de jeux qui créent des jeux pour ces appareils fournissent leurs commentaires.

Pour obtenir ces exemples, consultez les ressources suivantes :

* Exemple natif en C++ : [Exemple C++ sur GitHub](https://aka.ms/hhexpsample).
* Exemple managé en C# pour Unity : [Exemple managé en C# pour Unity sur GitHub](https://aka.ms/hhexpsample_unity).


## Related topics

- [Exigences XBOX testées lors de la certification pour les jeux sur console XBOX](/fr-CA/publishing/certification/console-cert-tested-requirements.md)
- [XBOX Requirements pour les jeux XBOX](/fr/publishing/certification/xbox-requirements.md)
- [Étapes du test de validation des supports](/fr/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md)
- [Étapes de test de validation des supports](/fr-CA/publishing/game-publishing/concepts/certification/certification-media-validation-test-steps.md)
- [Informations supplémentaires](/fr/publishing/game-publishing/concepts/certification/certification-supplemental-info.md)
