XGameStreamingGetTouchBundleVersion
Obtient la version du bundle d’adaptation tactile actuellement utilisé sur l’appareil spécifié.Syntaxe
Paramètres
client _In_Type : XGameStreamingClientId Client de streaming interrogé. version _Out_opt_
Type : XVersion* Numéro de version du bundle actuellement utilisé sur le client spécifié. Si aucun numéro de version n’est spécifié dans le bundle, 0.0.0.0 est retourné. versionNameSize _In_
Type : size_t Taille maximale en octets du
versionName à retourner. La taille à spécifier peut être obtenue en appelant XGameStreamingGetTouchBundleVersionNameSize.
versionName _Out_writes_opt_z_Type : char* Nom de version du bundle actuellement utilisé sur le client spécifié. Si aucun nom de version n’est spécifié dans le bundle,
null est retourné.
Valeur de retour
Type : HRESULT Retourne S_OK en cas de réussite ; sinon, retourne un code d’erreur.Erreurs potentielles
Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur.
Remarques
Les dispositions tactiles présentées au joueur pendant le streaming de jeux utilisent des dispositions prédéfinies chargées sur les serveurs de Microsoft dans le cadre d’un bundle d’adaptation tactile.XGameStreamingGetTouchBundleVersion permet au jeu de prendre des décisions au moment de l’exécution en fonction de l’ensemble de contrôles tactiles utilisés sur un client particulier. Voici quelques exemples d’utilisation :
- Retirer un élément du HUD si le joueur utilise l’écran tactile et que l’élément est disponible via les contrôles tactiles superposés.
- Choisir les indications graphiques à afficher dans le jeu en fonction des dispositions tactiles qui seront affichées.
version est unique pour chaque version chargée sur le service. Chaque mise à jour nécessite un nouveau numéro de version.
Le versionName peut servir à fournir une version sémantique (par exemple, il s’agit d’un ensemble de dispositions qui prennent en charge le DLC2) plutôt que de dépendre d’un numéro de version spécifique. Par exemple, si les numéros de version sont attribués automatiquement par votre système de génération, il peut être difficile pour le code du jeu de connaître le numéro de version exact des bundles d’adaptation tactile qui apparaîtront au moment de l’exécution. Pour permettre au code de détecter la présence d’un bundle sans devoir connaître sa version exacte, vous pouvez choisir d’utiliser un nom de version au lieu d’effectuer des comparaisons basées sur un numéro de version.
Exemple
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
XGameStreamingXGameStreamingGetTouchBundleVersionNameSize
