BluetoothDevice Clase

Definición

Espacio de nombres:

Windows.Devices.Bluetooth

Representa un dispositivo Bluetooth.

Las aplicaciones de ejemplo que usan esta clase incluyen la enumeración de dispositivos y el ejemplo de emparejamiento y el ejemplo de chat rfCOMM de 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

Herencia

Object Platform::Object IInspectable BluetoothDevice

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IClosable IDisposable

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
Características de aplicaciones	bluetooth

Comentarios

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
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
1709	16299	BluetoothDeviceId
1803	17134	WasSecureConnectionUsedForPairing

Propiedades

BluetoothAddress	Obtiene la dirección del dispositivo.
BluetoothDeviceId	Obtiene el identificador del dispositivo Bluetooth.
ClassOfDevice	Obtiene la información de clase de dispositivo Bluetooth del dispositivo.
ConnectionStatus	Obtiene el estado de conexión del dispositivo.
DeviceAccessInformation	Objeto DeviceAccessInformation actual para el dispositivo. Se usa para comprobar y supervisar los cambios de acceso en el dispositivo.
DeviceId	Obtiene el identificador de dispositivo que procede del Windows.Devices.Enumeration.DeviceInformation.Id
DeviceInformation	Obtiene el objeto DeviceInformation del dispositivo Bluetooth.
HostName	Obtiene el nombre de host del dispositivo.
Name	Obtiene el nombre del dispositivo.
RfcommServices	Obtiene la lista de solo lectura de los servicios RFCOMM admitidos por el dispositivo. Importante La API rfcommServices está en desuso y es posible que no esté disponible en versiones futuras de Windows. En su lugar, use GetRfcommServicesAsync.
SdpRecords	Obtiene la lista de solo lectura de los registros del Protocolo de detección de servicios (SDP) para el dispositivo.
WasSecureConnectionUsedForPairing	Obtiene un valor booleano que indica si el BluetoothDevice se ha emparejado mediante una conexión segura.

Métodos

Close()	Cierra el dispositivo Bluetooth.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
FromBluetoothAddressAsync(UInt64)	Devuelve un objeto BluetoothDevice para el objeto BluetoothAddress especificado.
FromHostNameAsync(HostName)	Devuelve un objeto BluetoothDevice identificado por el hostName especificado.
FromIdAsync(String)	Devuelve un objeto BluetoothDevice identificado por el deviceId especificado.
GetDeviceSelector()	Obtiene una cadena de sintaxis de consulta avanzada (AQS) para identificar instancias de este dispositivo. Esta cadena se pasa al método FindAllAsync o CreateWatcher.
GetDeviceSelectorFromBluetoothAddress(UInt64)	Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) a partir de una dirección de 64 bits que representa un dispositivo Bluetooth. La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation .
GetDeviceSelectorFromClassOfDevice(BluetoothClassOfDevice)	Crea una cadena de filtro advanced Query Syntax (AQS) a partir de un objeto BluetoothClassOfDevice . La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation .
GetDeviceSelectorFromConnectionStatus(BluetoothConnectionStatus)	Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) que contiene una consulta para dispositivos Bluetooth con el BluetoothConnectionStatus indicado. La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation con el estado de conexión Bluetooth indicado.
GetDeviceSelectorFromDeviceName(String)	Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) que contiene una consulta para el nombre del dispositivo Bluetooth. La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation que contienen el nombre de dispositivo Bluetooth especificado.
GetDeviceSelectorFromPairingState(Boolean)	Crea una cadena de filtro de sintaxis de consulta avanzada (AQS) que contiene una consulta para dispositivos Bluetooth que están emparejados o no emparejados. La cadena AQS se pasa al método CreateWatcher para devolver una colección de objetos DeviceInformation .
GetRfcommServicesAsync()	Recupera todos los servicios rfcomm en el dispositivo Bluetooth remoto.
GetRfcommServicesAsync(BluetoothCacheMode)	Recupera todos los servicios rfcomm almacenados en caché en el dispositivo Bluetooth remoto.
GetRfcommServicesForIdAsync(RfcommServiceId)	Recupera todos los servicios rfcomm en el dispositivo Bluetooth remoto que coincida con el rfcommServiceId especificado.
GetRfcommServicesForIdAsync(RfcommServiceId, BluetoothCacheMode)	Recupera todos los servicios rfcomm almacenados en caché en el dispositivo Bluetooth remoto que coincida con el rfcommServiceId especificado.
RequestAccessAsync()	Se usa para solicitar acceso explícito al dispositivo Bluetooth. Esto invoca el consentimiento del dispositivo y se debe llamar a en el subproceso de interfaz de usuario.

Eventos

ConnectionStatusChanged	Se produce cuando ha cambiado el estado de conexión del dispositivo.
NameChanged	Se produce cuando el nombre del dispositivo ha cambiado.
SdpRecordsChanged	Se produce cuando ha cambiado la lista de registros SDP para el dispositivo.

Consulte también

• Ejemplo de emparejamiento y enumeración de dispositivos
• Ejemplo de chat rfCOMM de Bluetooth