XGameStreamingShowTouchControlLayout
Demande à tous les appareils clients de streaming connectés d’afficher une disposition tactile spécifiée.Syntaxe
Paramètres
layout _In_opt_z_Type : char* Nom de la disposition des commandes tactiles à afficher, ou
nullptr pour afficher la disposition standard de la manette XBOX.
ID de la disposition des commandes tactiles qui doit être affichée sur l’appareil client de streaming. Les ID de disposition sont propres au titre et correspondent aux ID des dispositions fournies au service XBOX Game Streaming dans le cadre du Touch Adaptation Kit. Cette chaîne doit être encodée en UTF-8.
Si nullptr est fourni, l’ensemble par défaut de commandes tactiles est affiché.
Toute chaîne qui ne correspond pas à un ID de disposition de commandes tactiles du titre ne modifie pas l’état des commandes tactiles sur l’appareil client. L’application Content Test Application peut fournir un diagnostic dans ces cas.
Valeur de retour
Type : voidRemarques
Cette API demande à tous les clients de streaming de jeu actuels d’afficher une disposition de commandes tactiles spécifique sur l’appareil client du joueur. Si le joueur ne diffuse pas le jeu en streaming, ou s’il le diffuse sur un appareil où l’entrée tactile n’est pas activée, cette fonction ne fait rien. Si le joueur utilise une manette physique au lieu des commandes tactiles, cette fonction ne force pas l’apparition des commandes tactiles sur son appareil. Le client utilisera plutôt la dernière disposition demandée la prochaine fois que le joueur commencera à utiliser les commandes tactiles. Vous pouvez considérer cette fonction comme une indication donnée à l’appareil client, qui lui indique quelle disposition de commandes tactiles est la plus appropriée pour l’état actuel du jeu si le joueur utilise les commandes tactiles. L’appareil client détermine ensuite le meilleur moment pour afficher ces commandes à l’écran du joueur. Chaque appel àXGameStreamingShowTouchControlLayout entraîne l’envoi d’un message sur le réseau ; il ne doit donc pas être appelé à chaque frame. Appelez plutôt cette API uniquement lorsque votre jeu doit passer d’une disposition de commandes tactiles à une autre.
Si aucun appareil client n’est connecté lors de l’appel à XGameStreamingShowTouchControlLayout, le client qui se connectera recevra la dernière disposition de commandes tactiles demandée.
Si votre jeu souhaite afficher la disposition des commandes tactiles sur un appareil client de streaming connecté spécifique, envisagez plutôt d’utiliser XGameStreamingShowTouchControlLayoutOnClient.
Exemples
Configuration requise
En-tête : xgamestreaming.h Bibliothèque : xgameruntime.lib Plateformes prises en charge : Windows, consoles de la famille XBOX One et consoles XBOX SeriesVoir aussi
XGameStreamingHideTouchControlsXGameStreamingShowTouchControlLayoutOnClient
XGameStreaming
