Bagikan melalui


BluetoothSignalStrengthFilter Kelas

Definisi

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
Object Platform::Object IInspectable BluetoothSignalStrengthFilter
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