다음을 통해 공유


Windows.ApplicationModel.Background 네임스페이스

앱이 일시 중단된 경우에도 앱이 앱 코드를 실행하도록 백그라운드 작업을 예약할 수 있도록 합니다.

백그라운드 작업은 사용자 상호 작용이 필요하지 않거나 알림 작업을 처리하는 작은 작업 항목을 위한 것입니다. 백그라운드 작업에 적합한 시나리오에는 메일 다운로드, 들어오는 채팅 메시지에 대한 알림 메시지 표시 또는 시스템 조건의 변경에 대응하는 작업이 포함됩니다.

백그라운드 작업(JavaScript 및 HTML 사용)을 사용하여 앱 지원 또는 백그라운드 작업으로 앱 지원을 참조하여 백그라운드 작업 구현에 대한 지침을 참조하세요. 백그라운드 작업을 구현하는 방법을 보여 주는 예제 코드는 백그라운드 작업 샘플을 참조하세요.

클래스

ActivitySensorTrigger

ActivitySensor가 입력을 받을 때 활성화되는 트리거를 나타냅니다. 애플리케이션이 활동 센서에 응답해야 하는 경우에 사용됩니다.

AlarmApplicationManager

사용자에게 알람을 설정할 수 있는 권한을 요청하고, 앱이 알람을 설정할 수 있는 사용자 권한의 상태 검색합니다.

AppBroadcastTrigger

애플리케이션이 게임 플레이 브로드캐스트를 시작할 때 실행되도록 백그라운드 작업을 트리거하는 이벤트를 나타냅니다.

AppBroadcastTriggerProviderInfo

로고, 표시 이름 및 비디오 특성과 같은 게임 플레이를 브로드캐스트하는 애플리케이션에 대한 정보를 제공합니다.

ApplicationTrigger

이렇게 하면 애플리케이션 내에서 백그라운드 작업을 프로그래밍 방식으로 트리거할 수 있습니다.

ApplicationTriggerDetails

ApplicationTrigger의 세부 정보입니다.

AppointmentStoreNotificationTrigger

약속 저장소에 대한 변경 내용을 처리하기 위한 백그라운드 작업을 시작하는 트리거를 나타냅니다.

BackgroundExecutionManager

백그라운드 작업을 실행할 수 있는 권한을 관리합니다.

BackgroundTaskBuilder

시스템에 등록할 백그라운드 작업을 나타냅니다.

BackgroundTaskCompletedEventArgs

완료 알림이 전송될 때 작업에 대한 완료 정보를 나타냅니다.

BackgroundTaskDeferral

IBackgroundTaskInstance.GetDeferral 메서드에서 반환된 백그라운드 작업 지연을 나타냅니다.

BackgroundTaskProgressEventArgs

진행률 업데이트 알림을 보낼 때 작업에 대한 진행률 정보를 나타냅니다.

BackgroundTaskRegistration

시스템에 등록된 백그라운드 작업을 나타냅니다.

BackgroundTaskRegistrationGroup

백그라운드 작업 등록을 별도로 유지할 수 있도록 그룹화 의미 체계를 제공합니다.

BackgroundWorkCost

백그라운드 작업의 리소스 가용성에 대한 힌트를 검색합니다. 백그라운드 작업은 이 힌트를 사용하여 활성화될 때 수행할 작업량을 결정할 수 있습니다.

BluetoothLEAdvertisementPublisherTrigger

백그라운드에서 Bluetooth LE 광고를 보급하기 위해 등록된 트리거를 나타냅니다.

BluetoothLEAdvertisementWatcherTrigger

백그라운드에서 Bluetooth LE 광고를 검색하기 위해 등록된 트리거를 나타냅니다.

CachedFileUpdaterTrigger

캐시된 파일 업데이트자 계약을 사용하도록 설정하는 백그라운드 작업을 시작하는 트리거를 나타냅니다.

CachedFileUpdaterTriggerDetails

트리거를 호출한 캐시된 파일 작업에 대한 세부 정보를 제공합니다.

ChatMessageNotificationTrigger

문자 메시지에 대한 알림이 있을 때 활성화되는 트리거를 나타냅니다.

ChatMessageReceivedNotificationTrigger

콘텐츠에 따라 필터링해야 할 수 있는 들어오는 메시지를 처리하는 백그라운드 작업을 시작하는 트리거를 나타냅니다. 메시지 필터링에 대한 자세한 내용은 Windows.ApplicationModel.CommunicationBlocking을 참조하세요.

CommunicationBlockingAppSetAsActiveTrigger

기본 차단 앱으로 선택된 경우 통신 차단 애플리케이션을 활성화하는 트리거를 나타냅니다.

