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 fournissent des informations sur le 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 toute information concernant le moment précis qui a été 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 de diffusion et interface utilisateur

XAppBroadcastGetStatus affiche les mises à jour de 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 la disponibilité de la ressource de capture, l’autorisation de la diffusion par le jeu, ou le fait que l’utilisateur et/ou le système n’ait pas désactivé la diffusion. Si tous les membres de la structure XAppBroadcastStatus (à l’exception de canStartBroadcast) retournent false, canStartBroadcast retourne 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 cours de diffusion. XAppBroadcastUnregisterIsAppBroadcasting permet d’annuler l’inscription aux événements de modification de l’état de la diffusion.

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

Plusieurs API permettent d’ajouter et de gérer les métadonnées associées à une capture d’écran, un clip vidéo ou une diffusion. L’ajout de métadonnées est facultatif. Toutefois, il permet à l’utilisateur de trouver plus facilement l’enregistrement qu’il recherche. Les métadonnées peuvent prendre de nombreuses formes, telles que des chaînes, des entiers ou des doubles. Le système alloue de l’espace de stockage pour les éléments de métadonnées. Si l’espace alloué devient insuffisant, AppCaptureMetatPriority est utilisé pour 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.

​
Conversation vocale

La conversation vocale doit être considérée comme du contenu généré par l’utilisateur, susceptible de contenir des informations d’identification personnelle ou d’autres données potentiellement sensibles. Pour cette raison, la voix d’un utilisateur restituée dans la conversation du jeu ne doit jamais être incluse dans les clips enregistrés ou les captures de jeu. Pour ce faire, attribuez la catégorie audio appropriée, à savoir AudioCategory_GameChat, au flux de rendu contenant la voix de l’utilisateur. Le flux est ainsi balisé afin que le système sache qu’il doit ignorer ce flux audio lors des captures de clips Game DVR.

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

Avec 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 kits de développement. L’appel de ces API sur une console commerciale entraîne un échec immédiat. Les captures d’écran et clips vidéo capturés sont placés dans la partition locale du jeu et non dans le stockage utilisateur habituel. Si le jeu s’exécute en plage dynamique élevée (HDR), l’appelant peut indiquer s’il souhaite capturer une capture d’écran en plage dynamique standard (SDR), une capture d’écran HDR ou les deux. Après l’enregistrement d’une capture d’écran, la structure résultante contient des informations de chemin 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 retournée. La structure résultante inclut également des informations telles que 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 obtenues 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. Étant donné que les captures d’écran sont stockées dans une partition distincte qui n’est pas directement accessible depuis 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 retournés.

​
Documentation de référence des API

​
Voir aussi

XAppCapture
Last modified on October 6, 2026