Skip to main content
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

Consulte también

XAppCapture
Última modificación el 28 de agosto de 2026