Bagikan melalui


Windows.ApplicationModel.Background Ruang nama

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.

Aplikasi harus berhasil memanggil BackgroundExecutionManager.RequestAccessAsync sebelum mendaftarkan tugas 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.

Lihat juga