다음을 통해 공유


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 요구 사항

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

설명

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

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

생성자

Name Description
DeviceUseTrigger()

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

메서드

Name Description
RequestAsync(String)

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

RequestAsync(String, String)

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

적용 대상

추가 정보