Lenguaje

BluetoothDevice Clase

Definición

Espacio de nombres:
Windows.Devices.Bluetooth
Editar

Representa un dispositivo Bluetooth.

Entre las aplicaciones de ejemplo que usan esta clase se incluyen enumeración de dispositivos y de ejemplo de emparejamiento y 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

Requisitos Description
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 añadido
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

Nombre Description
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

El 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 para el 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 de rfcommServices está en desuso y puede 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 bluetoothDevice se empareja mediante una conexión segura.

Métodos

Nombre Description
Close()

Cierra el dispositivo Bluetooth.
Dispose()

Realiza tareas definidas por la aplicación asociadas a la liberación, liberación o restablecimiento de recursos no administrados.
FromBluetoothAddressAsync(UInt64)

Devuelve un objeto BluetoothDevice para el BluetoothAddress especificado.
FromHostNameAsync(HostName)

Devuelve un objeto BluetoothDevice identificado por el nombre de host 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 de sintaxis de consulta avanzada (AQS) a partir de un objeto de 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 DeviceInformation objetos 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 DeviceInformation objetos 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, BluetoothCacheMode)

Recupera todos los servicios rfcomm almacenados en caché en el dispositivo Bluetooth remoto que coincida con el RfcommServiceId especificado.
GetRfcommServicesForIdAsync(RfcommServiceId)

Recupera todos los servicios rfcomm 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 la interfaz de usuario.

Eventos

Nombre Description
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 la lista de registros SDP del dispositivo ha cambiado.

Se aplica a

Consulte también