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

O XBOX e a área de trabalho incluem experiências nativas de transmissão, cada uma com suas próprias regras sobre quais aplicativos podem ser transmitidos por um usuário. Essas APIs permitem que o desenvolvedor abra a interface do usuário de transmissão e detecte quando o usuário está transmitindo. O desenvolvedor do aplicativo pode fornecer eventos e estados de metadados a serem salvos ou transmitidos com o arquivo/fluxo de vídeo e áudio capturado.

## Funções

| Função | Descrição |
| - | - |
| [XAppBroadcastGetStatus](/pt-BR/reference/system/xappcapture/functions/xappbroadcastgetstatus) | Recupera o status atual de transmissão do dispositivo e do aplicativo atual. |
| [XAppBroadcastIsAppBroadcasting](/pt-BR/reference/system/xappcapture/functions/xappbroadcastisappbroadcasting) | Determina se o aplicativo está transmitindo no momento. |
| [XAppBroadcastMonitorCallback](/pt-BR/reference/system/xappcapture/functions/xappbroadcastmonitorcallback) | Define a função de retorno de chamada para [XAppBroadcastRegisterIsAppBroadcastingChanged](/pt-BR/reference/system/xappcapture/functions/xappbroadcastregisterisappbroadcastingchanged). A função definida aqui será chamada sempre que o status da transmissão mudar. |
| [XAppBroadcastRegisterIsAppBroadcastingChanged](/pt-BR/reference/system/xappcapture/functions/xappbroadcastregisterisappbroadcastingchanged) | Registra um manipulador de eventos de alteração de status de transmissão do aplicativo. |
| [XAppBroadcastShowUI](/pt-BR/reference/system/xappcapture/functions/xappbroadcastshowui) | Mostra a interface do usuário de transmissão ao usuário do aplicativo para que ele possa iniciar a atividade de transmissão. |
| [XAppBroadcastUnregisterIsAppBroadcastingChanged](/pt-BR/reference/system/xappcapture/functions/xappbroadcastunregisterisappbroadcastingchanged) | Remove um manipulador de eventos de alteração de status de transmissão do aplicativo. |
| [XAppCaptureCancelUserRecord](/pt-BR/reference/system/xappcapture/functions/xappcapturecanceluserrecord) | Interrompe e exclui uma gravação de usuário do GameDVR em andamento, iniciada por meio de [XAppCaptureStartUserRecord](/pt-BR/reference/system/xappcapture/functions/xappcapturestartuserrecord) e especificada pela ID informada. |
| [XAppCaptureCloseLocalStream](/pt-BR/reference/system/xappcapture/functions/xappcapturecloselocalstream) | Fecha e exclui o fluxo de gravação especificado. |
| [XAppCaptureCloseScreenshotStream](/pt-BR/reference/system/xappcapture/functions/xappcaptureclosescreenshotstream) | Fecha um fluxo de captura de tela. |
| [XAppCaptureDisableRecord](/pt-BR/reference/system/xappcapture/functions/xappcapturedisablerecord) | Desabilita a gravação de vídeo para o jogador. |
| [XAppCaptureEnableRecord](/pt-BR/reference/system/xappcapture/functions/xappcaptureenablerecord) | Habilita a gravação/captura de tela para o usuário atual. |
| [XAppCaptureGetVideoCaptureSettings](/pt-BR/reference/system/xappcapture/functions/xappcapturegetvideocapturesettings) | Consulta as configurações do GameDVR do dispositivo, que incluem o tipo de codificação, o formato de cor, a resolução, a duração máxima possível da gravação e se o usuário atual permite capturas por jogos. |
| [XAppCaptureMetadataAddDoubleEvent](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent) | Adiciona um evento de metadados com um valor double à captura do aplicativo. |
| [XAppCaptureMetadataAddInt32Event](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataaddint32event) | Adiciona um evento de metadados com um valor Int32 à captura do aplicativo. |
| [XAppCaptureMetadataAddStringEvent](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent) | Adiciona um evento de metadados com um valor de cadeia de caracteres à captura do aplicativo. |
| [XAppCaptureMetadataPurgedCallback](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatapurgedcallback) | Define a função de retorno de chamada a ser chamada quando ocorrer uma limpeza de metadados. |
| [XAppCaptureMetadataRemainingStorageBytesAvailable](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable) | Retorna o armazenamento restante disponível para os metadados de captura do aplicativo. Medido em bytes. |
| [XAppCaptureMetadataStartDoubleState](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate) | Adiciona um estado de metadados com um valor double à captura do aplicativo. |
| [XAppCaptureMetadataStartInt32State](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartint32state) | Adiciona um estado de metadados com um valor Int32 à captura do aplicativo. |
| [XAppCaptureMetadataStartStringState](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate) | Adiciona um estado de metadados com um valor de cadeia de caracteres à captura do aplicativo. |
| [XAppCaptureMetadataStopAllStates](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastopallstates) | Interrompe todos os eventos de estado ativos no momento. |
| [XAppCaptureMetadataStopState](/pt-BR/reference/system/xappcapture/functions/xappcapturemetadatastopstate) | Adiciona uma interrupção de estado para um estado nomeado específico aos metadados de captura do aplicativo. |
| [XAppCaptureOpenScreenshotStream](/pt-BR/reference/system/xappcapture/functions/xappcaptureopenscreenshotstream) | Abre um fluxo de captura de tela. |
| [XAppCaptureReadLocalStream](/pt-BR/reference/system/xappcapture/functions/xappcapturereadlocalstream) | Lê o conteúdo do arquivo .mp4 gerado por uma chamada anterior a [XAppCaptureRecordTimespan](/pt-BR/reference/system/xappcapture/functions/xappcapturerecordtimespan). |
| [XAppCaptureReadScreenshotStream](/pt-BR/reference/system/xappcapture/functions/xappcapturereadscreenshotstream) | Lê um fluxo de captura de tela. |
| [XAppCaptureRecordDiagnosticClip](/pt-BR/reference/system/xappcapture/functions/xappcapturerecorddiagnosticclip) | Grava um clipe de diagnóstico do seu aplicativo. |
| [XAppCaptureRecordTimespan](/pt-BR/reference/system/xappcapture/functions/xappcapturerecordtimespan) | Faz uma gravação do GameDVR. |
| [XAppCaptureRegisterMetadataPurged](/pt-BR/reference/system/xappcapture/functions/xappcaptureregistermetadatapurged) | Registra um manipulador de eventos para eventos de limpeza de metadados. |
| [XAppCaptureStartUserRecord](/pt-BR/reference/system/xappcapture/functions/xappcapturestartuserrecord) | Inicia uma gravação como se o usuário a tivesse disparado. |
| [XAppCaptureStopUserRecord](/pt-BR/reference/system/xappcapture/functions/xappcapturestopuserrecord) | Interrompe e salva uma gravação de usuário em andamento, iniciada por meio de [XAppCaptureStartUserRecord](/pt-BR/reference/system/xappcapture/functions/xappcapturestartuserrecord) e especificada pela ID informada. |
| [XAppCaptureTakeDiagnosticScreenshot](/pt-BR/reference/system/xappcapture/functions/xappcapturetakediagnosticscreenshot) | Faz uma captura de tela de diagnóstico do seu aplicativo. |
| [XAppCaptureTakeScreenshot](/pt-BR/reference/system/xappcapture/functions/xappcapturetakescreenshot) | Faz uma captura de tela. |
| [XAppCaptureUnRegisterMetadataPurged](/pt-BR/reference/system/xappcapture/functions/xappcaptureunregistermetadatapurged) | Remove um manipulador de eventos para eventos de limpeza de metadados. |

