GameMonitor Classe

Definição

Namespace:

Windows.Gaming.UI

Permite que um aplicativo obtenha o estado de permissão do monitor do jogo do dispositivo e, potencialmente, solicite que o usuário habilite o monitoramento de jogos.

Importante

A partir de Windows 10, versão 1809 (10.0; Build 17763), essa API é removida da superfície de API pública do Windows.

public ref class GameMonitor sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class GameMonitor final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class GameMonitor

Public NotInheritable Class GameMonitor

Herança

Object Platform::Object IInspectable GameMonitor

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v5.0)

Exemplos

O exemplo a seguir solicita ao cliente o consentimento para habilitar o monitoramento de jogos se ele ainda não estiver habilitado:

void DisplayGameMonitoringConsentUI() 
{ 
    auto gameMonitor = Windows::Gaming::UI::GameMonitor::GetDefault(); 

    if (gameMonitor != nullptr) 
    { 
        create_task(gameMonitor->RequestPermissionAsync())
            .then([this] (GameMonitoringPermission permissionState) 
            { 
                if (permissionState == GameMonitoringPermission::Allowed) 
                { 
                    // Continue with gaming experience. 
                } 
                else if (permissionState == GameMonitoringPermission::DeniedByUser
                    || permissionState == GameMonitoringPermission::DeniedBySystem) 
                { 
                    // Game has attempted mitigation. The game will likely exit. 
                }
            }); 
    } 
    else 
    { 
        // This is game-dependent - some games may proceed, others 
        // may require game monitoring for some scenarios, etc. 
    } 
} 

Comentários

Essa classe usa o TruePlay, um sistema no Windows 10 que ajuda a combater a fraude em jogos de computador. A partir do Windows 10, versão 1809 (10.0; Build 17763), o TruePlay foi removido do Windows. Um jogo registrado no TruePlay será executado em um processo protegido, que reduz uma classe de ataques comuns. As APIs TruePlay para UWP permitem interação limitada entre jogos e o sistema de monitoramento de jogos em computadores Windows 10.

Você pode usar essas APIs do WinRT, em conjunto com as APIs nativas no <gamemonitor.h>, para trabalhar com o sistema de monitoramento de jogos. A documentação do TruePlay não é mais publicada.

Métodos

GetDefault()	Obtém uma instância da classe GameMonitor . Importante A partir de Windows 10, versão 1809 (10.0; Build 17763), essa API é removida da superfície de API pública do Windows.
RequestPermissionAsync()	Obtém o estado de permissão de monitoramento do jogo do dispositivo. Importante A partir de Windows 10, versão 1809 (10.0; Build 17763), essa API é removida da superfície de API pública do Windows.

Confira também

• GameMonitoringPermission