DeviceUseTrigger 클래스

정의

Windows 런타임 앱이 디바이스 또는 센서를 사용하여 장기 실행 작업을 시작하기 위해 트리거할 수 있는 이벤트를 나타냅니다.

DeviceUseTrigger를 사용하면 포그라운드 앱이 일시 중단된 경우에도 Windows 런타임 앱이 백그라운드에서 센서 및 주변 장치에 액세스할 수 있습니다. 예를 들어 앱이 실행 중인 위치에 따라 백그라운드 작업을 사용하여 디바이스와 데이터를 동기화하거나 센서를 모니터링할 수 있습니다.

이 클래스는 UWP 앱 및 Windows Phone 8.x 앱에서 사용할 수 있습니다. 그러나 DeviceUseTrigger 백그라운드 작업은 다른 API를 지원하며 실행 중인 위치(PC 또는 휴대폰)에 따라 다른 정책이 적용됩니다. 이러한 차이점에 대한 자세한 내용은 백그라운드 작업에서 센서 및 디바이스 액세스를 참조하세요.

중요

이 트리거는 단일 프로세스 백그라운드 작업에서 사용할 수 없습니다.

PC에서 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
특성
구현

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

정책 요구 사항에 대한 자세한 내용은 백그라운드 작업에서 센서 및 디바이스 액세스를 참조하세요.

앱이 휴대폰에서 백그라운드 작업을 트리거하기 전에 먼저 BackgroundExecutionManager.RequestAccessAsync를 호출하여 앱이 백그라운드 작업을 요청할 수 있는지 검사 합니다. 이 검사 앱이 PC에서 실행되는 경우 필요하지 않습니다.

생성자

DeviceUseTrigger()

DeviceUseTrigger에 대한 생성자입니다. 매개 변수를 사용하지 않습니다.

메서드

RequestAsync(String)

백그라운드 작업을 트리거하고 트리거 요청의 성공 또는 실패를 나타내는 DeviceTriggerResult 를 반환합니다. 백그라운드 작업이 액세스할 디바이스 또는 센서의 DeviceInformation.ID 사용합니다.

RequestAsync(String, String)

백그라운드 작업을 트리거하고 트리거 요청의 성공 또는 실패를 나타내는 DeviceTriggerResult 를 반환합니다. 백그라운드 작업이 액세스할 디바이스 또는 센서의 DeviceInformation.ID 수행하려는 작업을 식별하는 선택적 앱별 문자열을 백그라운드 작업에 전달합니다.

적용 대상

추가 정보