BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) Metode

Definisi

Ruang nama:

Windows.ApplicationModel.Background

Mengatur pemicu peristiwa untuk tugas latar belakang.

public:
 virtual void SetTrigger(IBackgroundTrigger ^ trigger) = SetTrigger;

void SetTrigger(IBackgroundTrigger const& trigger);

public void SetTrigger(IBackgroundTrigger trigger);

function setTrigger(trigger)

Public Sub SetTrigger (trigger As IBackgroundTrigger)

Parameter

trigger

IBackgroundTrigger

Instans objek pemicu peristiwa seperti SystemTrigger, TimeTrigger, atau NetworkOperatorNotificationTrigger.

Keterangan

Selain menentukan jenis pemicu peristiwa untuk tugas latar belakang, aplikasi juga harus mengaktifkan tugas latar belakang yang menggunakan jenis pemicu peristiwa di <Extensions><Extension><BackgroundTasks> bagian manifesnya. Jenis yang valid meliputi yang berikut ini:

• <Task Type="audio"/>
• <Task Type="timer"/>
• <Task Type="systemEvent"/>
• <Task Type="pushNotification"/>
• <Task Type="realTimeCommunication"/>

Jika jenis tugas latar belakang tidak ditentukan atau ditentukan secara salah dalam manifes, panggilan yang mencoba menggunakan tugas latar belakang semacam itu akan gagal.

Daftar pemicu:

Pemicu	Deskripsi
ActivitySensorTrigger	Digunakan saat aplikasi Anda perlu merespons sensor aktivitas.
AppBroadcastTrigger	Picu tugas latar belakang untuk dijalankan saat aplikasi memulai siaran gameplay.
ApplicationTrigger	Picu tugas latar belakang dari dalam aplikasi Anda.
AppointmentStoreNotificationTrigger	Pemicu untuk meluncurkan tugas latar belakang untuk memproses perubahan pada penyimpanan janji temu.
BluetoothLEAdvertisementPublisherTrigger	Mewakili pemicu yang terdaftar untuk mengiklankan iklan Bluetooth LE di latar belakang.
CachedFileUpdaterTrigger	Picu tugas latar belakang untuk mengaktifkan kontrak Cache File Updater.
ChatMessageNotificationTrigger	Mewakili pemicu yang diaktifkan saat ada pemberitahuan untuk pesan teks.
ChatMessageReceivedNotificationTrigger	Mewakili pemicu yang meluncurkan tugas latar belakang yang menangani pesan masuk yang mungkin perlu difilter sesuai dengan kontennya.
CommunicaionBlockingAppSetAsActiveTrigger	Mewakili pemicu untuk mengaktifkan aplikasi pemblokiran komunikasi saat dipilih sebagai aplikasi pemblokiran pilihan.
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.
CustomSystemEventTrigger	Pemicu sistem kustom yang dapat Anda tentukan .
DeviceConnectionChangeTrigger	Mewakili peristiwa yang dapat dipicu aplikasi untuk memulai pembaruan jangka panjang (firmware atau pengaturan) perangkat.
DeviceManufacturerNotificationTrigger	Mewakili peristiwa yang dapat dipicu aplikasi untuk memulai pembaruan jangka panjang (firmware atau pengaturan) perangkat.
DeviceUseTrigger	Mewakili peristiwa yang dapat dipicu aplikasi Windows Runtime untuk memulai operasi jangka panjang dengan perangkat atau sensor.
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	Membangun layanan Atribut Generik (GATT) yang dapat dipertahankan di latar belakang.
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 yang hanya berjalan ketika sistem terhubung ke daya AC.
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.
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.
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.
MobileBroadbandRegistrationStateChangeTrigger	Mewakili pemicu yang menunjukkan kapan status pendaftaran broadband seluler telah berubah. Misalnya, pemicu ini diaktifkan saat perangkat seluler beralih ke atau dari Roaming.
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.
NetworkOperatorHotspotAuthenticationTrigger	Mewakili pemicu autentikasi hotspot operator jaringan seluler.
NetworkOperatorNotificationTrigger	Mewakili pemicu pemberitahuan operator jaringan seluler.
PaymentAppCanMakePaymentTrigger	Mewakili pemicu PaymentAppCanMakePayment.
PhoneTrigger	Mewakili peristiwa telepon yang memicu tugas latar belakang.
PushNotificationTrigger	Mewakili pemicu 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 dihapus, 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.