다음을 통해 공유


BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) 메서드

정의

백그라운드 작업에 대한 이벤트 트리거를 설정합니다.

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을 추가하거나 제거할 때 발생하는 트리거를 나타냅니다.

적용 대상