GameMonitor Klasse

Definition

Namespace:

Windows.Gaming.UI

Ermöglicht einer App, den Berechtigungsstatus des Geräts für den Spielmonitor abzurufen und den Benutzer möglicherweise aufzufordern, die Spieleüberwachung zu aktivieren.

Wichtig

Stand Windows 10, Version 1809 (10.0; Build 17763), wird diese API von der öffentlichen API-Oberfläche von Windows entfernt.

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

Vererbung

Object Platform::Object IInspectable GameMonitor

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v5.0)

Beispiele

Im folgenden Beispiel wird der Kunde um seine Zustimmung zum Aktivieren der Spieleüberwachung gebeten, falls diese noch nicht aktiviert ist:

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. 
    } 
} 

Hinweise

Diese Klasse verwendet TruePlay, ein System auf Windows 10, das hilft, Cheating in PC-Spielen zu bekämpfen. Ab Windows 10, Version 1809 (10.0, Build 17763), wird TruePlay aus Windows entfernt. Ein Spiel, das mit TruePlay registriert wird, wird in einem geschützten Prozess ausgeführt, das eine Klasse von häufigen Angriffen verringert. Die TruePlay-APIs für UWP ermöglichen eine eingeschränkte Interaktion zwischen Spielen und dem Spielüberwachungssystem auf Windows 10 PCs.

Sie können diese WinRT-APIs zusammen mit den nativen APIs in <gamemonitor.h> verwenden, um mit dem Spielüberwachungssystem zu arbeiten. Die Dokumentation für TruePlay wird nicht mehr veröffentlicht.

Methoden

GetDefault()	Ruft einen instance der GameMonitor-Klasse ab. Wichtig Stand Windows 10, Version 1809 (10.0; Build 17763), wird diese API von der öffentlichen API-Oberfläche von Windows entfernt.
RequestPermissionAsync()	Ruft den Berechtigungsstatus der Spielüberwachung des Geräts ab. Wichtig Stand Windows 10, Version 1809 (10.0; Build 17763), wird diese API von der öffentlichen API-Oberfläche von Windows entfernt.

Weitere Informationen

• GameMonitoringPermission