## Estruturas

| Estrutura | Descrição |
| - | - |
| [XAppBroadcastStatus](/pt-BR/reference/system/xappcapture/structs/xappbroadcaststatus) | Descreve o estado dos recursos de transmissão de um aplicativo/jogo. |
| [XAppCaptureDiagnosticScreenshotResult](/pt-BR/reference/system/xappcapture/structs/xappcapturediagnosticscreenshotresult) | Captura de tela da captura do aplicativo e informações descritivas. |
| [XAppCaptureLocalResult](/pt-BR/reference/system/xappcapture/structs/xappcapturelocalresult) | Contém o resultado da chamada de XAppCaptureRecordTimespan. |
| [XAppCaptureRecordClipResult](/pt-BR/reference/system/xappcapture/structs/xappcapturerecordclipresult) | Clipe de vídeo capturado e informações descritivas. |
| [XAppCaptureScreenshotFile](/pt-BR/reference/system/xappcapture/structs/xappcapturescreenshotfile) | Captura de tela e informações descritivas. |
| [XAppCaptureScreenshotStream](/pt-BR/reference/system/xappcapture/structs/xappcapturescreenshotstream) | Representa um fluxo de captura de tela. |
| [XAppCaptureTakeScreenshotResult](/pt-BR/reference/system/xappcapture/structs/xappcapturetakescreenshotresult) | Representa os resultados de uma captura de tela. |
| [XAppCaptureUserRecordingResult](/pt-BR/reference/system/xappcapture/structs/xappcaptureuserrecordingresult) | Contém o resultado da chamada de [XAppCaptureStopUserRecord](/pt-BR/reference/system/xappcapture/functions/xappcapturestopuserrecord). |
| [XAppCaptureVideoCaptureSettings](/pt-BR/reference/system/xappcapture/structs/xappcapturevideocapturesettings) | Configurações de captura de vídeo do GameDVR. |

