BluetoothSignalStrengthFilter Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Parameter grup yang digunakan untuk mengonfigurasi pemfilteran berbasis indikator kekuatan sinyal (RSSI) yang diterima.
public ref class BluetoothSignalStrengthFilter sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class BluetoothSignalStrengthFilter final
/// [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 BluetoothSignalStrengthFilter final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class BluetoothSignalStrengthFilter
[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 BluetoothSignalStrengthFilter
function BluetoothSignalStrengthFilter()
Public NotInheritable Class BluetoothSignalStrengthFilter
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Kemampuan aplikasi |
bluetooth
|
Keterangan
Kelas BluetoothSignalStrengthFilter hanya menerima rentang terbatas untuk propertinya. Namun, tergantung pada bagaimana kelas ini digunakan oleh aplikasi, pembatasan tambahan mungkin berlaku. Misalnya, rentang yang valid untuk nilai RSSI berbeda antara perangkat Bluetooth LE dan Bluetooth BR/EDR.
Rentang yang valid untuk properti ini adalah sebagai berikut:
- InRangeThresholdInDBm - Ambang minimum untuk peristiwa RSSI yang akan dipertimbangkan dalam rentang. Rentang yang valid adalah -128 hingga 127.
- OutOfRangeThresholdInDBm - Ambang minimum untuk peristiwa RSSI yang akan dipertimbangkan di luar rentang. Rentang yang valid adalah -128 hingga 127.
- OutOfRangeTimeout - Waktu habis untuk peristiwa RSSI yang akan dipertimbangkan di luar rentang. Rentang yang valid sama atau lebih besar dari 1 detik.
- SamplingInterval - Interval tempat peristiwa RSSI diambil sampelnya. Rentang yang valid sama atau lebih besar dari 0. Interval pengambilan sampel apa pun yang lebih besar atau sama dengan 25,5 detik akan menonaktifkan pengambilan sampel sepenuhnya. Dalam kasus khusus itu, pemfilteran berbasis pemicu. Ada dua kemungkinan status untuk memfilter nilai RSSI untuk perangkat apa pun:
- Dalam rentang.
- Di luar jangkauan. Setiap peristiwa RSSI disebarluaskan jika dipertimbangkan dalam rentang. Ini termasuk peristiwa dengan nilai RSSI yang lebih rendah atau sama dengan OutOfRangeThresholdInDBm selama OutOfRangeTimeout belum kedaluwarsa.
Kelas ini memiliki batasan tambahan pada propertinya saat digunakan oleh kelas BluetoothLEAdvertisementWatcher . Pengecualian akan dilemparkan ketika BluetoothLEAdvertisementWatcher dimulai dengan parameter di luar rentang yang valid untuk BluetoothLEAdvertisementWatcher.
Secara umum, ada tiga kasus penggunaan utama untuk API ini:
InRangeThresholdInDBm | OutOfRangeThresholdInDBm | OutOfRangeTimeout | SamplingInterval | Aktivitas |
---|---|---|---|---|
Apa pun | <= InRangeThresholdInDBm | >= 1 | 0 | Akan menerima semua peristiwa RSSI saat mereka tiba selama mereka dianggap "dalam rentang". Peristiwa dianggap "di luar rentang" jika OutOfRangeTimeout kedaluwarsa tanpa peristiwa apa pun atau tanpa peristiwa apa pun dengan nilai RSSI yang lebih besar dari OutOfRangeThresholdInDBm. Tidak ada peristiwa tambahan yang dihasilkan ketika OutOfRangeTimeout kedaluwarsa. |
Apa pun | <= InRangeThresholdInDBm | >= 1 | (0, 25.5) | Akan menerima peristiwa RSSI pada interval reguler yang ditentukan oleh SamplingInterval selama dianggap "dalam rentang". Nilai RSSI akan menjadi rata-rata nilai peristiwa yang diterima dalam SamplingInterval. Jika tidak ada peristiwa yang diterima dalam SamplingInterval, tidak ada peristiwa yang akan disebarluaskan. Jika OutOfRangeTimeout kedaluwarsa tanpa peristiwa apa pun atau tanpa peristiwa apa pun dengan nilai RSSI yang lebih besar dari OutOfRangeThresholdInDBm, peristiwa dianggap "di luar rentang" dan peristiwa dengan nilai RSSI terakhir yang diterima akan dihasilkan. Jika nilai RSSI terakhir berada di atas OutOfRangeThresholdInDBm, nilai tersebut diatur ke -127 dBm. |
Apa pun | <= InRangeThresholdInDBm | >= 1 | >=25,5 (dinonaktifkan) | Akan menerima peristiwa RSSI ketika peristiwa RSSI beralih ke "dalam rentang" dari "di luar rentang". Jika OutOfRangeTimeout kedaluwarsa tanpa peristiwa apa pun atau tanpa peristiwa apa pun dengan nilai RSSI yang lebih besar dari OutOfRangeThresholdInDBm, peristiwa dianggap "di luar rentang" dan peristiwa dengan nilai RSSI terakhir yang diterima akan dihasilkan. Jika nilai RSSI terakhir berada di atas OutOfRangeThresholdInDBm, nilai tersebut diatur ke OutOfRangeThresholdInDBm. |
Konstruktor
BluetoothSignalStrengthFilter() |
Buat objek BluetoothSignalStrengthFilter baru. |
Properti
InRangeThresholdInDBm |
Nilai indikator kekuatan sinyal minimum yang diterima (RSSI) dalam dBm tempat peristiwa RSSI akan disebarluaskan atau dipertimbangkan dalam rentang jika peristiwa sebelumnya dianggap di luar rentang. |
OutOfRangeThresholdInDBm |
Nilai indikator kekuatan sinyal minimum (RSSI) yang diterima dalam dBm tempat peristiwa RSSI akan dipertimbangkan di luar rentang. |
OutOfRangeTimeout |
Waktu habis untuk peristiwa indikator kekuatan sinyal (RSSI) yang diterima untuk dipertimbangkan di luar rentang. |
SamplingInterval |
Interval saat menerima peristiwa indikator kekuatan sinyal (RSSI) diambil sampelnya. |
Berlaku untuk
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk