DeviceServicingTrigger Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.Background

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.

• Detail selengkapnya tentang persyaratan kebijakan tugas latar belakang DeviceServicingTrigger dapat ditemukan di bagian halaman ini.
• Untuk informasi tentang menggunakan DeviceServicingTrigger, lihat Sinkronisasi dan pembaruan perangkat untuk aplikasi perangkat UWP.
• Untuk informasi tentang menggunakan DeviceUseTrigger, lihat Mengakses sensor dan perangkat dari tugas latar belakang.

Penting

Pemicu ini tidak dapat digunakan dengan tugas latar belakang proses tunggal.

public ref class DeviceServicingTrigger sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DeviceServicingTrigger final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DeviceServicingTrigger

function DeviceServicingTrigger()

Public NotInheritable Class DeviceServicingTrigger

Warisan

Object Platform::Object IInspectable DeviceServicingTrigger

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IBackgroundTrigger

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Kebijakan tertentu diberlakukan oleh Windows untuk memastikan persetujuan pengguna saat memperbarui perangkat periferal mereka. Kebijakan tambahan diberlakukan untuk mempertahankan masa pakai baterai pengguna saat menyinkronkan dan memperbarui perangkat periferal. Tugas latar belakang DeviceServicingTrigger tunduk pada kebijakan berikut:

• Tugas latar belakang DeviceServicingTrigger memerlukan persetujuan pengguna setiap kali dipicu.
• Perangkat Anda harus terhubung atau dipasangkan dengan PC dan tersedia saat meminta DeviceServicingTrigger.
• Aplikasi Anda diizinkan maksimal 30 menit (jam dinding) aktivitas latar belakang untuk pembaruan perangkat dengan DeviceServicingTrigger
• Aplikasi Anda tidak diizinkan untuk meminta tugas latar belakang DeviceServicingTrigger saat aplikasi Anda tidak berada di latar depan.
• Aplikasi Anda hanya dapat menjalankan satu DeviceServicingTrigger pada satu waktu. Mencoba membuat DeviceServicingTrigger kedua akan menimbulkan pengecualian.
• Baterai PC harus memiliki kapasitas lebih dari 33% yang tersisa, atau PC harus menggunakan daya A/C.
• Tugas latar belakang DeviceServicingTrigger dapat dibatalkan oleh Windows ketika persyaratan kebijakan ini tidak lagi terpenuhi, termasuk jumlah maksimum waktu latar belakang jam dinding.

Catatan

Aplikasi UWP yang berniat menggunakan tugas latar belakang DeviceServicingTrigger juga harus menjadi aplikasi istimewa untuk perangkat. Hak istimewa aplikasi ditentukan dalam metadata perangkat untuk perangkat periferal oleh produsen perangkat. Ketika aplikasi UWP mencoba memicu tugas latar belakang DeviceServicingTrigger , Windows akan memvalidasi bahwa aplikasi panggilan adalah aplikasi istimewa untuk perangkat yang coba diperbarui. Jika aplikasi tidak diistimewakan untuk perangkat, maka Windows tidak akan mengizinkan tugas latar belakang diluncurkan.

Untuk informasi terperinci tentang hak istimewa aplikasi dan pemeriksaan kebijakan yang diberlakukan oleh Windows untuk tugas latar belakang DeviceServicingTrigger lihat Sinkronisasi dan pembaruan perangkat untuk aplikasi perangkat UWP.

Konstruktor

DeviceServicingTrigger()

Konstruktor untuk DeviceServicingTrigger. Tidak mengambil parameter.

Metode

RequestAsync(String, TimeSpan)

Memicu tugas latar belakang (pengaturan atau pembaruan firmware) dan mengembalikan DeviceTriggerResult yang menunjukkan keberhasilan atau kegagalan permintaan pemicu. Mengambil string DeviceInformation.ID dan perkiraan waktu opsional tugas latar belakang akan berjalan. Jika aplikasi Anda tidak dapat menentukan perkiraan waktu yang sesuai, berikan nol sebagai perkiraan waktu.

RequestAsync(String, TimeSpan, String)

Memicu tugas latar belakang (pengaturan atau pembaruan firmware) dan mengembalikan DeviceTriggerResult yang menunjukkan keberhasilan atau kegagalan permintaan pemicu. Mengambil string DeviceInformation.ID , perkiraan waktu opsional tugas latar belakang akan berjalan, dan string khusus aplikasi opsional diteruskan ke tugas latar belakang yang mengidentifikasi operasi perangkat mana yang akan dilakukan. Jika aplikasi Anda tidak dapat menentukan perkiraan waktu yang sesuai, berikan nol sebagai perkiraan waktu.

Lihat juga

• IBackgroundTrigger