BluetoothSignalStrengthFilter Clase

Definición

Espacio de nombres:

Windows.Devices.Bluetooth

Agrupa los parámetros usados para configurar el filtrado basado en el indicador de intensidad de señal recibido (RSSI).

public ref class BluetoothSignalStrengthFilter sealed

/// [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.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

Herencia

Object Platform::Object IInspectable BluetoothSignalStrengthFilter

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
Características de aplicaciones	bluetooth

Comentarios

La clase BluetoothSignalStrengthFilter solo acepta un intervalo limitado para sus propiedades. Sin embargo, dependiendo de cómo una aplicación use esta clase, se pueden aplicar restricciones adicionales. Por ejemplo, el intervalo válido para los valores RSSI difiere entre los dispositivos Bluetooth LE y Bluetooth BR/EDR.

El intervalo válido para estas propiedades es el siguiente:

• InRangeThresholdInDBm : umbral mínimo para un evento RSSI que se va a tener en cuenta en el intervalo. El intervalo válido es de -128 a 127.
• OutOfRangeThresholdInDBm : umbral mínimo para un evento RSSI que se va a considerar fuera del intervalo. El intervalo válido es de -128 a 127.
• OutOfRangeTimeout : tiempo de espera para que un evento RSSI se considere fuera del intervalo. El intervalo válido es igual o mayor que 1 segundo.
• SamplingInterval : intervalo en el que se muestrea el evento RSSI. El intervalo válido es igual o mayor que 0. Cualquier intervalo de muestreo mayor o igual que 25,5 segundos deshabilitará el muestreo por completo. En ese caso especial, el filtrado se basa en desencadenadores. Hay dos estados posibles para filtrar valores RSSI para cualquier dispositivo:
• En intervalo.
• Fuera del intervalo. Los eventos RSSI se propagan si se consideran en el intervalo. Esto incluye eventos con valores RSSI inferiores o iguales que OutOfRangeThresholdInDBm siempre que OutOfRangeTimeout no haya expirado.

Esta clase tiene limitaciones adicionales en sus propiedades cuando la clase BluetoothLEAdvertisementWatcher la usa. Se producirá una excepción cuando BluetoothLEAdvertisementWatcher se inicie con parámetros fuera del intervalo válido para BluetoothLEAdvertisementWatcher.

En general, hay tres casos de uso principales para esta API:

InRangeThresholdInDBm	OutOfRangeThresholdInDBm	OutOfRangeTimeout	SamplingInterval	Comportamiento
Any	<= InRangeThresholdInDBm	>= 1	0	Recibirá todos los eventos RSSI a medida que lleguen siempre que se consideren "en intervalo". Los eventos se consideran "fuera del intervalo" si OutOfRangeTimeout expira sin ningún evento o sin ningún evento con valores RSSI mayores que OutOfRangeThresholdInDBm. No se generan eventos adicionales cuando expira OutOfRangeTimeout .
Any	<= InRangeThresholdInDBm	>= 1	(0, 25.5)	Recibirá eventos RSSI en un intervalo regular definido por SamplingInterval siempre que se consideren "en intervalo". El valor RSSI será un promedio de los valores de los eventos recibidos en un SamplingInterval. Si no se reciben eventos en SamplingInterval, no se propagará ningún evento. Si OutOfRangeTimeout expira sin ningún evento o sin ningún evento con valores RSSI mayores que OutOfRangeThresholdInDBm, los eventos se consideran "fuera del intervalo" y se generará un evento con el último valor RSSI recibido. Si el último valor RSSI estaba por encima de OutOfRangeThresholdInDBm, se establece en -127 dBm.
Any	<= InRangeThresholdInDBm	>= 1	>=25.5 (deshabilitado)	Recibirá un evento RSSI cuando los eventos RSSI pasen a "en intervalo" desde "fuera del intervalo". Si OutOfRangeTimeout expira sin ningún evento o sin ningún evento con valores RSSI mayores que OutOfRangeThresholdInDBm, los eventos se consideran "fuera del intervalo" y se generará un evento con el último valor RSSI recibido. Si el último valor RSSI estaba por encima de OutOfRangeThresholdInDBm, se establece en OutOfRangeThresholdInDBm.

Constructores

BluetoothSignalStrengthFilter()

Cree un nuevo objeto BluetoothSignalStrengthFilter .

Propiedades

InRangeThresholdInDBm	El valor mínimo recibido del indicador de intensidad de señal (RSSI) en dBm en el que se propagarán los eventos RSSI o se considerarán en el intervalo si los eventos anteriores se consideraron fuera del intervalo.
OutOfRangeThresholdInDBm	Valor mínimo de indicador de intensidad de señal (RSSI) recibido en dBm en el que los eventos RSSI se considerarán fuera del intervalo.
OutOfRangeTimeout	Tiempo de espera de un evento de intensidad de señal recibido (RSSI) que se va a considerar fuera del intervalo.
SamplingInterval	Intervalo en el que se muestrea el indicador de intensidad de señal (RSSI) recibido.

Consulte también

• BluetoothLEAdvertisementWatcher
• SignalStrengthFilter