BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
백그라운드 작업에 대한 이벤트 트리거를 설정합니다.
public:
virtual void SetTrigger(IBackgroundTrigger ^ trigger) = SetTrigger;void SetTrigger(IBackgroundTrigger const& trigger);public void SetTrigger(IBackgroundTrigger trigger);function setTrigger(trigger)Public Sub SetTrigger (trigger As IBackgroundTrigger)매개 변수
- trigger
- IBackgroundTrigger
SystemTrigger, TimeTrigger 또는 NetworkOperatorNotificationTrigger와 같은 이벤트 트리거 개체의 instance.
설명
애플리케이션은 백그라운드 작업에 대한 이벤트 트리거 유형을 지정하는 것 외에도 매니페스트의 섹션에서 이벤트 트리거 형식 <Extensions><Extension><BackgroundTasks> 을 사용하는 백그라운드 작업을 사용하도록 설정해야 합니다. 유효한 형식은 다음과 같습니다.
<Task Type="audio"/><Task Type="timer"/><Task Type="systemEvent"/><Task Type="pushNotification"/><Task Type="realTimeCommunication"/>
매니페스트에서 백그라운드 작업 유형을 잘못 지정하거나 지정하지 않으면 해당 종류의 백그라운드 작업을 사용하려는 호출이 실패합니다.
트리거 목록:
| 트리거 | Description |
|---|---|
| ActivitySensorTrigger | 애플리케이션이 활동 센서에 응답해야 할 때 사용됩니다. |
| AppBroadcastTrigger | 애플리케이션이 게임 플레이 브로드캐스트를 시작할 때 실행되도록 백그라운드 작업을 트리거합니다. |
| ApplicationTrigger | 애플리케이션 내에서 백그라운드 작업을 트리거합니다. |
| AppointmentStoreNotificationTrigger | 약속 저장소에 대한 변경 내용을 처리하기 위한 백그라운드 작업을 시작하도록 트리거합니다. |
| BluetoothLEAdvertisementPublisherTrigger | 백그라운드에서 Bluetooth LE 광고를 보급하기 위해 등록된 트리거를 나타냅니다. |
| CachedFileUpdaterTrigger | 백그라운드 작업을 트리거하여 캐시된 파일 업데이트자 계약을 사용하도록 설정합니다. |
| ChatMessageNotificationTrigger | 문자 메시지에 대한 알림이 있을 때 활성화되는 트리거를 나타냅니다. |
| ChatMessageReceivedNotificationTrigger | 콘텐츠에 따라 필터링해야 할 수 있는 들어오는 메시지를 처리하는 백그라운드 작업을 시작하는 트리거를 나타냅니다. |
| CommunicaionBlockingAppSetAsActiveTrigger | 기본 차단 앱으로 선택될 때 통신 차단 애플리케이션을 활성화하는 트리거를 나타냅니다. |
| ContactStoreNotificationTrigger | 연락처 저장소에 대한 변경 내용을 처리하기 위한 백그라운드 작업을 시작하는 트리거를 나타냅니다. |
| ContentPrefetchTrigger | 웹 리소스를 프리페치할 때 사용자 지정 처리기를 실행하는 기능을 제공합니다. |
| CustomSystemEventTrigger | 를 정의할 수 있는 사용자 지정 시스템 트리거입니다. |
| DeviceConnectionChangeTrigger | 애플리케이션이 디바이스의 장기 실행 업데이트(펌웨어 또는 설정)를 시작하기 위해 트리거할 수 있는 이벤트를 나타냅니다. |
| DeviceManufacturerNotificationTrigger | 애플리케이션이 디바이스의 장기 실행 업데이트(펌웨어 또는 설정)를 시작하기 위해 트리거할 수 있는 이벤트를 나타냅니다. |
| DeviceUseTrigger | Windows 런타임 앱이 디바이스 또는 센서를 사용하여 장기 실행 작업을 시작하기 위해 트리거할 수 있는 이벤트를 나타냅니다. |
| EmailStoreNotificationTrigger | 전자 메일 저장소에 대한 변경 내용을 알 수 있도록 하는 트리거를 나타냅니다. |
| GattCharacteristicNotificationTrigger | Bluetooth LE GATT 특성에 대해 들어오는 변경 알림을 받을 때 백그라운드 작업을 시작하는 트리거를 나타냅니다. |
| GattServiceProviderTrigger | 백그라운드에서 유지할 수 있는 GATT(제네릭 특성) 서비스를 생성합니다. |
| GeovisitTrigger | 방문 관련 백그라운드 작업을 트리거하는 이벤트를 나타냅니다. |
| LocationTrigger | 백그라운드 작업을 트리거하는 위치 이벤트를 나타냅니다. 지오펜싱에 사용됩니다. |
| MaintenanceTrigger | 시스템이 AC 전원에 연결된 경우에만 실행되는 유지 관리 트리거를 나타냅니다. |
| MediaProcessingTrigger | 미디어 처리를 수행하기 위한 백그라운드 작업을 시작하는 트리거를 나타냅니다. |
| MobileBroadbandDeviceServiceNotificationTrigger | 네트워크에서 SIM 도구 명령을 보낼 때 활성화되는 트리거를 나타냅니다. 이 알림을 받는 앱은 SIM 도구 명령을 처리합니다. |
| MobileBroadbandPcoDataChangeTrigger | 실행할 백그라운드 작업을 트리거하는 셀룰러 프로토콜 구성 옵션 변경 이벤트를 나타냅니다. |
| MobileBroadbandPinLockStateChangeTrigger | SIM PIN 잠금 상태가 변경된 시기를 나타내는 트리거를 나타냅니다. |
| MobileBroadbandRadioStateChangeTrigger | 모바일 광대역 라디오 상태가 변경된 시기를 나타내는 트리거를 나타냅니다. 예를 들어 이 트리거는 모바일 디바이스가 비행기 모드로 전환되거나 비행기 모드에서 전환되면 활성화됩니다. |
| MobileBroadbandRegistrationStateChangeTrigger | 모바일 광대역 등록 상태가 변경된 시기를 나타내는 트리거를 나타냅니다. 예를 들어 이 트리거는 모바일 디바이스가 로밍으로 전환되거나 로밍에서 전환되면 활성화됩니다. |
| NetworkOperatorDataUsageTrigger | 로컬 데이터 카운터가 모바일 광대역 인터페이스에서 보내고 받은 사용량(바이트)이 실행 가능한 임계값에 의해 변경된 것으로 추정할 때 백그라운드 작업을 시작하는 트리거를 나타냅니다. |
| NetworkOperatorHotspotAuthenticationTrigger | 모바일 네트워크 운영자 핫스팟 인증 트리거를 나타냅니다. |
| NetworkOperatorNotificationTrigger | 모바일 네트워크 운영자 알림 트리거를 나타냅니다. |
| PaymentAppCanMakePaymentTrigger | PaymentAppCanMakePayment 트리거를 나타냅니다. |
| PhoneTrigger | 백그라운드 작업을 트리거하는 전화 이벤트를 나타냅니다. |
| PushNotificationTrigger | 원시 알림 수신에 대한 응답으로 앱에서 백그라운드 작업 항목을 호출하는 트리거를 나타냅니다. |
| RcsEndUserMessageAvailableTrigger | 새 RCS(Rich Communication Services) 메시지를 사용할 수 있을 때 백그라운드 작업을 시작하는 트리거를 나타냅니다. |
| RfcommConnectionTrigger | RFCOMM 인바운드 또는 아웃바운드 연결이 설정될 때 백그라운드 작업을 시작하는 트리거를 나타냅니다. |
| SecondaryAuthenticationFactorAuthenticationTrigger | 도우미 디바이스를 대신하여 백그라운드 작업을 시작하는 트리거를 나타냅니다. |
| SensorDataThresholdTrigger | 센서에 대한 임계값 제한을 초과할 때 응답하는 트리거를 나타냅니다. |
| SmartCardTrigger | 스마트 카드 의해 트리거되는 이벤트를 나타냅니다. |
| SmsMessageReceivedTrigger | SMS 메시지가 도착했을 때 발생하는 트리거를 나타냅니다. |
| SocketActivityTrigger | 소켓 작업을 처리하기 위한 백그라운드 작업을 시작하는 트리거를 나타냅니다. |
| StorageLibraryChangeTrackerTrigger | 실행할 백그라운드 작업을 트리거하는 StorageFolder 내의 파일 변경 사항을 나타냅니다. |
| StorageLibraryContentChangedTrigger | 지정된 라이브러리에서 파일이 변경될 때 발생하는 트리거를 만듭니다. |
| SystemCondition | 백그라운드 작업을 실행하기 위해 적용되어야 하는 시스템 조건을 나타냅니다. |
| SystemTrigger | 실행할 백그라운드 작업을 트리거하는 시스템 이벤트를 나타냅니다. |
| TetheringEntitlementCheckTrigger | 실행할 백그라운드 작업을 트리거하는 테더링 이벤트를 나타냅니다. |
| TimeTrigger | 실행할 백그라운드 작업을 트리거하는 시간 이벤트를 나타냅니다. |
| ToastNotificationActionTrigger | 사용자가 대화형 알림 메시지에서 작업을 수행할 때 백그라운드 작업이 실행되도록 하는 이벤트를 나타냅니다. |
| ToastNotificationHistoryChangedTrigger | 앱에 대한 알림 메시지 기록이 지워지거나, 하나 이상의 알림 메시지가 앱의 알림 기록에 추가되거나 제거되거나, 앱에 대한 하나 이상의 알림 메시지가 만료되어 알림 기록에서 제거될 때 백그라운드 작업이 실행되도록 하는 이벤트를 나타냅니다. |
| UserNotificationChangedTrigger | UserNotification을 추가하거나 제거할 때 발생하는 트리거를 나타냅니다. |