BluetoothLEDevice Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.IDisposablePublic NotInheritable Class BluetoothLEDevice
Implements IDisposable- Herança
- 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. |