XGameStreamingShowTouchControlLayoutOnClient
Affiche l’ensemble de commandes tactiles demandé sur un seul client.Syntaxe
Paramètres
client _In_Type : XGameStreamingClientId Appareil client de streaming sur lequel afficher les commandes tactiles. layout _In_opt_z_
Type : char* Nom de la disposition des commandes tactiles à afficher, ou nullptr pour afficher la disposition par défaut. 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 à 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, qui reste inchangé. L’application Content Test Application peut fournir un diagnostic dans ces cas.
Valeur de retour
Type : voidRemarques
Cette API demande au client de streaming de jeu spécifié 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 si l’entrée tactile n’est pas activée sur le client de streaming, 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 àXGameStreamingShowTouchControlLayoutOnClient 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 votre jeu souhaite afficher la disposition des commandes tactiles sur tous les appareils clients de streaming connectés, envisagez plutôt d’utiliser XGameStreamingShowTouchControlLayout.
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
XGameStreamingHideTouchControlsOnClientXGameStreamingShowTouchControlLayout
XGameStreaming
