GameMonitor Класс

Ссылка

Определение

Пространство имен:: Windows.Gaming.UI

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

Позволяет приложению получить состояние разрешений на игровой монитор устройства и потенциально предложить пользователю включить мониторинг игр.

Важно!

По состоянию на Windows 10, версия 1809 (10,0; Сборка 17763), этот API удаляется из общедоступной поверхности API 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

Наследование: 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) TruePlay не используется. Игры, зарегистрированные в TruePlay, будут выполняться в защищенном процессе, который обеспечивает защиту от определенного класса распространенных атак. API TruePlay для UWP обеспечивают ограниченное взаимодействие между играми и системой мониторинга игр на компьютерах с Windows 10.

Эти API-интерфейсы WinRT можно использовать в сочетании с собственными API в <gamemonitor.h> для работы с системой мониторинга игр. Документация по TruePlay больше не публикуется.

Методы

GetDefault()	Возвращает экземпляр класса GameMonitor . Важно! По состоянию на Windows 10, версия 1809 (10,0; Сборка 17763), этот API удаляется из общедоступной поверхности API Windows.
RequestPermissionAsync()	Возвращает состояние разрешений для мониторинга игр для устройства. Важно! По состоянию на Windows 10, версия 1809 (10,0; Сборка 17763), этот API удаляется из общедоступной поверхности API Windows.

Применяется к

См. также раздел

GameMonitoringPermission