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

# XAppCapture

> XAppCapture

# XAppCapture

XBOX y el escritorio incluyen experiencias nativas de difusión, cada una con sus propias reglas sobre qué aplicaciones puede difundir un usuario. Estas API permiten al desarrollador mostrar la interfaz de usuario de difusión, así como detectar cuándo el usuario está difundiendo. El desarrollador de la aplicación puede proporcionar eventos y estados de metadatos para guardarlos o difundirlos con el archivo o la secuencia de vídeo y audio capturados.

## Funciones

| Función                                                                                                                                        | Descripción                                                                                                                                                                                                                                                                     |
| ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [XAppBroadcastGetStatus](/reference/system/xappcapture/functions/xappbroadcastgetstatus)                                                       | Recupera el estado actual de la difusión para el dispositivo y la aplicación actual.                                                                                                                                                                                            |
| [XAppBroadcastIsAppBroadcasting](/reference/system/xappcapture/functions/xappbroadcastisappbroadcasting)                                       | Determina si la aplicación está difundiendo actualmente.                                                                                                                                                                                                                        |
| [XAppBroadcastMonitorCallback](/reference/system/xappcapture/functions/xappbroadcastmonitorcallback)                                           | Establece la función de devolución de llamada para [XAppBroadcastRegisterIsAppBroadcastingChanged](/reference/system/xappcapture/functions/xappbroadcastregisterisappbroadcastingchanged). La función establecida aquí se llamará cada vez que cambie el estado de la difusión. |
| [XAppBroadcastRegisterIsAppBroadcastingChanged](/reference/system/xappcapture/functions/xappbroadcastregisterisappbroadcastingchanged)         | Registra un controlador de eventos de cambio de estado de difusión de la aplicación.                                                                                                                                                                                            |
| [XAppBroadcastShowUI](/reference/system/xappcapture/functions/xappbroadcastshowui)                                                             | Muestra la interfaz de usuario de difusión al usuario de la aplicación para que pueda iniciar la actividad de difusión.                                                                                                                                                         |
| [XAppBroadcastUnregisterIsAppBroadcastingChanged](/reference/system/xappcapture/functions/xappbroadcastunregisterisappbroadcastingchanged)     | Quita un controlador de eventos de cambio de estado de difusión de la aplicación.                                                                                                                                                                                               |
| [XAppCaptureCancelUserRecord](/reference/system/xappcapture/functions/xappcapturecanceluserrecord)                                             | Detiene y elimina una grabación de usuario de GameDVR en curso, iniciada mediante [XAppCaptureStartUserRecord](/reference/system/xappcapture/functions/xappcapturestartuserrecord) y especificada por el identificador indicado.                                                |
| [XAppCaptureCloseLocalStream](/reference/system/xappcapture/functions/xappcapturecloselocalstream)                                             | Cierra y elimina la secuencia de grabación especificada.                                                                                                                                                                                                                        |
| [XAppCaptureCloseScreenshotStream](/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream)                                   | Cierra una secuencia de capturas de pantalla.                                                                                                                                                                                                                                   |
| [XAppCaptureDisableRecord](/reference/system/xappcapture/functions/xappcapturedisablerecord)                                                   | Deshabilita la grabación de vídeo para el jugador.                                                                                                                                                                                                                              |
| [XAppCaptureEnableRecord](/reference/system/xappcapture/functions/xappcaptureenablerecord)                                                     | Habilita la grabación o la captura de pantalla para el usuario actual.                                                                                                                                                                                                          |
| [XAppCaptureGetVideoCaptureSettings](/reference/system/xappcapture/functions/xappcapturegetvideocapturesettings)                               | Consulta la configuración de GameDVR del dispositivo, que incluye el tipo de codificación, el formato de color, la resolución, la duración máxima posible de la grabación y si el usuario actual permite capturas por parte de los juegos.                                      |
| [XAppCaptureMetadataAddDoubleEvent](/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent)                                 | Agrega un evento de metadatos con un valor double a la captura de la aplicación.                                                                                                                                                                                                |
| [XAppCaptureMetadataAddInt32Event](/reference/system/xappcapture/functions/xappcapturemetadataaddint32event)                                   | Agrega un evento de metadatos con un valor Int32 a la captura de la aplicación.                                                                                                                                                                                                 |
| [XAppCaptureMetadataAddStringEvent](/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent)                                 | Agrega un evento de metadatos con un valor de cadena a la captura de la aplicación.                                                                                                                                                                                             |
| [XAppCaptureMetadataPurgedCallback](/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback)                                 | Establece la función de devolución de llamada que se llamará cuando se produzca una purga de metadatos.                                                                                                                                                                         |
| [XAppCaptureMetadataRemainingStorageBytesAvailable](/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable) | Devuelve el almacenamiento restante disponible para los metadatos de captura de la aplicación. Se mide en bytes.                                                                                                                                                                |
| [XAppCaptureMetadataStartDoubleState](/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate)                             | Agrega un estado de metadatos con un valor double a la captura de la aplicación.                                                                                                                                                                                                |
| [XAppCaptureMetadataStartInt32State](/reference/system/xappcapture/functions/xappcapturemetadatastartint32state)                               | Agrega un estado de metadatos con un valor Int32 a la captura de la aplicación.                                                                                                                                                                                                 |
| [XAppCaptureMetadataStartStringState](/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate)                             | Agrega un estado de metadatos con un valor de cadena a la captura de la aplicación.                                                                                                                                                                                             |
| [XAppCaptureMetadataStopAllStates](/reference/system/xappcapture/functions/xappcapturemetadatastopallstates)                                   | Detiene todos los eventos de estado actualmente activos.                                                                                                                                                                                                                        |
| [XAppCaptureMetadataStopState](/reference/system/xappcapture/functions/xappcapturemetadatastopstate)                                           | Agrega una detención de estado para un estado con nombre determinado a los metadatos de captura de la aplicación.                                                                                                                                                               |
| [XAppCaptureOpenScreenshotStream](/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream)                                     | Abre una secuencia de capturas de pantalla.                                                                                                                                                                                                                                     |
| [XAppCaptureReadLocalStream](/reference/system/xappcapture/functions/xappcapturereadlocalstream)                                               | Lee el contenido del archivo .mp4 generado por una llamada anterior a [XAppCaptureRecordTimespan](/reference/system/xappcapture/functions/xappcapturerecordtimespan).                                                                                                           |
| [XAppCaptureReadScreenshotStream](/reference/system/xappcapture/functions/xappcapturereadscreenshotstream)                                     | Lee una secuencia de capturas de pantalla.                                                                                                                                                                                                                                      |
| [XAppCaptureRecordDiagnosticClip](/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip)                                     | Graba un clip de diagnóstico desde la aplicación.                                                                                                                                                                                                                               |
| [XAppCaptureRecordTimespan](/reference/system/xappcapture/functions/xappcapturerecordtimespan)                                                 | Realiza una grabación de GameDVR.                                                                                                                                                                                                                                               |
| [XAppCaptureRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureregistermetadatapurged)                                 | Registra un controlador de eventos para los eventos de purga de metadatos.                                                                                                                                                                                                      |
| [XAppCaptureStartUserRecord](/reference/system/xappcapture/functions/xappcapturestartuserrecord)                                               | Inicia una grabación como si el usuario la hubiera desencadenado.                                                                                                                                                                                                               |
| [XAppCaptureStopUserRecord](/reference/system/xappcapture/functions/xappcapturestopuserrecord)                                                 | Detiene y guarda una grabación de usuario en curso, iniciada mediante [XAppCaptureStartUserRecord](/reference/system/xappcapture/functions/xappcapturestartuserrecord) y especificada por el identificador indicado.                                                            |
| [XAppCaptureTakeDiagnosticScreenshot](/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot)                             | Realiza una captura de pantalla de diagnóstico desde la aplicación.                                                                                                                                                                                                             |
| [XAppCaptureTakeScreenshot](/reference/system/xappcapture/functions/xappcapturetakescreenshot)                                                 | Realiza una captura de pantalla.                                                                                                                                                                                                                                                |
| [XAppCaptureUnRegisterMetadataPurged](/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged)                             | Quita un controlador de eventos para los eventos de purga de metadatos.                                                                                                                                                                                                         |

