XGameStreamingShowTouchControlLayout
Demande à tous les appareils clients de diffusion en continu 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 diffusion en continu. 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 sera affiché.
Toute chaîne qui ne correspond pas à un ID de disposition des commandes tactiles du titre ne modifiera 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 diffusion en continu 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 continu, ou s’il le diffuse vers un appareil qui ne prend pas en charge le tactile, cette fonction ne fait rien. Si le joueur utilise une manette physique plutôt que les commandes tactiles, cette fonction ne forcera pas l’affichage 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 à 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éterminera 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; cette fonction ne doit donc pas être appelée à chaque image. 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é lorsque XGameStreamingShowTouchControlLayout est appelée, un client qui se connecte par la suite recevra la disposition de commandes tactiles demandée le plus récemment.
Si votre jeu souhaite afficher la disposition des commandes tactiles sur un appareil client précis de diffusion en continu connecté, 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
