Compass.ReportInterval Properti

Definisi

Ruang nama:

Windows.Devices.Sensors

Mendapatkan atau mengatur interval laporan saat ini untuk kompas.

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 = compass.reportInterval;
compass.reportInterval = uInt32;

Public Property ReportInterval As UInteger

Nilai Properti

UInt32

unsigned int

uint32_t

Interval laporan saat ini, dalam milidetik.

Keterangan

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

Perubahan pada interval laporan setelah penanganan aktivitas didaftarkan, atau GetCurrentReading telah dipanggil, mungkin berlaku untuk pengiriman pembacaan sensor berikutnya.

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

Aplikasi harus 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 menentukan interval laporan aktual, berdasarkan logika internal. Misalnya, driver mungkin menggunakan interval laporan terpendek yang diminta oleh pemanggil apa pun.

Jika nilai diatur ke nol, driver menggunakan interval laporan defaultnya. Seperti halnya meminta interval tertentu, driver mungkin memilih interval yang berbeda berdasarkan permintaan klien lain dan logika internal.

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

Interval laporan saat ini	Mengubah sensitivitas
1 mdtk – 16 mdtk	0,01 derajat
17 mdtk – 32 mdtk	0,5 derajat
>= 33 mdtk	2 derajat