> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAppCapture (conteúdo da API)

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

## Estruturas

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

## Enumerações

| Enumeração | Descrição |
| - | - |
| [XAppCaptureMetadataPriority](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturemetadatapriority.md) | 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](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturescreenshotformatflag.md) | Determina a qualidade de definição da captura de tela. |
| [XAppCaptureVideoColorFormat](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturevideocolorformat.md) | O formato de cor usado nas gravações do GameDVR. |
| [XAppCaptureVideoEncoding](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturevideoencoding.md) | Determina o tipo de codificação de vídeo da captura de vídeo. |

## Documentação conceitual

* [Game DVR e transmissão](https://docs.xbox.com/pt-BR/build/console-features/game-dvr/gamedvr-broadcast.md)
* [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](https://docs.xbox.com/pt-BR/build/gdk-and-engines/unity/unity-api-wrappers.md)

## Confira também

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


## Related topics

- [XAppCaptureScreenshotStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturescreenshotstream.md)
- [XAppCaptureReadLocalStream](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturereadlocalstream.md)
- [XAppCaptureLocalResult](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturelocalresult.md)
- [XAppCaptureVideoCaptureSettings](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcapturevideocapturesettings.md)
- [XAppCaptureVideoEncoding](https://docs.xbox.com/pt-BR/reference/system/xappcapture/enums/xappcapturevideoencoding.md)