共用方式為


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

表示註冊以在背景公告藍牙 LE 公告的觸發程式。

BluetoothLEAdvertisementWatcherTrigger

表示註冊以掃描背景中藍牙 LE 公告的觸發程式。

CachedFileUpdaterTrigger

表示啟動背景工作的觸發程式,以啟用快取檔案更新程式合約。

CachedFileUpdaterTriggerDetails

提供有關叫用觸發程式之快取檔案作業的詳細資料。

ChatMessageNotificationTrigger

表示在有文字訊息通知時啟動的觸發程式。

ChatMessageReceivedNotificationTrigger

表示觸發程式,此觸發程式會啟動背景工作,以處理可能需要根據其內容篩選的任何傳入訊息。 如需篩選訊息的詳細資訊,請參閱 Windows.ApplicationModel.CommunicationBlocking

CommunicationBlockingAppSetAsActiveTrigger

表示在選取為慣用封鎖應用程式時啟動通訊封鎖應用程式的觸發程式。

使用者可以一次安裝多個通訊封鎖應用程式。 此觸發程式可用來讓應用程式知道它已選取為作用中的通訊封鎖應用程式。 如需有關通訊封鎖 API 的詳細資訊,請參閱 Windows.ApplicationModel.CommunicationBlocking

ContactStoreNotificationTrigger

表示啟動背景工作的觸發程式,以處理連絡人存放區的變更。

ContentPrefetchTrigger

提供預先擷取 Web 資源時執行自訂處理常式的功能。

ConversationalAgentTrigger

表示觸發程式,此觸發程式會啟動背景工作,以透過 Windows 平臺 Agent Activation Runtime (AAR) 處理數位助理通訊。

CustomSystemEventTrigger

這個類別可讓您指定自訂系統觸發程式,以便註冊自訂系統觸發程式,並在系統觸發時回應。

DeviceConnectionChangeTrigger

表示當裝置的線上狀態變更時啟動背景工作的觸發程式。

DeviceManufacturerNotificationTrigger

表示啟動背景工作的觸發程式,以啟用裝置製造商作業。

DeviceServicingTrigger

表示應用程式可以觸發的事件,以起始裝置 (韌體或設定) 長時間執行的更新。

Windows 8.1可讓您為透過 USB、HID 和藍牙通訊的周邊裝置開發 UWP 應用程式。 例如,使用者可能需要將電腦上的內容同步至裝置或從裝置同步處理,或執行裝置本身的長時間執行更新,例如設定或韌體更新。 Windows 8.1提供兩個背景工作和對應的 API,可讓您的裝置在背景同步和更新:DeviceServicingTrigger 和 DeviceUseTrigger。 本主題提供 DeviceServicingTrigger 的 API 參考資訊 - 如需在裝置應用程式內容中使用此觸發程式的資訊,請參閱 UWP 裝置應用程式的裝置同步和更新

DeviceServicingTrigger 背景工作可讓您的 UWP app 與您的周邊裝置互動,以在 app 暫停時執行長時間執行的裝置更新,例如設定傳輸或韌體更新。 在背景更新您的裝置時,每次使用背景工作時,都需要使用者核准。 不同于 DeviceUseTrigger 背景工作,DeviceServicingTrigger 背景工作允許裝置重新開機和中斷連線,並允許最多 30 分鐘的背景活動。

重要

此觸發程式無法與單一進程背景工作搭配使用。

DeviceUseTrigger

表示Windows 執行階段應用程式可以觸發的事件,以使用裝置或感應器起始長時間執行的作業。

DeviceUseTrigger可讓您Windows 執行階段應用程式存取背景中的感應器和周邊裝置,即使前景應用程式已暫止亦然。 例如,根據您的 App 在何處執行而定,它能夠使用背景工作,將資料與裝置或監視感應器同步。

這個類別可用於 UWP app 和 Windows Phone 8.x app。 不過, DeviceUseTrigger 背景工作支援不同的 API,而且受限於不同的原則,視其執行位置 (電腦或手機) 而定。 若要深入瞭解這些差異,請參閱 從背景工作存取感應器和裝置

重要

此觸發程式無法與單一進程背景工作搭配使用。

如需示範如何在電腦上使用 DeviceUseTrigger 的範例,請參閱 自訂 USB 裝置範例。 如需手機範例,請參閱 背景感應器範例

DeviceWatcherTrigger

表示當裝置清單發生變更時,導致背景工作執行的事件。 由 GetBackgroundTrigger傳回。

EmailStoreNotificationTrigger

表示觸發程式,可通知電子郵件存放區的變更。

GattCharacteristicNotificationTrigger

表示當收到藍牙 LE GATT 特性的傳入變更通知時,啟動背景工作的觸發程式。

GattServiceProviderTrigger

建構可在背景中保存的一般屬性 (GATT) 服務。

GattServiceProviderTriggerResult

這個類別包含 GattServiceProviderTrigger.CreateAsync () 所建立的觸發程式。

GeovisitTrigger

表示觸發 Visits 相關背景工作的事件。

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) 訊息可用時,啟動背景工作的觸發程式。

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 電腦之間的端對端 Wi-Fi 熱點案例。

WiFiOnDemandHotspotUpdateMetadataTrigger

表示當使用者開啟作業系統 (OS) Wi-Fi 網路清單時,導致背景工作執行的事件,就像連線到新的 Wi-Fi 網路一樣。

注意

如果您想要在 UWP 應用程式中使用此 API,並將您的應用程式發佈至 Microsoft Store,則必須要求特殊核准,才能使用自訂功能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (隨選網路功能) 。 如需詳細資訊,請參閱 自訂功能

隨選網路功能只會提供給應用程式開發人員使用,以建置可連線的硬體裝置與 Windows 電腦之間的端對端 Wi-Fi 熱點案例。

介面

IBackgroundCondition

用來強制執行系統條件物件類型。

IBackgroundTask

提供執行背景工作的方法。

IBackgroundTaskInstance

提供背景工作實例的存取權。

IBackgroundTaskInstance2

提供背景工作實例的存取權。 繼承自 IBackgroundTaskInstance 介面,並新增 GetThrottleCount 方法。

IBackgroundTaskInstance4

提供背景工作實例的存取權,包括使用者的相關資訊。

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

表示處理背景工作進度更新事件的方法。

另請參閱