BluetoothSignalStrengthFilter Classe

Definição

Namespace:

Windows.Devices.Bluetooth

Parâmetros de grupos usados para configurar a filtragem baseada em RSSI (indicador de força de sinal recebido).

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

Herança

Object Platform::Object IInspectable BluetoothSignalStrengthFilter

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)
Funcionalidades do aplicativo	bluetooth

Comentários

A classe BluetoothSignalStrengthFilter aceita apenas um intervalo limitado para suas propriedades. No entanto, dependendo de como essa classe é usada por um aplicativo, restrições adicionais podem ser aplicadas. Por exemplo, o intervalo válido para valores RSSI difere entre dispositivos Bluetooth LE e Bluetooth BR/EDR.

O intervalo válido para essas propriedades é o seguinte:

• InRangeThresholdInDBm - O limite mínimo para um evento RSSI a ser considerado no intervalo. O intervalo válido é -128 a 127.
• OutOfRangeThresholdInDBm - O limite mínimo para um evento RSSI a ser considerado fora do intervalo. O intervalo válido é -128 a 127.
• OutOfRangeTimeout – tempo limite para que um evento RSSI seja considerado fora do intervalo. O intervalo válido é igual ou maior que 1 segundo.
• SamplingInterval – o intervalo no qual os eventos RSSI são amostrados. O intervalo válido é igual ou maior que 0. Qualquer intervalo de amostragem maior ou igual a 25,5 segundos desabilitará totalmente a amostragem. Nesse caso especial, a filtragem é baseada em gatilho. Há dois estados possíveis para filtrar valores RSSI para qualquer dispositivo:
• No intervalo.
• Fora do intervalo. Todos os eventos RSSI serão propagados se forem considerados no intervalo. Isso inclui eventos com valores RSSI inferiores ou iguais a OutOfRangeThresholdInDBm , desde que OutOfRangeTimeout não tenha expirado.

Essa classe tem limitações adicionais em suas propriedades quando usada pela classe BluetoothLEAdvertisementWatcher . Uma exceção será gerada quando o BluetoothLEAdvertisementWatcher for iniciado com parâmetros fora do intervalo válido para BluetoothLEAdvertisementWatcher.

Em geral, há três casos de uso main para esta API:

InRangeThresholdInDBm	OutOfRangeThresholdInDBm	OutOfRangeTimeout	SamplingInterval	Comportamento
Qualquer	<= InRangeThresholdInDBm	>= 1	0	Receberá todos os eventos RSSI à medida que chegarem, desde que sejam considerados "no intervalo". Os eventos serão considerados "fora do intervalo" se OutOfRangeTimeout expirar sem eventos ou sem eventos com valores RSSI maiores que OutOfRangeThresholdInDBm. Nenhum evento adicional é gerado quando OutOfRangeTimeout expira.
Qualquer	<= InRangeThresholdInDBm	>= 1	(0, 25.5)	Receberá eventos RSSI em um intervalo regular definido por SamplingInterval , desde que sejam considerados "no intervalo". O valor RSSI será uma média dos valores dos eventos recebidos em um SamplingInterval. Se nenhum evento for recebido em SamplingInterval, nenhum evento será propagado. Se OutOfRangeTimeout expirar sem eventos ou sem eventos com valores RSSI maiores que OutOfRangeThresholdInDBm, os eventos serão considerados "fora do intervalo" e um evento com o último valor RSSI recebido será gerado. Se o último valor RSSI estiver acima de OutOfRangeThresholdInDBm, ele será definido como -127 dBm.
Qualquer	<= InRangeThresholdInDBm	>= 1	>=25,5 (desabilitado)	Receberá um evento RSSI quando os eventos RSSI estiverem fazendo a transição para "no intervalo" de "fora do intervalo". Se OutOfRangeTimeout expirar sem eventos ou sem eventos com valores RSSI maiores que OutOfRangeThresholdInDBm, os eventos serão considerados "fora do intervalo" e um evento com o último valor RSSI recebido será gerado. Se o último valor RSSI estiver acima de OutOfRangeThresholdInDBm, ele será definido como OutOfRangeThresholdInDBm.

Construtores

BluetoothSignalStrengthFilter()

Crie um novo objeto BluetoothSignalStrengthFilter .

Propriedades

InRangeThresholdInDBm	O valor mínimo de RSSI (indicador de força de sinal recebido) no dBm no qual os eventos RSSI serão propagados ou considerados no intervalo se os eventos anteriores forem considerados fora do intervalo.
OutOfRangeThresholdInDBm	O valor mínimo de RSSI (indicador de força de sinal recebido) no dBm no qual os eventos RSSI serão considerados fora do intervalo.
OutOfRangeTimeout	O tempo limite para um evento RSSI (indicador de força de sinal) recebido a ser considerado fora do intervalo.
SamplingInterval	O intervalo no qual os eventos RSSI (indicador de força de sinal) recebidos são amostrados.

Confira também

• BluetoothLEAdvertisementWatcher
• SignalStrengthFilter