사용자는 한 번에 여러 통신 차단 애플리케이션을 설치할 수 있습니다. 이 트리거는 애플리케이션이 활성 통신 차단 애플리케이션으로 선택되었음을 알리는 데 사용됩니다. 통신 차단 API에 대한 자세한 내용은 Windows.ApplicationModel.CommunicationBlocking을 참조하세요.

ContactStoreNotificationTrigger

연락처 저장소에 대한 변경 내용을 처리하기 위한 백그라운드 작업을 시작하는 트리거를 나타냅니다.

ContentPrefetchTrigger

웹 리소스를 프리페치할 때 사용자 지정 처리기를 실행하는 기능을 제공합니다.

ConversationalAgentTrigger

Windows 플랫폼 AAR(에이전트 정품 인증 런타임)을 통해 디지털 도우미 통신을 처리하기 위한 백그라운드 작업을 시작하는 트리거를 나타냅니다.

CustomSystemEventTrigger

이 클래스를 사용하면 사용자 지정 시스템 트리거를 지정하여 시스템에 의해 트리거될 때 등록하고 응답할 수 있습니다.

DeviceConnectionChangeTrigger

디바이스의 연결 상태 변경되면 백그라운드 작업을 시작하는 트리거를 나타냅니다.

DeviceManufacturerNotificationTrigger

디바이스 제조업체 작업을 사용하도록 설정하는 백그라운드 작업을 시작하는 트리거를 나타냅니다.

DeviceServicingTrigger

애플리케이션이 디바이스의 장기 실행 업데이트(펌웨어 또는 설정)를 시작하기 위해 트리거할 수 있는 이벤트를 나타냅니다.

Windows 8.1 사용하면 USB, HID 및 Bluetooth를 통해 통신하는 주변 장치용 UWP 앱을 개발할 수 있습니다. 예를 들어 사용자는 PC의 콘텐츠를 디바이스와 동기화하거나 설정 또는 펌웨어 업데이트와 같이 디바이스 자체에 대한 장기 실행 업데이트를 수행해야 할 수 있습니다. Windows 8.1 디바이스가 백그라운드에서 동기화 및 업데이트할 수 있도록 하는 두 가지 백그라운드 작업 및 해당 API인 DeviceServicingTrigger 및 DeviceUseTrigger를 제공합니다. 이 항목에서는 DeviceServicingTrigger에 대한 API 참조 정보를 제공합니다. 디바이스 앱의 컨텍스트에서 이 트리거를 사용하는 방법에 대한 자세한 내용은 UWP 디바이스 앱에 대한 디바이스 동기화 및 업데이트를 참조하세요.

DeviceServicingTrigger 백그라운드 작업을 사용하면 주변 장치와 상호 작용하는 UWP 앱이 앱이 일시 중단되는 동안(예: 설정 전송 또는 펌웨어 업데이트) 장기 실행 디바이스 업데이트를 수행할 수 있습니다. 백그라운드에서 디바이스를 업데이트하려면 백그라운드 작업이 사용될 때마다 사용자 승인이 필요합니다. DeviceUseTrigger 백그라운드 작업과 달리 DeviceServicingTrigger 백그라운드 작업은 디바이스를 다시 부팅하고 연결을 끊을 수 있으며 최대 30분의 백그라운드 작업을 허용합니다.

중요

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

DeviceUseTrigger

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

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

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

중요

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

PC에서 DeviceUseTrigger 를 사용하는 방법을 보여 주는 샘플은 사용자 지정 USB 디바이스 샘플을 참조하세요. 휴대폰 샘플은 백그라운드 센서 샘플을 참조하세요.

DeviceWatcherTrigger

디바이스 목록에 변경이 발생할 때 백그라운드 작업이 실행되도록 하는 이벤트를 나타냅니다. GetBackgroundTrigger에서 반환됩니다.

EmailStoreNotificationTrigger

전자 메일 저장소에 대한 변경 내용을 알 수 있도록 하는 트리거를 나타냅니다.

GattCharacteristicNotificationTrigger

Bluetooth LE GATT 특성에 대해 들어오는 변경 알림을 받을 때 백그라운드 작업을 시작하는 트리거를 나타냅니다.

GattServiceProviderTrigger

백그라운드에서 유지할 수 있는 GATT(제네릭 특성) 서비스를 생성합니다.

GattServiceProviderTriggerResult

이 클래스에는 GattServiceProviderTrigger.CreateAsync()에서 만든 트리거가 포함됩니다.

GeovisitTrigger

방문 관련 백그라운드 작업을 트리거하는 이벤트를 나타냅니다.

