> ## 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 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

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

## Voir aussi

[XAppCapture](/fr-CA/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)