## Enumerações

| Enumeração | Descrição |
| - | - |
| [XAppCaptureMetadataPriority](/pt-BR/reference/system/xappcapture/enums/xappcapturemetadatapriority) | Níveis de prioridade dos metadados de captura do aplicativo. Usados para determinar quais dados são mais importantes quando restrições de armazenamento são aplicadas e alguns metadados precisam ser excluídos. |
| [XAppCaptureScreenshotFormatFlag](/pt-BR/reference/system/xappcapture/enums/xappcapturescreenshotformatflag) | Determina a qualidade de definição da captura de tela. |
| [XAppCaptureVideoColorFormat](/pt-BR/reference/system/xappcapture/enums/xappcapturevideocolorformat) | O formato de cor usado nas gravações do GameDVR. |
| [XAppCaptureVideoEncoding](/pt-BR/reference/system/xappcapture/enums/xappcapturevideoencoding) | Determina o tipo de codificação de vídeo da captura de vídeo. |

## Documentação conceitual

* [Game DVR e transmissão](/pt-BR/build/console-features/game-dvr/gamedvr-broadcast)
* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [O que é o Microsoft Game Development Kit?](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/intro/introduction)
* [Usar wrappers C# para APIs do GDK em seu projeto do Unity](/pt-BR/build/gdk-and-engines/unity/unity-api-wrappers)

## Confira também

[Códigos de erro de XAppCapture](/pt-BR/reference/system/xappcapture/xappcapture_errors)\
[Referência da API do sistema](/pt-BR/reference/system/gc-reference-system-toc)


## Related topics

- [XAppCapture](/reference/system/xappcapture/xappcapture_members.md)
- [XAppCapture Error Codes](/reference/system/xappcapture/xappcapture_errors.md)
- [XAppCapture 오류 코드](/ko/reference/system/xappcapture/xappcapture_errors.md)
- [XAppCaptureVideoCaptureSettings](/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)
- [Códigos de error de XAppCapture](/es/reference/system/xappcapture/xappcapture_errors.md)