LocationTrigger

백그라운드 작업을 트리거하는 위치 이벤트를 나타냅니다. 지오펜싱에 사용됩니다.

MaintenanceTrigger

유지 관리 트리거를 나타냅니다.

MediaProcessingTrigger

미디어 처리를 수행하기 위한 백그라운드 작업을 시작하는 트리거를 나타냅니다.

MobileBroadbandDeviceServiceNotificationTrigger

네트워크에서 SIM 도구 명령을 보낼 때 활성화되는 트리거를 나타냅니다. 이 알림을 받는 앱은 SIM 도구 명령을 처리합니다.

이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여받은 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 자세한 내용은 모바일 광대역을 참조하세요.

MobileBroadbandPcoDataChangeTrigger

실행할 백그라운드 작업을 트리거하는 셀룰러 프로토콜 구성 옵션 변경 이벤트를 나타냅니다.

MobileBroadbandPinLockStateChangeTrigger

SIM PIN 잠금 상태가 변경된 시기를 나타내는 트리거를 나타냅니다.

이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여받은 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 자세한 내용은 모바일 광대역을 참조하세요.

MobileBroadbandRadioStateChangeTrigger

모바일 광대역 라디오 상태가 변경된 시기를 나타내는 트리거를 나타냅니다. 예를 들어 이 트리거는 모바일 디바이스가 비행기 모드로 전환되거나 비행기 모드에서 전환되면 활성화됩니다.

이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여받은 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 자세한 내용은 모바일 광대역을 참조하세요.

MobileBroadbandRegistrationStateChangeTrigger

모바일 광대역 등록 상태가 변경된 시기를 나타내는 트리거를 나타냅니다. 예를 들어 이 트리거는 모바일 디바이스가 로밍으로 전환되거나 로밍에서 전환되면 활성화됩니다.

이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여받은 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 자세한 내용은 모바일 광대역을 참조하세요.

NetworkOperatorDataUsageTrigger

로컬 데이터 카운터가 모바일 광대역 인터페이스의 사용량(전송 및 수신된 바이트)이 실행 가능한 임계값에 의해 변경된 것으로 추정할 때 백그라운드 작업을 시작하는 트리거를 나타냅니다.

참고

이 기능은 모바일 네트워크 운영자가 권한 있는 액세스 권한을 부여받은 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다.

이 API를 사용하고 앱을 Microsoft Store에 게시하려면 특별한 승인이 필요합니다. 자세한 내용은 앱 기능 선언 항목의 제한된 기능 섹션 및 모바일 광대역을 참조하세요.

NetworkOperatorHotspotAuthenticationTrigger

모바일 네트워크 운영자 핫스폿 인증 트리거를 나타냅니다.

참고

앱은 이 앱을 참조하여 핫스팟 인증을 처리하는 WLAN 프로필이 프로비전된 후에만 이 개체를 인스턴스화하고 핫스팟 인증 이벤트에 등록할 수 있습니다. 자세한 내용은 무선 핫스팟 운영자용 Windows 8 통합을 참조하세요.

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

WiFiOnDemandHotspotConnectTrigger

사용자가 특정 주문형 핫스팟 네트워크에 연결하려고 할 때 백그라운드 작업이 실행되도록 하는 이벤트를 나타냅니다.

백그라운드 작업 코드는 IBackgroundTaskInstance.TriggerDetails 속성의 값을 WiFiOnDemandHotspotConnectTriggerDetails로 캐스팅해야 합니다.

참고

UWP 앱에서 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (주문형 네트워크 기능)을 사용하기 위해 특별한 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.

주문형 네트워크 기능은 테더링 가능 하드웨어 디바이스와 Windows PC 간에 엔드투엔드 Wi-Fi 핫스팟 시나리오를 빌드하는 앱 개발자만 사용할 수 있습니다.

WiFiOnDemandHotspotUpdateMetadataTrigger

새 Wi-Fi 네트워크에 연결하는 것처럼 사용자가 OS(운영 체제) Wi-Fi 네트워크 목록을 열 때 백그라운드 작업이 실행되도록 하는 이벤트를 나타냅니다.

참고

UWP 앱에서 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (주문형 네트워크 기능)을 사용하기 위해 특별한 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.

주문형 네트워크 기능은 테더링 가능 하드웨어 디바이스와 Windows PC 간에 엔드투엔드 Wi-Fi 핫스팟 시나리오를 빌드하는 앱 개발자만 사용할 수 있습니다.

인터페이스

IBackgroundCondition

시스템 조건 개체 형식을 적용하는 데 사용됩니다.

IBackgroundTask

