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 | Recupera o status atual de transmissão do dispositivo e do aplicativo atual. |
| XAppBroadcastIsAppBroadcasting | Determina se o aplicativo está transmitindo no momento. |
| XAppBroadcastMonitorCallback | Define a função de retorno de chamada para XAppBroadcastRegisterIsAppBroadcastingChanged. A função definida aqui será chamada sempre que o status da transmissão mudar. |
| XAppBroadcastRegisterIsAppBroadcastingChanged | Registra um manipulador de eventos de alteração de status de transmissão do aplicativo. |
| 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 | Remove um manipulador de eventos de alteração de status de transmissão do aplicativo. |
| XAppCaptureCancelUserRecord | Interrompe e exclui uma gravação de usuário do GameDVR em andamento, iniciada por meio de XAppCaptureStartUserRecord e especificada pela ID informada. |
| XAppCaptureCloseLocalStream | Fecha e exclui o fluxo de gravação especificado. |
| XAppCaptureCloseScreenshotStream | Fecha um fluxo de captura de tela. |
| XAppCaptureDisableRecord | Desabilita a gravação de vídeo para o jogador. |
| XAppCaptureEnableRecord | Habilita a gravação/captura de tela para o usuário atual. |
| 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 | Adiciona um evento de metadados com um valor double à captura do aplicativo. |
| XAppCaptureMetadataAddInt32Event | Adiciona um evento de metadados com um valor Int32 à captura do aplicativo. |
| XAppCaptureMetadataAddStringEvent | Adiciona um evento de metadados com um valor de cadeia de caracteres à captura do aplicativo. |
| XAppCaptureMetadataPurgedCallback | Define a função de retorno de chamada a ser chamada quando ocorrer uma limpeza de metadados. |
| XAppCaptureMetadataRemainingStorageBytesAvailable | Retorna o armazenamento restante disponível para os metadados de captura do aplicativo. Medido em bytes. |
| XAppCaptureMetadataStartDoubleState | Adiciona um estado de metadados com um valor double à captura do aplicativo. |
| XAppCaptureMetadataStartInt32State | Adiciona um estado de metadados com um valor Int32 à captura do aplicativo. |
| XAppCaptureMetadataStartStringState | Adiciona um estado de metadados com um valor de cadeia de caracteres à captura do aplicativo. |
| XAppCaptureMetadataStopAllStates | Interrompe todos os eventos de estado ativos no momento. |
| XAppCaptureMetadataStopState | Adiciona uma interrupção de estado para um estado nomeado específico aos metadados de captura do aplicativo. |
| XAppCaptureOpenScreenshotStream | Abre um fluxo de captura de tela. |
| XAppCaptureReadLocalStream | Lê o conteúdo do arquivo .mp4 gerado por uma chamada anterior a XAppCaptureRecordTimespan. |
| XAppCaptureReadScreenshotStream | Lê um fluxo de captura de tela. |
| XAppCaptureRecordDiagnosticClip | Grava um clipe de diagnóstico do seu aplicativo. |
| XAppCaptureRecordTimespan | Faz uma gravação do GameDVR. |
| XAppCaptureRegisterMetadataPurged | Registra um manipulador de eventos para eventos de limpeza de metadados. |
| XAppCaptureStartUserRecord | Inicia uma gravação como se o usuário a tivesse disparado. |
| XAppCaptureStopUserRecord | Interrompe e salva uma gravação de usuário em andamento, iniciada por meio de XAppCaptureStartUserRecord e especificada pela ID informada. |
| XAppCaptureTakeDiagnosticScreenshot | Faz uma captura de tela de diagnóstico do seu aplicativo. |
| XAppCaptureTakeScreenshot | Faz uma captura de tela. |
| XAppCaptureUnRegisterMetadataPurged | Remove um manipulador de eventos para eventos de limpeza de metadados. |
Estruturas
| Estrutura | Descrição |
|---|---|
| XAppBroadcastStatus | Descreve o estado dos recursos de transmissão de um aplicativo/jogo. |
| XAppCaptureDiagnosticScreenshotResult | Captura de tela da captura do aplicativo e informações descritivas. |
| XAppCaptureLocalResult | Contém o resultado da chamada de XAppCaptureRecordTimespan. |
| XAppCaptureRecordClipResult | Clipe de vídeo capturado e informações descritivas. |
| XAppCaptureScreenshotFile | Captura de tela e informações descritivas. |
| XAppCaptureScreenshotStream | Representa um fluxo de captura de tela. |
| XAppCaptureTakeScreenshotResult | Representa os resultados de uma captura de tela. |
| XAppCaptureUserRecordingResult | Contém o resultado da chamada de XAppCaptureStopUserRecord. |
| XAppCaptureVideoCaptureSettings | Configurações de captura de vídeo do GameDVR. |
Enumerações
| Enumeração | Descrição |
|---|---|
| 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 | Determina a qualidade de definição da captura de tela. |
| XAppCaptureVideoColorFormat | O formato de cor usado nas gravações do GameDVR. |
| XAppCaptureVideoEncoding | Determina o tipo de codificação de vídeo da captura de vídeo. |
Documentação conceitual
- Game DVR e transmissão
- Threads sensíveis ao tempo
- O que é o Microsoft Game Development Kit?
- Usar wrappers C# para APIs do GDK em seu projeto do Unity
Confira também
Códigos de erro de XAppCaptureReferência da API do sistema