Idioma

BluetoothDevice Classe

Definição

Namespace:
Windows.Devices.Bluetooth
Editar

Representa um dispositivo Bluetooth.

Os aplicativos de exemplo que usam essa classe incluem exemplo de enumeração de dispositivo e emparelhamento e exemplo de chat bluetooth RFCOMM.

public ref class BluetoothDevice 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 BluetoothDevice 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 BluetoothDevice : System.IDisposable
Public NotInheritable Class BluetoothDevice
Implements IDisposable
Herança
Object Platform::Object IInspectable BluetoothDevice
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Implementações
IClosable IDisposable

Requisitos do Windows

Requisitos Description
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ões

Versão do Windows Versão do SDK Valor adicionado
1511 10586 Informações do Dispositivo
1511 10586 GetDeviceSelectorFromBluetoothAddress
1511 10586 GetDeviceSelectorFromClassOfDevice
1511 10586 GetDeviceSelectorFromConnectionStatus
1511 10586 GetDeviceSelectorFromDeviceName
1511 10586 GetDeviceSelectorFromPairingState
1607 14393 DeviceAccessInformation
1607 14393 GetRfcommServicesAsync
1607 14393 GetRfcommServicesAsync(BluetoothCacheMode)
1607 14393 GetRfcommServicesForIdAsync(RfcommServiceId)
1607 14393 GetRfcommServicesForIdAsync(RfcommServiceId,BluetoothCacheMode)
1607 14393 RequestAccessAsync
1709 16299 BluetoothDeviceId
1803 17134 WasSecureConnectionUsedForPairing

Propriedades

Nome Description
BluetoothAddress

Obtém o endereço do dispositivo.
BluetoothDeviceId

Obtém a ID do dispositivo bluetooth.
ClassOfDevice

Obtém as informações da classe Bluetooth de dispositivo do dispositivo.
ConnectionStatus

Obtém o status da conexão do dispositivo.
DeviceAccessInformation

O objeto DeviceAccessInformation atual para o dispositivo. Usado para verificar e monitorar as alterações de acesso ao dispositivo.
DeviceId

Obtém a ID do dispositivo proveniente do Windows.Devices.Enumeration.DeviceInformation.Id
DeviceInformation

Obtém o objeto DeviceInformation para o dispositivo Bluetooth.
HostName

Obtém o HostName do dispositivo.
Name

Obtém o nome do dispositivo.
RfcommServices

Obtém a lista somente leitura de serviços RFCOMM compatíveis com o dispositivo.

Importante

A API rfcommServices foi preterida e pode não estar disponível em versões futuras do Windows. Em vez disso, use GetRfcommServicesAsync.
SdpRecords

Obtém a lista somente leitura de registros SDP (Service Discovery Protocol) para o dispositivo.
WasSecureConnectionUsedForPairing

Obtém um booliano que indica se o BluetoothDevice foi emparelhado usando uma Conexão Segura.

Métodos

Nome Description
Close()

Fecha o dispositivo Bluetooth.
Dispose()

Executa tarefas definidas pelo aplicativo associadas à liberação, liberação ou redefinição de recursos não gerenciados.
FromBluetoothAddressAsync(UInt64)

Retorna um objeto BluetoothDevice para o BluetoothAddress fornecido.
FromHostNameAsync(HostName)

Retorna um objeto BluetoothDevice identificado pelo HostName fornecido.
FromIdAsync(String)

Retorna um objeto BluetoothDevice identificado pela DeviceId fornecida.
GetDeviceSelector()

Obtém uma cadeia de caracteres AQS (Sintaxe de Consulta Avançada) para identificar instâncias desse dispositivo. Essa cadeia de caracteres é passada para o método FindAllAsync ou CreateWatcher.
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. A cadeia de caracteres AQS é passada para o método CreateWatcher para retornar uma coleção de objetos DeviceInformation .
GetDeviceSelectorFromClassOfDevice(BluetoothClassOfDevice)

Cria uma cadeia de caracteres de filtro AQS (Sintaxe de Consulta Avançada) de um objeto BluetoothClassOfDevice . A cadeia de caracteres AQS é passada para o método CreateWatcher para retornar uma coleção de objetos DeviceInformation .
GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)

Cria uma cadeia de caracteres de filtro AQS (Sintaxe de Consulta Avançada) que contém uma consulta para dispositivos Bluetooth com o BluetoothConnectionStatus indicado. A cadeia de caracteres AQS é passada para o método CreateWatcher para retornar uma coleção de objetos DeviceInformation com o status de conexão Bluetooth indicado.
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. 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 especificado.
GetDeviceSelectorFromPairingState(Boolean)

Cria uma cadeia de caracteres de filtro AQS (Sintaxe de Consulta Avançada) que contém uma consulta para dispositivos Bluetooth emparelhados ou não pagos. A cadeia de caracteres AQS é passada para o método CreateWatcher para retornar uma coleção de objetos DeviceInformation .
GetRfcommServicesAsync()

Recupera todos os Serviços rfcomm no dispositivo Bluetooth remoto.
GetRfcommServicesAsync(BluetoothCacheMode)

Recupera todos os Serviços Rfcomm armazenados em cache no dispositivo Bluetooth remoto.
GetRfcommServicesForIdAsync(RfcommServiceId, BluetoothCacheMode)

Recupera todos os Serviços rfcomm armazenados em cache no Dispositivo Bluetooth Remoto que corresponde ao RfcommServiceId especificado.
GetRfcommServicesForIdAsync(RfcommServiceId)

Recupera todos os Serviços Rfcomm no Dispositivo Bluetooth Remoto que correspondem ao RfcommServiceId especificado.
RequestAccessAsync()

Usado para solicitar acesso explícito ao dispositivo Bluetooth. Isso invoca o Consentimento do Dispositivo e deve ser chamado no thread da interface do usuário.

Eventos

Nome Description
ConnectionStatusChanged

Ocorre quando o status da conexão do dispositivo é alterado.
NameChanged

Ocorre quando o nome do dispositivo é alterado.
SdpRecordsChanged

Ocorre quando os registros SDP de lista do dispositivo são alterados.

Aplica-se a

Confira também