Compartilhar via


BluetoothLEDevice Classe

Definição

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
Implementações

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.

Aplica-se a

Confira também