Skip to main content
O Microsoft Game Development Kit (GDK) inclui um conjunto de APIs para notificações de transmissão, exibição da interface do usuário de transmissão, adição de metadados a capturas de tela, clipes de vídeo e transmissões, e captura de capturas de tela e vídeos de diagnóstico. As notificações de transmissão fornecem informações sobre o pipeline de transmissão. A interface do usuário de transmissão coloca o usuário no controle do início e da interrupção de uma transmissão. A adição de metadados facilita a pesquisa de gravações, por exemplo, adicionando o nome de um mapa, uma fase do jogo ou qualquer informação sobre aquele momento específico que foi capturado. Combinadas, essas APIs oferecem a você mais controle e visibilidade sobre suas capturas de tela, clipes de vídeo e transmissões.

​
Notificações e interface do usuário de transmissão

XAppBroadcastGetStatus exibe atualizações sobre o estado da transmissão. Use esse método para determinar se uma transmissão pode ser iniciada. Muitos fatores influenciam na determinação de se uma transmissão pode ser iniciada, como garantir que o recurso de captura esteja disponível, se o jogo permite transmissões ou se o usuário e/ou o sistema não desabilitou as transmissões. Se todos os membros do struct XAppBroadcastStatus (exceto canStartBroadcast) retornarem false, canStartBroadcast retornará true. Se uma transmissão puder ser iniciada, chame XAppBroadcastShowUI para exibir a interface do usuário de transmissão para o usuário atual. Em seguida, o usuário deve iniciar a transmissão manualmente. XAppBroadcastIsAppBroadcasting é usado para determinar se o aplicativo atual está transmitindo. XAppBroadcastUnregisterIsAppBroadcasting é usado para cancelar o registro de eventos de alteração do status da transmissão.

​
Adicionar metadados a uma captura de tela, um clipe de vídeo e uma transmissão

Várias APIs são usadas para adicionar e gerenciar metadados anexados a uma captura de tela, um clipe de vídeo ou uma transmissão. A adição de metadados é opcional. No entanto, ela facilita para o usuário encontrar a gravação desejada. Os metadados podem assumir várias formas, como cadeias de caracteres, inteiros e doubles. O sistema aloca espaço de armazenamento para os itens de metadados. Se o espaço alocado estiver acabando, AppCaptureMetatPriority é usado para determinar as prioridades relativas dos itens de metadados armazenados e a ordem em que os metadados são removidos para liberar espaço.

​
Chat de voz

O chat de voz deve ser considerado conteúdo gerado pelo usuário, que pode conter informações de identificação pessoal ou outros dados potencialmente confidenciais. Por isso, a voz renderizada de um usuário no chat do jogo nunca deve ser incluída em clipes gravados ou capturas do jogo. Isso pode ser feito atribuindo a categoria de áudio adequada, AudioCategory_GameChat, ao fluxo de renderização que contém a voz do usuário. Isso marca o fluxo adequadamente para que o sistema saiba que deve ignorar esse fluxo de áudio ao capturar clipes do Game DVR.

​
Capturas de tela e clipes de vídeo de diagnóstico

Com essas APIs do Microsoft Game Development Kit (GDK), você pode capturar capturas de tela e clipes de vídeo para fins de diagnóstico. Observe que essas APIs de diagnóstico estão disponíveis apenas em Development Kits. Chamar essas APIs em um console de varejo resulta em falha imediata. As capturas de tela e os clipes de vídeo capturados vão para a partição local do jogo, e não para o armazenamento normal do usuário. Se o jogo estiver sendo executado em HDR (High Dynamic Range), o chamador poderá especificar se deseja capturar uma captura de tela SDR (Standard Dynamic Range), uma captura de tela HDR ou ambas. Depois que uma captura de tela é gravada, o struct resultante contém informações de caminho sobre o local dos arquivos da captura de tela. Para os clipes de vídeo, dependendo da configuração do Game DVR do usuário, pode ser retornado um vídeo codificado em H264 (Advanced Video Coding (AVC)) ou um vídeo codificado em H265 (High Efficiency Video Coding (HEVC)). O struct resultante também inclui informações como hora de início, duração, largura e altura.

​
Capturas de tela normais

Uma novidade do Microsoft Game Development Kit (GDK) é a capacidade de capturar capturas de tela normais. As capturas de tela resultantes são armazenadas no armazenamento normal do usuário para capturas de tela. Além disso, uma notificação do sistema informa que uma captura de tela foi capturada. Como as capturas de tela são armazenadas em uma partição separada que não pode ser acessada diretamente pela partição do jogo, você deve usar as APIs de fluxo open/read/close fornecidas para acessar as capturas de tela gravadas. Observe que, se o jogo estiver sendo executado em HDR, serão retornados os caminhos da versão SDR e da versão HDR das capturas de tela.

​
Documentação de referência da API

​
Confira também

XAppCapture
Last modified on October 6, 2026