CustomSensor.ReportInterval Properti

Definisi

Ruang nama:

Windows.Devices.Sensors.Custom

Mendapatkan atau mengatur interval laporan saat ini untuk sensor.

public:
 property unsigned int ReportInterval { unsigned int get(); void set(unsigned int value); };

uint32_t ReportInterval();

void ReportInterval(uint32_t value);

public uint ReportInterval { get; set; }

var uInt32 = customSensor.reportInterval;
customSensor.reportInterval = uInt32;

Public Property ReportInterval As UInteger

Nilai Properti

UInt32

unsigned int

uint32_t

Interval laporan saat ini untuk sensor.

Keterangan

Interval laporan ditentukan dalam milidetik.

Interval laporan akan diatur ke nilai default yang akan bervariasi berdasarkan implementasi driver sensor. Jika aplikasi Anda tidak ingin menggunakan nilai default ini, atur interval laporan ke nilai bukan nol sebelum mendaftarkan penanganan aktivitas atau memanggil GetCurrentReading. Sensor kemudian akan mencoba mengalokasikan sumber daya untuk memenuhi persyaratan aplikasi tetapi sensor juga harus menyeimbangkan kebutuhan aplikasi lain menggunakan sensor.

Perubahan pada interval laporan setelah penanganan aktivitas terdaftar atau GetCurrentReading telah dipanggil dapat berlaku untuk pengiriman pembacaan sensor berikutnya.

Sebaliknya, ketika aplikasi selesai dengan sensor, sebaiknya mengembalikan sensor secara eksplisit ke interval laporan defaultnya dengan mengaturnya ke nol. Ini penting untuk konservasi daya, terutama ketika menggunakan bahasa yang dapat menjaga objek sensor tetap aktif selama periode yang tidak terbatas sebelum pengumpulan sampah.

Kami menyarankan agar aplikasi berkonsultasi dengan properti MinimumReportInterval sebelum mengatur interval laporan untuk memastikan bahwa sensor dapat mematuhi interval laporan yang diminta. Mengatur nilai di bawah interval minimum yang didukung akan memicu pengecualian atau memiliki hasil yang tidak ditentukan.

Meskipun aplikasi dapat mengatur nilai ini untuk meminta interval laporan tertentu, driver akan menentukan interval laporan aktual, berdasarkan logika internal. Misalnya, driver mungkin menggunakan interval laporan terpendek yang diminta oleh pemanggil apa pun.

Mengatur nilai nol meminta driver untuk menggunakan interval laporan defaultnya. Seperti halnya meminta interval tertentu, driver dapat memilih interval yang berbeda berdasarkan permintaan klien lain dan logika internal.

Platform sensor kustom secara otomatis mengatur sensitivitas perubahan untuk sensor kustom berdasarkan interval laporan saat ini. Tabel ini menentukan nilai sensitivitas perubahan untuk interval tertentu.

Interval laporan saat ini (ditentukan dalam milidetik)	Mengubah sensitivitas (ditentukan sebagai gaya G)
1 mdtk – 16 mdtk	0,01 G
17 mdtk – 32 mdtk	0,02 G
>= 33 mdtk	0,05 G