Windows.ApplicationModel.Background Ruang nama
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Memungkinkan aplikasi menjadwalkan tugas latar belakang untuk menjalankan kode aplikasi bahkan saat aplikasi ditangguhkan.
Tugas latar belakang ditujukan untuk item kerja kecil yang tidak memerlukan interaksi pengguna atau untuk menangani tindakan toast. Skenario yang sesuai untuk tugas latar belakang termasuk mengunduh email, menampilkan pemberitahuan toast untuk pesan obrolan masuk, atau bereaksi terhadap perubahan kondisi sistem.
Lihat Mendukung aplikasi Anda dengan tugas latar belakang ( menggunakan JavaScript dan HTML) atau Mendukung aplikasi Anda dengan tugas latar belakang untuk panduan tentang menerapkan tugas latar belakang. Misalnya kode yang memperlihatkan cara menerapkan tugas latar belakang, lihat Sampel Tugas Latar Belakang.
Kelas
| ActivitySensorTrigger |
Mewakili pemicu yang diaktifkan saat ActivitySensor menerima input. Ini digunakan ketika aplikasi Anda perlu merespons sensor aktivitas. |
| AlarmApplicationManager |
Meminta izin dari pengguna untuk mengatur alarm, dan mengambil status izin pengguna untuk aplikasi untuk mengatur alarm. |
| AppBroadcastTrigger |
Mewakili peristiwa yang memicu tugas latar belakang untuk dijalankan saat aplikasi memulai siaran gameplay. |
| AppBroadcastTriggerProviderInfo |
Menyediakan informasi tentang aplikasi yang menyiarkan gameplay seperti logo, nama tampilan, dan karakteristik videonya. |
| ApplicationTrigger |
Ini memungkinkan Anda untuk secara terprogram memicu tugas latar belakang dari dalam aplikasi Anda. |
| ApplicationTriggerDetails |
Detail ApplicationTrigger. |
| AppointmentStoreNotificationTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang untuk memproses perubahan pada penyimpanan janji temu. |
| BackgroundExecutionManager |
Kelola izin untuk menjalankan tugas latar belakang. |
| BackgroundTaskBuilder |
Mewakili tugas latar belakang untuk mendaftar dengan sistem. |
| BackgroundTaskCompletedEventArgs |
Mewakili informasi penyelesaian untuk tugas pada saat pemberitahuan penyelesaian dikirim. |
| BackgroundTaskDeferral |
Mewakili penangguhan tugas latar belakang yang dikembalikan oleh metode IBackgroundTaskInstance.GetDeferral . |
| BackgroundTaskProgressEventArgs |
Mewakili informasi kemajuan untuk tugas pada saat pemberitahuan pembaruan kemajuan dikirim. |
| BackgroundTaskRegistration |
Mewakili tugas latar belakang yang telah didaftarkan dengan sistem. |
| BackgroundTaskRegistrationGroup |
Menyediakan semantik pengelompokan sehingga pendaftaran tugas latar belakang dapat dipertahankan secara terpisah. |
| BackgroundWorkCost |
Mengambil petunjuk tentang ketersediaan sumber daya untuk tugas latar belakang. Tugas latar belakang dapat menggunakan petunjuk ini untuk memutuskan berapa banyak pekerjaan yang harus dilakukan saat diaktifkan. |
| BluetoothLEAdvertisementPublisherTrigger |
Mewakili pemicu yang terdaftar untuk mengiklankan iklan Bluetooth LE di latar belakang. |
| BluetoothLEAdvertisementWatcherTrigger |
Mewakili pemicu yang terdaftar untuk memindai iklan Bluetooth LE di latar belakang. |
| CachedFileUpdaterTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang untuk mengaktifkan kontrak Cache File Updater. |
| CachedFileUpdaterTriggerDetails |
Menyediakan detail tentang operasi file yang di-cache yang memanggil pemicu. |
| ChatMessageNotificationTrigger |
Mewakili pemicu yang diaktifkan saat ada pemberitahuan untuk pesan teks. |
| ChatMessageReceivedNotificationTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang yang menangani pesan masuk apa pun yang mungkin perlu difilter sesuai dengan kontennya. Untuk informasi selengkapnya tentang pemfilteran pesan, lihat Windows.ApplicationModel.CommunicationBlocking. |
| CommunicationBlockingAppSetAsActiveTrigger |
Mewakili pemicu untuk mengaktifkan aplikasi pemblokiran komunikasi saat dipilih sebagai aplikasi pemblokiran pilihan. Pengguna dapat memiliki beberapa aplikasi pemblokiran komunikasi yang diinstal pada satu waktu. Pemicu ini digunakan untuk memberi tahu aplikasi bahwa aplikasi telah dipilih sebagai aplikasi pemblokiran komunikasi aktif. Untuk informasi selengkapnya tentang API pemblokiran komunikasi, lihat Windows.ApplicationModel.CommunicationBlocking. |
| ContactStoreNotificationTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang untuk memproses perubahan pada penyimpanan kontak. |
| ContentPrefetchTrigger |
Menyediakan kemampuan untuk menjalankan handler kustom saat melakukan prefetching sumber daya web. |
| ConversationalAgentTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang untuk memproses komunikasi asisten digital melalui platform Windows Agent Activation Runtime (AAR). |
| CustomSystemEventTrigger |
Kelas ini memungkinkan Anda menentukan pemicu sistem kustom sehingga Anda dapat mendaftarkannya dan merespons ketika dipicu oleh sistem. |
| DeviceConnectionChangeTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang saat status koneksi perangkat berubah. |
| DeviceManufacturerNotificationTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang untuk mengaktifkan operasi produsen perangkat. |
| DeviceServicingTrigger |
Mewakili peristiwa yang dapat dipicu aplikasi untuk memulai pembaruan yang berjalan lama (firmware atau pengaturan) perangkat. Windows 8.1 memungkinkan Anda mengembangkan aplikasi UWP untuk perangkat periferal Anda yang berkomunikasi melalui USB, HID, dan Bluetooth. Misalnya, pengguna mungkin perlu menyinkronkan konten di PC ke atau dari perangkat, atau melakukan pembaruan jangka panjang ke perangkat itu sendiri seperti pengaturan atau pembaruan firmware. Windows 8.1 menyediakan dua tugas latar belakang dan API terkait yang memungkinkan perangkat Anda untuk menyinkronkan dan memperbarui di latar belakang: DeviceServicingTrigger dan DeviceUseTrigger. Topik ini menyediakan informasi referensi API untuk DeviceServicingTrigger - untuk info tentang penggunaan pemicu ini dalam konteks aplikasi perangkat, lihat Sinkronisasi dan pembaruan perangkat untuk aplikasi perangkat UWP. Tugas latar belakang DeviceServicingTrigger memungkinkan aplikasi UWP Anda yang berinteraksi dengan perangkat periferal Anda untuk melakukan pembaruan perangkat yang berjalan lama saat aplikasi Anda ditangguhkan, misalnya transfer pengaturan atau pembaruan firmware. Memperbarui perangkat Anda di latar belakang memerlukan persetujuan pengguna setiap kali tugas latar belakang digunakan. Tidak seperti tugas latar belakang DeviceUseTrigger , tugas latar belakang DeviceServicingTrigger memungkinkan boot ulang dan putuskan sambungan perangkat dan memungkinkan aktivitas latar belakang maksimum 30 menit.
Penting Pemicu ini tidak dapat digunakan dengan tugas latar belakang proses tunggal. |
| DeviceUseTrigger |
Mewakili peristiwa yang dapat dipicu aplikasi Windows Runtime untuk memulai operasi yang berjalan lama dengan perangkat atau sensor. DeviceUseTrigger memungkinkan aplikasi Windows Runtime Anda mengakses sensor dan perangkat periferal di latar belakang, bahkan ketika aplikasi latar depan Anda ditangguhkan. Misalnya, bergantung pada tempat aplikasi Anda berjalan, aplikasi dapat menggunakan tugas latar belakang untuk menyinkronkan data dengan perangkat atau sensor pemantauan. Kelas ini dapat digunakan di aplikasi UWP dan aplikasi Windows Phone 8.x. Namun, tugas latar belakang DeviceUseTrigger mendukung API yang berbeda, dan tunduk pada kebijakan yang berbeda, tergantung di mana ia berjalan (PC atau telepon). Untuk mempelajari selengkapnya tentang perbedaan ini, lihat Mengakses sensor dan perangkat dari tugas latar belakang. Penting Pemicu ini tidak dapat digunakan dengan tugas latar belakang proses tunggal. Untuk sampel yang menunjukkan cara menggunakan DeviceUseTrigger di PC, lihat sampel perangkat USB Kustom. Untuk sampel telepon, lihat sampel Sensor Latar Belakang. |
| DeviceWatcherTrigger |
Mewakili peristiwa yang menyebabkan tugas latar belakang berjalan ketika perubahan terjadi pada daftar perangkat. Dikembalikan oleh GetBackgroundTrigger. |
| EmailStoreNotificationTrigger |
Mewakili pemicu yang memungkinkan pemberitahuan perubahan pada penyimpanan email. |
| GattCharacteristicNotificationTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang saat pemberitahuan perubahan masuk diterima untuk karakteristik Bluetooth LE GATT. |
| GattServiceProviderTrigger |
Membuat layanan Atribut Generik (GATT) yang dapat dipertahankan di latar belakang. |
| GattServiceProviderTriggerResult |
Kelas ini berisi pemicu yang dibuat oleh GattServiceProviderTrigger.CreateAsync(). |
| GeovisitTrigger |
Mewakili peristiwa yang memicu tugas latar belakang terkait Kunjungan. |
| LocationTrigger |
Mewakili peristiwa lokasi yang memicu tugas latar belakang. Ini digunakan untuk Geofencing. |
| MaintenanceTrigger |
Mewakili pemicu pemeliharaan. |
| MediaProcessingTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang untuk melakukan pemrosesan media. |
| MobileBroadbandDeviceServiceNotificationTrigger |
Mewakili pemicu yang diaktifkan saat jaringan mengirim perintah alat SIM. Aplikasi yang menerima pemberitahuan ini kemudian memproses perintah alat SIM. Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberikan akses istimewa oleh operator jaringan seluler. Untuk informasi selengkapnya, lihat Broadband seluler. |
| MobileBroadbandPcoDataChangeTrigger |
Mewakili peristiwa perubahan opsi konfigurasi protokol seluler yang memicu tugas latar belakang untuk dijalankan. |
| MobileBroadbandPinLockStateChangeTrigger |
Mewakili pemicu yang menunjukkan kapan status kunci PIN SIM telah berubah. Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberikan akses istimewa oleh operator jaringan seluler. Untuk informasi selengkapnya, lihat Broadband seluler. |
| MobileBroadbandRadioStateChangeTrigger |
Mewakili pemicu yang menunjukkan kapan status radio broadband seluler telah berubah. Misalnya, pemicu ini diaktifkan saat perangkat seluler beralih ke atau dari mode pesawat terbang. Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberikan akses istimewa oleh operator jaringan seluler. Untuk informasi selengkapnya, lihat Broadband seluler. |
| MobileBroadbandRegistrationStateChangeTrigger |
Mewakili pemicu yang menunjukkan kapan status pendaftaran broadband seluler telah berubah. Misalnya, pemicu ini diaktifkan saat perangkat seluler beralih ke atau dari Roaming. Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberikan akses istimewa oleh operator jaringan seluler. Untuk informasi selengkapnya, lihat Broadband seluler. |
| NetworkOperatorDataUsageTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang ketika penghitung data lokal memperkirakan penggunaan (byte yang dikirim dan diterima) pada antarmuka broadband seluler telah berubah oleh ambang batas yang dapat ditindaklanjuti. Catatan Fungsionalitas ini hanya tersedia untuk aplikasi operator seluler dan aplikasi UWP yang diberi akses istimewa oleh operator jaringan seluler. Jika Anda ingin menggunakan API ini dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda memerlukan persetujuan khusus. Untuk informasi selengkapnya, lihat bagian Kemampuan terbatas dalam topik Deklarasi kemampuan aplikasi , dan Broadband Seluler. |
| NetworkOperatorHotspotAuthenticationTrigger |
Mewakili pemicu autentikasi hotspot operator jaringan seluler. Catatan Aplikasi hanya dapat membuat instans objek ini dan mendaftar untuk peristiwa autentikasi hotspot setelah profil WLAN disediakan yang mereferensikan aplikasi ini untuk menangani autentikasi hotspot. Untuk informasi selengkapnya, lihat Integrasi Windows 8 untuk Operator Hotspot Nirkabel. |
| NetworkOperatorNotificationTrigger |
Mewakili pemicu pemberitahuan operator jaringan seluler. |
| PaymentAppCanMakePaymentTrigger |
Kelas ini mewakili pemicu PaymentAppCanMakePayment. |
| PhoneTrigger |
Mewakili peristiwa telepon yang memicu tugas latar belakang. |
| PushNotificationTrigger |
Mewakili objek yang memanggil item kerja latar belakang pada aplikasi sebagai respons terhadap penerimaan pemberitahuan mentah. |
| RcsEndUserMessageAvailableTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang saat pesan Rich Communication Services (RCS) baru tersedia. |
| RfcommConnectionTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang saat koneksi masuk atau keluar RFCOMM dibuat. |
| SecondaryAuthenticationFactorAuthenticationTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang atas nama perangkat pendamping. |
| SensorDataThresholdTrigger |
Mewakili pemicu yang merespons saat batas ambang untuk sensor disilangkan. |
| SmartCardTrigger |
Mewakili peristiwa yang dipicu oleh kartu pintar. |
| SmsMessageReceivedTrigger |
Mewakili pemicu yang dimunculkan ketika pesan SMS telah tiba. |
| SocketActivityTrigger |
Mewakili pemicu yang meluncurkan tugas latar belakang untuk menangani aktivitas soket. |
| StorageLibraryChangeTrackerTrigger |
Mewakili perubahan file dalam StorageFolder yang memicu tugas latar belakang untuk dijalankan. |
| StorageLibraryContentChangedTrigger |
Membuat pemicu yang akan diaktifkan saat file diubah dalam pustaka tertentu. |
| SystemCondition |
Mewakili kondisi sistem yang harus berlaku agar tugas latar belakang berjalan. |
| SystemTrigger |
Mewakili peristiwa sistem yang memicu tugas latar belakang untuk dijalankan. |
| TetheringEntitlementCheckTrigger |
Mewakili peristiwa tethering yang memicu tugas latar belakang untuk dijalankan. |
| TimeTrigger |
Mewakili peristiwa waktu yang memicu tugas latar belakang untuk dijalankan. |
| ToastNotificationActionTrigger |
Mewakili peristiwa yang menyebabkan tugas latar belakang berjalan saat pengguna melakukan tindakan pada pemberitahuan toast interaktif. |
| ToastNotificationHistoryChangedTrigger |
Mewakili peristiwa yang menyebabkan tugas latar belakang berjalan saat riwayat pemberitahuan toast untuk aplikasi dibersihkan, saat satu atau beberapa pemberitahuan toast ditambahkan atau dihapus dari riwayat pemberitahuan untuk aplikasi, atau saat satu atau beberapa pemberitahuan toast untuk aplikasi kedaluwarsa dan dihapus dari riwayat pemberitahuan. |
| UserNotificationChangedTrigger |
Mewakili pemicu yang diaktifkan saat UserNotification ditambahkan atau dihapus. |
| WiFiOnDemandHotspotConnectTrigger |
Mewakili peristiwa yang menyebabkan tugas latar belakang berjalan ketika pengguna ingin terhubung ke jaringan hotspot sesuai permintaan tertentu. Kode tugas latar belakang Anda harus mentransmisikan nilai properti IBackgroundTaskInstance.TriggerDetails ke WiFiOnDemandHotspotConnectTriggerDetails. Catatan Jika Anda ingin menggunakan API ini di aplikasi UWP, dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (kemampuan Jaringan Sesuai Permintaan). Untuk informasi selengkapnya, lihat Kemampuan kustom. Kemampuan Jaringan Sesuai Permintaan hanya akan tersedia untuk pengembang aplikasi yang membangun skenario hotspot Wi-Fi end-to-end antara perangkat keras berkemampuan tethering dan PC Windows. |
| WiFiOnDemandHotspotUpdateMetadataTrigger |
Mewakili peristiwa yang menyebabkan tugas latar belakang berjalan saat pengguna membuka sistem operasi (OS) Wi-Fi daftar jaringan, seolah-olah terhubung ke jaringan Wi-Fi baru. Catatan Jika Anda ingin menggunakan API ini di aplikasi UWP, dan memublikasikan aplikasi Anda ke Microsoft Store, maka Anda harus meminta persetujuan khusus untuk menggunakan kemampuan kustom Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (kemampuan Jaringan Sesuai Permintaan). Untuk informasi selengkapnya, lihat Kemampuan kustom. Kemampuan Jaringan Sesuai Permintaan hanya akan tersedia untuk pengembang aplikasi yang membangun skenario hotspot Wi-Fi end-to-end antara perangkat keras berkemampuan tethering dan PC Windows. |
Antarmuka
| IBackgroundCondition |
Digunakan untuk memberlakukan jenis objek kondisi sistem. |
| IBackgroundTask |
Menyediakan metode untuk melakukan pekerjaan tugas latar belakang. |
| IBackgroundTaskInstance |
Menyediakan akses ke instans tugas latar belakang. |
| IBackgroundTaskInstance2 |
Menyediakan akses ke instans tugas latar belakang. Mewarisi dari antarmuka IBackgroundTaskInstance dan menambahkan metode GetThrottleCount . |
| IBackgroundTaskInstance4 |
Menyediakan akses ke instans tugas latar belakang termasuk informasi tentang pengguna. |
| IBackgroundTaskRegistration |
Menyediakan akses ke tugas latar belakang terdaftar. |
| IBackgroundTaskRegistration2 |
Menyediakan akses ke tugas latar belakang terdaftar. Mewarisi dari antarmuka IBackgroundTaskRegistration dan menambahkan properti Pemicu . |
| IBackgroundTaskRegistration3 |
Mewakili tugas latar belakang yang telah didaftarkan sebagai bagian dari grup tugas latar belakang terkait. |
| IBackgroundTrigger |
Mewakili antarmuka dasar untuk peristiwa pemicu. |
Enum
| AlarmAccessStatus |
Menunjukkan apakah pengguna telah memberikan izin bagi aplikasi untuk mengatur alarm. |
| ApplicationTriggerResult |
Hasil permintaan untuk memicu tugas latar belakang. Metode RequestAsync mengembalikan nilai dari jenis enumerasi ini. |
| BackgroundAccessRequestKind |
Menentukan tingkat aktivitas latar belakang yang dapat diminta aplikasi. |
| BackgroundAccessStatus |
Enumerasi ini menentukan kemampuan aplikasi untuk melakukan aktivitas latar belakang.
|
| BackgroundTaskCancellationReason |
Menentukan alasan pembatalan tugas latar belakang. |
| BackgroundTaskThrottleCounter |
Menunjukkan jenis jumlah pembatasan untuk diperiksa dalam permintaan GetThrottleCount . |
| BackgroundWorkCostValue |
Menunjukkan biaya saat ini untuk melakukan pekerjaan latar belakang. Digunakan sebagai petunjuk untuk tugas latar belakang tentang berapa banyak pekerjaan yang dapat mereka lakukan. |
| CustomSystemEventTriggerRecurrence |
Menentukan kapan CustomSystemEventTrigger dapat diaktifkan. |
| DeviceTriggerResult |
Menunjukkan apakah operasi tugas latar belakang perangkat diizinkan atau ditolak, dan jika ditolak menentukan alasannya. |
| EnergyUseLevel |
Memungkinkan aplikasi menjadwalkan tugas latar belakang untuk menjalankan kode aplikasi bahkan saat aplikasi ditangguhkan. Tugas latar belakang ditujukan untuk item kerja kecil yang tidak memerlukan interaksi pengguna atau untuk menangani tindakan toast. Skenario yang sesuai untuk tugas latar belakang termasuk mengunduh email, menampilkan pemberitahuan toast untuk pesan obrolan masuk, atau bereaksi terhadap perubahan kondisi sistem. Lihat Mendukung aplikasi Anda dengan tugas latar belakang ( menggunakan JavaScript dan HTML) atau Mendukung aplikasi Anda dengan tugas latar belakang untuk panduan tentang menerapkan tugas latar belakang. Misalnya kode yang memperlihatkan cara menerapkan tugas latar belakang, lihat Sampel Tugas Latar Belakang. |
| LocationTriggerType |
Menunjukkan jenis peristiwa lokasi untuk pemicu tugas latar belakang lokasi. |
| MediaProcessingTriggerResult |
Menentukan hasil panggilan ke MediaProcessingTrigger.RequestAsync. |
| SystemConditionType |
Menentukan kondisi sistem yang harus berlaku agar tugas latar belakang berjalan. Jika tugas latar belakang dengan kondisi sistem dipicu, tugas tidak akan berjalan sampai kondisi terpenuhi. |
| SystemTriggerType |
Menentukan peristiwa sistem yang dapat digunakan untuk memicu tugas latar belakang. |
Delegasikan
| BackgroundTaskCanceledEventHandler |
Mewakili metode yang menangani pembatalan tugas latar belakang. |
| BackgroundTaskCompletedEventHandler |
Mewakili metode yang menangani peristiwa penyelesaian untuk tugas latar belakang. |
| BackgroundTaskProgressEventHandler |
Mewakili metode yang menangani peristiwa pembaruan kemajuan untuk tugas latar belakang. |