> ## 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 y difusión

> Game DVR y difusión

El Microsoft Game Development Kit (GDK) incluye un conjunto de API para las notificaciones de difusión que muestran
la interfaz de usuario de difusión, agregan metadatos a capturas de pantalla, clips de vídeo y
difusiones, y capturan capturas de pantalla y vídeo de diagnóstico. Las notificaciones de difusión
proporcionan información sobre la canalización de difusión. La interfaz de usuario de difusión pone al usuario en control del inicio y la detención de una
difusión. Agregar metadatos facilita la búsqueda de grabaciones, como agregar el nombre de un mapa, un nivel del juego o cualquier cosa sobre ese momento específico que se capturó. Combinadas, estas API le proporcionan un mejor
control y visibilidad sobre sus capturas de pantalla, clips de vídeo y difusiones.

## Notificaciones de difusión e interfaz de usuario

`XAppBroadcastGetStatus` muestra actualizaciones sobre el estado de la difusión. Use este método para determinar si una difusión puede comenzar. Muchos factores intervienen a la hora de determinar si una difusión puede comenzar, como asegurarse de que el recurso de captura esté disponible, si el juego permite la difusión, o si el usuario y/o el sistema no han deshabilitado la difusión. Si todos los miembros
de la estructura `XAppBroadcastStatus` (excepto `canStartBroadcast`) devuelven
`false`, `canStartBroadcast` devuelve `true`. Si una difusión puede comenzar, llame a `XAppBroadcastShowUI` para mostrar la interfaz de usuario de difusión para el
usuario actual. Posteriormente, el usuario debe iniciar manualmente la difusión. `XAppBroadcastIsAppBroadcasting` se usa para determinar si la
aplicación actual está difundiendo. `XAppBroadcastUnregisterIsAppBroadcasting` se
usa para anular el registro de los eventos de cambio del estado de la difusión.

## Adición de metadatos a una captura de pantalla, un clip de vídeo y una difusión

Se usan varias API para agregar y administrar los metadatos adjuntos a una
captura de pantalla, un clip de vídeo o una difusión. Agregar metadatos es opcional. Sin embargo,
facilita que un usuario encuentre la grabación que desea. Los metadatos pueden
adoptar muchas formas, como cadenas, enteros o valores double. El sistema asigna espacio de almacenamiento para los elementos de metadatos. Si el espacio asignado se agota, `AppCaptureMetatPriority` se usa para determinar las prioridades relativas
de los elementos de metadatos almacenados y el orden en que se purgan los metadatos para liberar espacio.

## Chat de voz

El chat de voz debe considerarse contenido generado por el usuario que puede contener información de identificación personal u otros datos potencialmente confidenciales. Por este motivo, la voz renderizada de un usuario en el chat del juego nunca debe incluirse en ningún clip grabado ni en capturas del juego. Esto se puede hacer asignando la categoría de audio adecuada a la secuencia de renderizado que contiene la voz del usuario, es decir, `AudioCategory_GameChat`. Esto etiqueta la secuencia en consecuencia para que el sistema sepa que debe omitir esta secuencia de audio al capturar clips de Game DVR.

## Capturas de pantalla y clips de vídeo de diagnóstico

Con estas API del Microsoft Game Development Kit (GDK), puede capturar capturas de pantalla y clips de vídeo
con fines de diagnóstico. Tenga en cuenta que estas API de diagnóstico solo están disponibles en los Development Kits. Llamar a estas API en una consola comercial produce un error inmediato. Las capturas de pantalla y los clips de vídeo capturados van a la
partición local del juego y no al almacenamiento habitual del usuario. Si el juego se
ejecuta en alto rango dinámico (HDR), el autor de la llamada puede especificar si desea capturar una captura de pantalla de rango dinámico estándar (SDR),
una captura de pantalla HDR o ambas. Después de grabar una
captura de pantalla, la estructura resultante contiene información de ruta de acceso
sobre la ubicación de los archivos de capturas de pantalla. Para los clips de vídeo,
según la configuración de Game DVR del usuario, se puede devolver un vídeo codificado en H264 (Advanced Video Coding (AVC))
o un vídeo codificado en H265 (High Efficiency Video Coding (HEVC)). La estructura resultante
también incluye información como la hora de inicio, la duración, y el ancho y alto.

## Capturas de pantalla normales

Una novedad del Microsoft Game Development Kit (GDK) es la capacidad de capturar capturas de pantalla normales. Las capturas de pantalla resultantes se almacenan en el almacenamiento normal del usuario para
capturas de pantalla. Además, una notificación del sistema indica que se capturó una
captura de pantalla. Dado que las capturas de pantalla se almacenan en una partición independiente que
no es directamente accesible desde la partición del juego, debe usar las API de secuencia
de apertura/lectura/cierre proporcionadas para acceder a las capturas de pantalla grabadas. Tenga en cuenta
que si el juego se ejecuta en HDR, se devuelven las rutas de acceso tanto de la versión SDR como de
la versión HDR de las capturas de pantalla.

## Documentación de referencia de la API

* [Xappcapture (contenido de la API)](/reference/system/xappcapture/xappcapture_members)

## Consulte también

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


## Related topics

- [XR-007 Juego entre redes — Implementación multijugador](/es/publishing/certification/xr/xr-007-multiplayer.md)
- [Ejemplo de implementación de multijugador entre redes](/es/services/xbox-services/multiplayer/concepts/live-console-xr007-multiplayer-example.md)
- [XR-007 Juego entre redes — Ejemplo de implementación de MMO](/es/publishing/certification/xr/xr-007-mmo.md)
- [Ejemplo de implementación de multijugador entre redes: MMO](/es/services/xbox-services/multiplayer/concepts/live-console-xr007-mmo-example.md)
- [Información general sobre el audio](/es/build/console-features/audio/overviews/audio.md)
