BluetoothDevice Classe

Definição

Namespace:

Windows.Devices.Bluetooth

Representa um dispositivo Bluetooth.

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

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

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	DeviceInformation
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
1.709	16299	BluetoothDeviceId
1803	17134	WasSecureConnectionUsedForPairing

Propriedades

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 do dispositivo.
ConnectionStatus	Obtém o status de conexão do dispositivo.
DeviceAccessInformation	O objeto DeviceAccessInformation atual para o dispositivo. Usado para marcar e monitorar 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 do Protocolo de Descoberta de Serviço (SDP) do dispositivo.
WasSecureConnectionUsedForPairing	Obtém um booliano que indica se o BluetoothDevice foi emparelhado usando uma Conexão Segura.

Métodos

Close()	Fecha o dispositivo Bluetooth.
Dispose()	Realiza tarefas definidas pelo aplicativo associadas à 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 pelo DeviceId fornecido.
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 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. 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)	Recupera todos os Serviços Rfcomm no Dispositivo Bluetooth Remoto que correspondem ao RfcommServiceId especificado.
GetRfcommServicesForIdAsync(RfcommServiceId, BluetoothCacheMode)	Recupera todos os Serviços rfcomm armazenados em cache 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

ConnectionStatusChanged	Ocorre quando o status de conexão do dispositivo foi alterado.
NameChanged	Ocorre quando o nome do dispositivo é alterado.
SdpRecordsChanged	Ocorre quando os registros SDP de lista do dispositivo foram alterados.

Confira também

• Exemplo de enumeração e emparelhamento de dispositivos
• Exemplo de chat do Bluetooth RFCOMM