> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Game DVR et diffusion

> Game DVR et diffusion

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

* [Xappcapture (contenu de l'API)](/fr/reference/system/xappcapture/xappcapture_members)

## Voir aussi

[XAppCapture](/fr/reference/system/xappcapture/xappcapture_members)


## Related topics

- [Exemples du GDK](/fr-CA/home/setup-install/samples.md)
- [Game DVR and broadcasting](/build/console-features/game-dvr/gamedvr-broadcast.md)
- [Game DVR y difusión](/es/build/console-features/game-dvr/gamedvr-broadcast.md)
- [Aperçu de XBOX Series X|S](/fr-CA/paths/series-xs/overview.md)
- [Exigences pour les titres bêta et XBOX Game Preview](/fr-CA/publishing/certification/cert-beta-game-preview.md)