GameMonitor 类

定义

命名空间:

Windows.Gaming.UI

允许应用获取设备的游戏监视器权限状态，并可能提示用户启用游戏监视。

重要

截至 Windows 10 版本 1809 (10.0;内部版本 17763) ，此 API 已从 Windows 的公共 API 图面中删除。

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

继承

Object Platform::Object IInspectable GameMonitor

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 Fall Creators Update (在 10.0.16299.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v5.0 中引入)

示例

以下示例要求客户同意启用游戏监视（如果尚未启用）：

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

注解

此类使用 TruePlay，这是一个Windows 10上的系统，可帮助在电脑游戏中防止作弊。 从 Windows 10 版本 1809（10.0，内部版本 17763）起，Windows 中会删除 TruePlay。 加入 TruePlay 的游戏将在受保护的程序中运行，减少了常见的攻击类型。 UWP 的 TruePlay API 允许在Windows 10电脑上的游戏与游戏监视系统之间有限的交互。

可以将这些 WinRT API 与 gamemonitor.h> 中的<本机 API 结合使用，以配合游戏监视系统。 不再发布 TruePlay 的文档。

方法

GetDefault()	获取 GameMonitor 类的实例。 重要 截至 Windows 10 版本 1809 (10.0;内部版本 17763) ，此 API 已从 Windows 的公共 API 图面中删除。
RequestPermissionAsync()	获取设备的游戏监视权限状态。 重要 截至 Windows 10 版本 1809 (10.0;内部版本 17763) ，此 API 已从 Windows 的公共 API 图面中删除。

另请参阅

• GameMonitoringPermission