| -api-id | -api-type | -api-device-family-note |
|---|---|---|
P:Windows.Devices.Bluetooth.Advertisement.BluetoothLEAdvertisementWatcher.SignalStrengthFilter |
winrt property |
xbox |
Gets or sets a BluetoothSignalStrengthFilter object used for configuration of Bluetooth LE advertisement filtering that uses signal strength-based filtering.
Configuration of Bluetooth LE advertisement filtering that uses signal strength-based filtering.
The SignalStrengthFilter has additional limitations on its properties when used by the BluetoothLEAdvertisementWatcher class. An exception will be thrown when the watcher is started with parameters outside of the valid range. If the properties are left as NULL, a default value is selected.
The additional restrictions and default values are as follows:
- InRangeThresholdInDBm - The maximum value for RSSI for Bluetooth LE is +20. The minimum value for RSSI for BR/EDR is -127 (default when NULL is -127.
- OutOfRangeThresholdInDBm - The maximum value for RSSI for Bluetooth LE is +20. The minimum value for RSSI for BR/EDR is -127 (default when NULL is -127).
- OutOfRangeTimeout - Equal or greater than 1 second and less than or equal to 60 seconds (default when NULL is 60 seconds).
- SamplingInterval - Equal or greater than 0. Any sampling interval greater or equal to 25.5 seconds will disable sampling entirely. In that special case, the filtering is trigger-based. For more information about the behavior of the RSSI filtering, refer to the BluetoothSignalStrengthFilter.
bluetooth