## Estructuras

| Estructura                                                                                                           | Descripción                                                                                                                       |
| -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| [XAppBroadcastStatus](/reference/system/xappcapture/structs/xappbroadcaststatus)                                     | Describe el estado de las capacidades de difusión de una aplicación o juego.                                                      |
| [XAppCaptureDiagnosticScreenshotResult](/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult) | Captura de pantalla de la aplicación e información descriptiva.                                                                   |
| [XAppCaptureLocalResult](/reference/system/xappcapture/structs/xappcapturelocalresult)                               | Contiene el resultado de llamar a XAppCaptureRecordTimespan.                                                                      |
| [XAppCaptureRecordClipResult](/reference/system/xappcapture/structs/xappcapturerecordclipresult)                     | Clip de vídeo capturado e información descriptiva.                                                                                |
| [XAppCaptureScreenshotFile](/reference/system/xappcapture/structs/xappcapturescreenshotfile)                         | Captura de pantalla realizada e información descriptiva.                                                                          |
| [XAppCaptureScreenshotStream](/reference/system/xappcapture/structs/xappcapturescreenshotstream)                     | Representa una secuencia de capturas de pantalla.                                                                                 |
| [XAppCaptureTakeScreenshotResult](/reference/system/xappcapture/structs/xappcapturetakescreenshotresult)             | Representa los resultados de realizar una captura de pantalla.                                                                    |
| [XAppCaptureUserRecordingResult](/reference/system/xappcapture/structs/xappcaptureuserrecordingresult)               | Contiene el resultado de llamar a [XAppCaptureStopUserRecord](/reference/system/xappcapture/functions/xappcapturestopuserrecord). |
| [XAppCaptureVideoCaptureSettings](/reference/system/xappcapture/structs/xappcapturevideocapturesettings)             | Configuración de captura de vídeo de GameDVR.                                                                                     |

