Windows.ApplicationModel.Background 네임스페이스
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
앱이 일시 중단된 경우에도 앱이 앱 코드를 실행하도록 백그라운드 작업을 예약할 수 있도록 합니다.
백그라운드 작업은 사용자 상호 작용이 필요하지 않거나 알림 작업을 처리하는 작은 작업 항목을 위한 것입니다. 백그라운드 작업에 적합한 시나리오에는 메일 다운로드, 들어오는 채팅 메시지에 대한 알림 메시지 표시 또는 시스템 조건의 변경에 대응하는 작업이 포함됩니다.
백그라운드 작업(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 |
로컬 데이터 카운터가 모바일 광대역 인터페이스의 사용량(전송 및 수신된 바이트)이 실행 가능한 임계값에 의해 변경된 것으로 추정할 때 백그라운드 작업을 시작하는 트리거를 나타냅니다. |
| 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 |
이 열거형은 백그라운드 작업을 수행하는 앱의 기능을 지정합니다.
|
| BackgroundTaskCancellationReason |
백그라운드 작업을 취소하는 이유를 지정합니다. |
| BackgroundTaskThrottleCounter |
GetThrottleCount 요청에서 에 대한 검사 제한 횟수의 유형을 나타냅니다. |
| BackgroundWorkCostValue |
백그라운드 작업을 수행하는 데 드는 현재 비용을 나타냅니다. 수행할 수 있는 작업의 양에 대한 백그라운드 작업에 대한 힌트로 사용됩니다. |
| CustomSystemEventTriggerRecurrence |
CustomSystemEventTrigger를 활성화할 수 있는 시기를 지정합니다. |
| DeviceTriggerResult |
디바이스 백그라운드 작업 작업이 허용 또는 거부되었는지 여부를 나타내며, 거부되었는지 여부를 지정합니다. |
| EnergyUseLevel |
앱이 일시 중단된 경우에도 앱이 앱 코드를 실행하도록 백그라운드 작업을 예약할 수 있도록 합니다. 백그라운드 작업은 사용자 상호 작용이 필요하지 않거나 알림 작업을 처리하는 작은 작업 항목을 위한 것입니다. 백그라운드 작업에 적합한 시나리오에는 메일 다운로드, 들어오는 채팅 메시지에 대한 알림 메시지 표시 또는 시스템 조건의 변경에 대응하는 작업이 포함됩니다. 백그라운드 작업(JavaScript 및 HTML 사용)을 사용하여 앱 지원 또는 백그라운드 작업으로 앱 지원을 참조하여 백그라운드 작업 구현에 대한 지침을 참조하세요. 백그라운드 작업을 구현하는 방법을 보여 주는 예제 코드는 백그라운드 작업 샘플을 참조하세요. |
| LocationTriggerType |
위치 백그라운드 작업 트리거에 대한 위치 이벤트의 유형을 나타냅니다. |
| MediaProcessingTriggerResult |
MediaProcessingTrigger.RequestAsync 호출의 결과를 지정합니다. |
| SystemConditionType |
백그라운드 작업을 실행하기 위해 적용되어야 하는 시스템 조건을 지정합니다. 시스템 조건이 있는 백그라운드 작업이 트리거되면 조건이 충족될 때까지 작업이 실행되지 않습니다. |
| SystemTriggerType |
백그라운드 작업을 트리거하는 데 사용할 수 있는 시스템 이벤트를 지정합니다. |
대리자
| BackgroundTaskCanceledEventHandler |
백그라운드 작업의 취소를 처리하는 메서드를 나타냅니다. |
| BackgroundTaskCompletedEventHandler |
백그라운드 작업에 대한 완료 이벤트를 처리하는 메서드를 나타냅니다. |
| BackgroundTaskProgressEventHandler |
백그라운드 작업에 대한 진행률 업데이트 이벤트를 처리하는 메서드를 나타냅니다. |
추가 정보
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기