Skip to main content
Le Microsoft Game Development Kit (GDK) comprend un ensemble d’API pour les notifications de diffusion, l’affichage de l’interface utilisateur de diffusion, l’ajout de métadonnées aux captures d’écran, aux clips vidéo et aux diffusions, ainsi que la capture de captures d’écran et de vidéos de diagnostic. Les notifications de diffusion donnent un aperçu du pipeline de diffusion. L’interface utilisateur de diffusion permet à l’utilisateur de contrôler le démarrage et l’arrêt d’une diffusion. L’ajout de métadonnées facilite la recherche dans les enregistrements, par exemple en ajoutant le nom d’une carte, un niveau du jeu ou tout autre élément propre au moment capturé. Combinées, ces API vous offrent un meilleur contrôle et une meilleure visibilité sur vos captures d’écran, vos clips vidéo et vos diffusions.

​
Notifications et interface utilisateur de diffusion

XAppBroadcastGetStatus affiche les mises à jour sur l’état de la diffusion. Utilisez cette méthode pour déterminer si une diffusion peut démarrer. De nombreux facteurs déterminent si une diffusion peut démarrer, par exemple s’assurer que la ressource de capture est disponible, que le jeu autorise la diffusion ou que l’utilisateur ou le système n’a pas désactivé la diffusion. Si tous les membres de la structure XAppBroadcastStatus (à part canStartBroadcast) renvoient false, canStartBroadcast renvoie true. Si une diffusion peut démarrer, appelez XAppBroadcastShowUI pour afficher l’interface utilisateur de diffusion pour l’utilisateur actuel. L’utilisateur doit ensuite lancer manuellement la diffusion. XAppBroadcastIsAppBroadcasting permet de déterminer si l’application actuelle est en train de diffuser. XAppBroadcastUnregisterIsAppBroadcasting permet d’annuler l’inscription aux événements de modification de l’état de diffusion.

​
Ajout de métadonnées à une capture d’écran, à un clip vidéo et à une diffusion

Plusieurs API servent à ajouter et à gérer les métadonnées jointes à une capture d’écran, à un clip vidéo ou à une diffusion. L’ajout de métadonnées est facultatif. Cependant, il permet à l’utilisateur de trouver plus facilement l’enregistrement qu’il souhaite. Les métadonnées peuvent prendre de nombreuses formes, comme des chaînes, des entiers ou des nombres doubles. Le système alloue de l’espace de stockage aux éléments de métadonnées. Si l’espace alloué devient insuffisant, AppCaptureMetatPriority permet de déterminer les priorités relatives des éléments de métadonnées stockés et l’ordre dans lequel les métadonnées sont purgées pour libérer de l’espace.

​
Clavardage vocal

Le clavardage vocal doit être considéré comme du contenu généré par l’utilisateur, qui peut contenir des informations d’identification personnelle ou d’autres données potentiellement sensibles. Par conséquent, la voix d’un utilisateur rendue dans le clavardage du jeu ne doit jamais être incluse dans les clips enregistrés ou les captures du jeu. Pour ce faire, attribuez la catégorie audio appropriée au flux de rendu contenant la voix de l’utilisateur, soit AudioCategory_GameChat. Cela étiquette le flux en conséquence afin que le système sache qu’il doit ignorer ce flux audio lors de la capture des clips Game DVR.

​
Captures d’écran et clips vidéo de diagnostic

Grâce à ces API du Microsoft Game Development Kit (GDK), vous pouvez capturer des captures d’écran et des clips vidéo à des fins de diagnostic. Notez que ces API de diagnostic ne sont disponibles que sur les trousses de développement. L’appel de ces API sur une console commerciale entraîne un échec immédiat. Les captures d’écran et les clips vidéo capturés sont placés dans la partition locale du jeu et non dans le stockage habituel de l’utilisateur. Si le jeu s’exécute en grande plage dynamique (HDR), l’appelant peut spécifier s’il faut capturer une capture d’écran en plage dynamique standard (SDR), une capture d’écran HDR ou les deux. Une fois qu’une capture d’écran est enregistrée, la structure résultante contient des informations sur l’emplacement des fichiers de capture d’écran. Pour les clips vidéo, selon le paramètre Game DVR de l’utilisateur, une vidéo encodée en H264 (Advanced Video Coding (AVC)) ou une vidéo encodée en H265 (High Efficiency Video Coding (HEVC)) peut être renvoyée. La structure résultante comprend aussi des informations comme l’heure de début, la durée, ainsi que la largeur et la hauteur.

​
Captures d’écran normales

Nouveauté du Microsoft Game Development Kit (GDK) : la possibilité de capturer des captures d’écran normales. Les captures d’écran résultantes sont stockées dans le stockage utilisateur normal des captures d’écran. De plus, une notification système indique qu’une capture d’écran a été effectuée. Comme les captures d’écran sont stockées dans une partition distincte qui n’est pas directement accessible à partir de la partition du jeu, vous devez utiliser les API de flux d’ouverture/lecture/fermeture fournies pour accéder aux captures d’écran enregistrées. Notez que si le jeu s’exécute en HDR, les chemins de la version SDR et de la version HDR des captures d’écran sont tous deux renvoyés.

​
Documentation de référence des API

​
Voir aussi

XAppCapture
Last modified on October 6, 2026