## Enumeraciones

| Enumeración                                                                                            | Descripción                                                                                                                                                                                                       |                                                                    |
| ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| [XAppCaptureMetadataPriority](/reference/system/xappcapture/enums/xappcapturemetadatapriority)         | Niveles de prioridad para los metadatos de captura de la aplicación. Se usa para determinar qué datos son más importantes cuando se aplican restricciones de almacenamiento y deben eliminarse algunos metadatos. |                                                                    |
| [XAppCaptureScreenshotFormatFlag](/reference/system/xappcapture/enums/xappcapturescreenshotformatflag) | Determina la calidad de definición de la captura de pantalla.                                                                                                                                                     |                                                                    |
| [XAppCaptureVideoColorFormat](/reference/system/xappcapture/enums/xappcapturevideocolorformat)         | El formato de color usado en las grabaciones de GameDVR.                                                                                                                                                          |                                                                    |
|                                                                                                     | [XAppCaptureVideoEncoding](/reference/system/xappcapture/enums/xappcapturevideoencoding)                                                                                                                          | Determina el tipo de codificación de vídeo de la captura de vídeo. |

## Documentación conceptual

* [Game DVR y difusión](/build/console-features/game-dvr/gamedvr-broadcast)
* [Subprocesos con dependencia temporal](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [¿Qué es Microsoft Game Development Kit?](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/intro/introduction)
* [Uso de wrappers de C# para las API del GDK en su proyecto de Unity](/build/gdk-and-engines/unity/unity-api-wrappers)

## Consulte también

[Códigos de error de XAppCapture](/reference/system/xappcapture/xappcapture_errors)\
[Referencia de API del sistema](/reference/system/gc-reference-system-toc)


## Related topics

- [XAppCaptureVideoCaptureSettings](/es/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)
- [Códigos de error de XAppCapture](/es/reference/system/xappcapture/xappcapture_errors.md)
- [XAppCaptureMetadataPriority](/es/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)
- [XAppCaptureTakeScreenshot](/es/reference/system/xappcapture/functions/xappcapturetakescreenshot.md)
- [XAppCaptureGetVideoCaptureSettings](/es/reference/system/xappcapture/functions/xappcapturegetvideocapturesettings.md)
