BluetoothLEDevice Classe

Definição

Namespace:

Windows.Devices.Bluetooth

Representa um dispositivo Bluetooth LE.

Para obter exemplos de código, consulte Exemplo de bluetooth de baixa energia e Exemplo de enumeração e emparelhamento de dispositivos.

public ref class BluetoothLEDevice sealed : IClosable

/// [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 BluetoothLEDevice final : IClosable

[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 BluetoothLEDevice : System.IDisposable

Public NotInheritable Class BluetoothLEDevice
Implements IDisposable

Herança

Object Platform::Object IInspectable BluetoothLEDevice

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IClosable IDisposable

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

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1511	10586	Aparência
1511	10586	BluetoothAddressType
1511	10586	DeviceInformation
1511	10586	FromBluetoothAddressAsync(UInt64,BluetoothAddressType)
1511	10586	GetDeviceSelectorFromAppearance
1511	10586	GetDeviceSelectorFromBluetoothAddress(UInt64)
1511	10586	GetDeviceSelectorFromBluetoothAddress(UInt64,BluetoothAddressType)
1511	10586	GetDeviceSelectorFromConnectionStatus
1511	10586	GetDeviceSelectorFromDeviceName
1511	10586	GetDeviceSelectorFromPairingState
1703	15063	DeviceAccessInformation
1703	15063	GetGattServicesAsync
1703	15063	GetGattServicesAsync(BluetoothCacheMode)
1703	15063	GetGattServicesForUuidAsync(Guid)
1703	15063	GetGattServicesForUuidAsync(Guid,BluetoothCacheMode)
1703	15063	RequestAccessAsync
1.709	16299	BluetoothDeviceId
1803	17134	WasSecureConnectionUsedForPairing

Propriedades

Appearance	Obtém o objeto BluetoothLEAppearance para o dispositivo Bluetooth LE.
BluetoothAddress	Obtém o endereço do dispositivo.
BluetoothAddressType	Obtém o tipo de endereço para o dispositivo Bluetooth LE.
BluetoothDeviceId	Obtém a ID do dispositivo bluetooth.
ConnectionStatus	Obtém o status de conexão do dispositivo.
DeviceAccessInformation	Obtém o DeviceAccessInformation.
DeviceId	Obtém a ID do dispositivo.
DeviceInformation	Obtém as informações do dispositivo para o dispositivo Bluetooth LE.
GattServices	Obtém a lista somente leitura dos serviços GATT compatíveis com o dispositivo. Importante A API GattServices foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use GetGattServicesAsync.
Name	Obtém o nome do dispositivo Bluetooth LE.
WasSecureConnectionUsedForPairing	Obtém um booliano que indica se o BluetoothLEDevice foi emparelhado usando uma Conexão Segura.

Métodos

Close()	Fecha este dispositivo Bluetooth LE. Isso poderá fechar a conexão com o dispositivo se esse for o único aplicativo com uma conexão.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados.
FromBluetoothAddressAsync(UInt64)	Retorna um objeto BluetoothLEDevice que representa o dispositivo Bluetooth LE par com o endereço fornecido. Consulte Comentários (neste tópico membro).
FromBluetoothAddressAsync(UInt64, BluetoothAddressType)	Retorna um objeto BluetoothLEDevice que representa o dispositivo par com o endereço e o tipo de endereço fornecidos. Consulte Comentários (neste tópico membro).
FromIdAsync(String)	Retorna um objeto BluetoothLEDevice para a ID fornecida. Consulte Comentários no tópico membro.
GetConnectionParameters()	Recupera parâmetros de conexão para o dispositivo remoto. Se vários aplicativos ou outros cenários do sistema também solicitarem esses parâmetros, o sistema combinará automaticamente os parâmetros, quando compatível, com base na prioridade do sistema. Observação Quando o dispositivo não está conectado, os parâmetros de conexão são inválidos (todos zero).
GetConnectionPhy()	Recupera informações sobre a PHY (camada física) bluetooth LE. Observação Quando o dispositivo não está conectado, os PHYs de conexão são inválidos (todos falsos)
GetDeviceSelector()	Obtém uma cadeia de caracteres AQS (Sintaxe de Consulta Avançada) para identificar todos os dispositivos bluetooth de baixa energia (LE). Essa cadeia de caracteres é passada para o método FindAllAsync ou CreateWatcher para obter uma lista de dispositivos Bluetooth LE.
GetDeviceSelectorFromAppearance(BluetoothLEAppearance)	Cria uma cadeia de caracteres de filtro AQS (Sintaxe de Consulta Avançada) de um objeto BluetoothLEAppearance . A cadeia de caracteres AQS é passada para o método CreateWatcher para retornar uma coleção de objetos DeviceInformation com a aparência especificada.
GetDeviceSelectorFromBluetoothAddress(UInt64)	Cria uma cadeia de caracteres de filtro AQS (Sintaxe de Consulta Avançada) de um endereço de 64 bits que representa um dispositivo Bluetooth LE. A cadeia de caracteres AQS é passada para o método CreateWatcher para retornar uma coleção de objetos DeviceInformation .
GetDeviceSelectorFromBluetoothAddress(UInt64, BluetoothAddressType)	Cria uma cadeia de caracteres de filtro AQS (Sintaxe de Consulta Avançada) de um endereço de 64 bits e um tipo de endereço que representa um dispositivo Bluetooth LE. A cadeia de caracteres AQS é passada para o método CreateWatcher .
GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)	Cria uma cadeia de caracteres de filtro AQS (Sintaxe de Consulta Avançada) que contém uma consulta para dispositivos Bluetooth LE com o BluetoothConnectionStatus indicado. A cadeia de caracteres AQS é passada para o método CreateWatcher para retornar uma coleção de objetos DeviceInformation com a conexão Bluetooth indicada status.
GetDeviceSelectorFromDeviceName(String)	Cria uma cadeia de caracteres de filtro AQS (Sintaxe de Consulta Avançada) que contém uma consulta para o nome do dispositivo Bluetooth LE. A cadeia de caracteres AQS é passada para o método CreateWatcher para retornar uma coleção de objetos DeviceInformation que contêm o nome do dispositivo Bluetooth LE especificado.
GetDeviceSelectorFromPairingState(Boolean)	Cria uma cadeia de caracteres de filtro AQS (Sintaxe de Consulta Avançada) que contém uma consulta para dispositivos Bluetooth LE emparelhados ou não pagos. A cadeia de caracteres AQS é passada para o método CreateWatcher para retornar uma coleção de objetos DeviceInformation .
GetGattService(Guid)	Retorna o serviço GATT com a ID de serviço fornecida. Importante A API GetGattService foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use GetGattServicesAsync.
GetGattServicesAsync()	Obtém o GattDeviceServices para este dispositivo Bluetooth LowEnergy.
GetGattServicesAsync(BluetoothCacheMode)	Retorna o GattDeviceServices para este dispositivo Bluetooth LowEnergy com o modo de cache especificado.
GetGattServicesForUuidAsync(Guid)	Retorna o GattDeviceServices para o dispositivo Bluetooth LowEnergy com a UUID especificada.
GetGattServicesForUuidAsync(Guid, BluetoothCacheMode)	Retorna o GattDeviceServices para o dispositivo Bluetooth LowEnergy com a UUID especificada.
RequestAccessAsync()	Solicita acesso ao dispositivo Bluetooth LowEnergy.
RequestPreferredConnectionParameters(BluetoothLEPreferredConnectionParameters)	Recupera um objeto de solicitação de parâmetros de conexão preferenciais bluetooth LE para o objeto de parâmetros de conexão preferenciais Bluetooth LE especificado.

Eventos

ConnectionParametersChanged	Um evento gerado quando os parâmetros de conexão atuais do dispositivo são alterados. Os parâmetros serão atualizados somente depois que uma conexão com o dispositivo for estabelecida.
ConnectionPhyChanged	Um evento gerado quando o PHY atual para o dispositivo é alterado. O PHY será atualizado somente depois que uma conexão com o dispositivo for estabelecida.
ConnectionStatusChanged	Ocorre quando a conexão status para o dispositivo foi alterada.
GattServicesChanged	Gerado quando a lista de serviços gatt compatíveis com o dispositivo foi alterada.
NameChanged	Ocorre quando o nome do dispositivo é alterado.

Confira também

• GattDeviceService
• Device
• Exemplo de Bluetooth de baixa energia
• Exemplo de enumeração e emparelhamento de dispositivos