DeviceUseTrigger Класс

Ссылка

Определение

Пространство имен:: Windows.ApplicationModel.Background

Важно!

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

Изменить

Представляет событие, которое приложение среда выполнения Windows может активировать для запуска длительной операции с устройством или датчиком.

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

Этот класс можно использовать в приложении UWP и Windows Phone приложении 8.x. Однако фоновая задача DeviceUseTrigger поддерживает различные API и регулируется разными политиками в зависимости от того, где она выполняется (пк или телефон). Дополнительные сведения об этих различиях см. в статье Доступ к датчикам и устройствам из фоновой задачи.

Важно!

Этот триггер нельзя использовать с фоновыми задачами с одним процессом.

Пример использования DeviceUseTrigger на компьютере см. в разделе Пример пользовательского USB-устройства. Пример телефона см. в разделе Пример датчика фона.

public ref class DeviceUseTrigger sealed

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

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DeviceUseTrigger final

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

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DeviceUseTrigger

function DeviceUseTrigger()

Public NotInheritable Class DeviceUseTrigger

Наследование: Object Platform::Object IInspectable DeviceUseTrigger

Атрибуты: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации: IBackgroundTrigger

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Прежде чем приложение активирует фоновую задачу на телефоне, оно должно сначала вызвать BackgroundExecutionManager.RequestAccessAsync, чтобы проверка, может ли приложение запросить фоновую задачу. Это проверка не требуется, если приложение выполняется на компьютере.

Конструкторы

DeviceUseTrigger()

Конструктор для DeviceUseTrigger. Не принимает параметров.

Методы

RequestAsync(String)

RequestAsync(String, String)

Активирует фоновую задачу и возвращает объект DeviceTriggerResult , указывающий на успешное выполнение или сбой запроса триггера. Принимает DeviceInformation.ID устройства или датчика, к которым будет обращаться фоновая задача, и дополнительную строку приложения, передаваемую фоновой задаче, определяющую, какую операцию следует выполнить.

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

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

IBackgroundTrigger