백그라운드 작업의 작업을 수행하는 메서드를 제공합니다.

IBackgroundTaskInstance

백그라운드 작업 instance 대한 액세스를 제공합니다.

IBackgroundTaskInstance2

백그라운드 작업 instance 대한 액세스를 제공합니다. IBackgroundTaskInstance 인터페이스에서 상속되고 GetThrottleCount 메서드를 추가합니다.

IBackgroundTaskInstance4

사용자에 대한 정보를 포함하여 백그라운드 작업 instance 대한 액세스를 제공합니다.

IBackgroundTaskRegistration

등록된 백그라운드 작업에 대한 액세스를 제공합니다.

IBackgroundTaskRegistration2

등록된 백그라운드 작업에 대한 액세스를 제공합니다. IBackgroundTaskRegistration 인터페이스에서 상속되고 Trigger 속성을 추가합니다.

IBackgroundTaskRegistration3

관련 백그라운드 작업 그룹의 일부로 등록된 백그라운드 작업을 나타냅니다.

IBackgroundTrigger

트리거 이벤트의 기본 인터페이스를 나타냅니다.

열거형

AlarmAccessStatus

사용자가 앱에 알람을 설정할 수 있는 권한을 부여했는지 여부를 나타냅니다.

ApplicationTriggerResult

백그라운드 작업을 트리거하는 요청의 결과입니다. RequestAsync 메서드는 이 열거형 형식의 값을 반환합니다.

BackgroundAccessRequestKind

앱에서 요청할 수 있는 백그라운드 작업 수준을 지정합니다.

BackgroundAccessStatus

이 열거형은 백그라운드 작업을 수행하는 앱의 기능을 지정합니다.

앱은 백그라운드 작업을 등록하기 전에 BackgroundExecutionManager.RequestAccessAsync 를 성공적으로 호출해야 합니다.

BackgroundTaskCancellationReason

백그라운드 작업을 취소하는 이유를 지정합니다.

BackgroundTaskThrottleCounter

GetThrottleCount 요청에서 에 대한 검사 제한 횟수의 유형을 나타냅니다.

BackgroundWorkCostValue

백그라운드 작업을 수행하는 데 드는 현재 비용을 나타냅니다. 수행할 수 있는 작업의 양에 대한 백그라운드 작업에 대한 힌트로 사용됩니다.

CustomSystemEventTriggerRecurrence

CustomSystemEventTrigger를 활성화할 수 있는 시기를 지정합니다.

DeviceTriggerResult

디바이스 백그라운드 작업 작업이 허용 또는 거부되었는지 여부를 나타내며, 거부되었는지 여부를 지정합니다.

EnergyUseLevel

앱이 일시 중단된 경우에도 앱이 앱 코드를 실행하도록 백그라운드 작업을 예약할 수 있도록 합니다.

백그라운드 작업은 사용자 상호 작용이 필요하지 않거나 알림 작업을 처리하는 작은 작업 항목을 위한 것입니다. 백그라운드 작업에 적합한 시나리오에는 메일 다운로드, 들어오는 채팅 메시지에 대한 알림 메시지 표시 또는 시스템 조건의 변경에 대응하는 작업이 포함됩니다.

백그라운드 작업(JavaScript 및 HTML 사용)을 사용하여 앱 지원 또는 백그라운드 작업으로 앱 지원을 참조하여 백그라운드 작업 구현에 대한 지침을 참조하세요. 백그라운드 작업을 구현하는 방법을 보여 주는 예제 코드는 백그라운드 작업 샘플을 참조하세요.

LocationTriggerType

위치 백그라운드 작업 트리거에 대한 위치 이벤트의 유형을 나타냅니다.

MediaProcessingTriggerResult

MediaProcessingTrigger.RequestAsync 호출의 결과를 지정합니다.

SystemConditionType

백그라운드 작업을 실행하기 위해 적용되어야 하는 시스템 조건을 지정합니다. 시스템 조건이 있는 백그라운드 작업이 트리거되면 조건이 충족될 때까지 작업이 실행되지 않습니다.

SystemTriggerType

백그라운드 작업을 트리거하는 데 사용할 수 있는 시스템 이벤트를 지정합니다.

대리자

BackgroundTaskCanceledEventHandler

백그라운드 작업의 취소를 처리하는 메서드를 나타냅니다.

BackgroundTaskCompletedEventHandler

백그라운드 작업에 대한 완료 이벤트를 처리하는 메서드를 나타냅니다.

BackgroundTaskProgressEventHandler

백그라운드 작업에 대한 진행률 업데이트 이벤트를 처리하는 메서드를 나타냅니다.

추가 정보