QBluetoothLocalDevice Class

Documentación de la función de miembro

[explicit] QBluetoothLocalDevice::QBluetoothLocalDevice(QObject *parent = nullptr)

Construye un QBluetoothLocalDevice con parent.

Véase también isValid().

[explicit] QBluetoothLocalDevice::QBluetoothLocalDevice(const QBluetoothAddress &address, QObject *parent = 0)

Construye un nuevo QBluetoothLocalDevice para address. Si address se construye por defecto el dispositivo local resultante selecciona el dispositivo local por defecto.

Véase también isValid().

[virtual noexcept] QBluetoothLocalDevice::~QBluetoothLocalDevice()

Destruye el QBluetoothLocalDevice.

QBluetoothAddress QBluetoothLocalDevice::address() const

Devuelve la dirección MAC de este dispositivo Bluetooth.

[static] QList<QBluetoothHostInfo> QBluetoothLocalDevice::allDevices()

Devuelve una lista de todos los dispositivos Bluetooth locales disponibles. En macOS, solo existe el dispositivo local "predeterminado".

QList<QBluetoothAddress> QBluetoothLocalDevice::connectedDevices() const

Devuelve la lista de dispositivos conectados. Esta lista es diferente de la lista de dispositivos emparejados actualmente.

En Android y macOS, no es posible recuperar una lista de dispositivos conectados. Sólo es posible escuchar los cambios de (des)conexión. Por comodidad, esta clase monitoriza todos los eventos de conexión y desconexión desde su instanciación y devuelve la lista actual al llamar a esta función. Por lo tanto, es posible que esta función devuelva una lista vacía poco después de crear una instancia.

Véase también deviceConnected() y deviceDisconnected().

[signal] void QBluetoothLocalDevice::deviceConnected(const QBluetoothAddress &address)

Esta señal se emite cuando el dispositivo local establece una conexión con un dispositivo remoto con address.

Véase también deviceDisconnected() y connectedDevices().

[signal] void QBluetoothLocalDevice::deviceDisconnected(const QBluetoothAddress &address)

Esta señal se emite cuando el dispositivo local se desconecta de un dispositivo Bluetooth remoto con address.

Véase también deviceConnected() y connectedDevices().

[signal, since 6.2] void QBluetoothLocalDevice::errorOccurred(QBluetoothLocalDevice::Error error)

Señal emitida si hay un error excepcional durante el emparejamiento.

Esta función se introdujo en Qt 6.2.

QBluetoothLocalDevice::HostMode QBluetoothLocalDevice::hostMode() const

Devuelve el modo host actual de este dispositivo Bluetooth local. En macOS, es HostPoweredOff o HostConnectable.

Véase también setHostMode().

[signal] void QBluetoothLocalDevice::hostModeStateChanged(QBluetoothLocalDevice::HostMode state)

El state del anfitrión ha pasado a un HostMode diferente.

bool QBluetoothLocalDevice::isValid() const

Devuelve true si QBluetoothLocalDevice representa un dispositivo Bluetooth local disponible; en caso contrario, devuelve false.

Si el adaptador Bluetooth local representado por una instancia de esta clase se retira del sistema (por ejemplo, si se retira el dongle Bluetooth subyacente), esta instancia dejará de ser válida. Una instancia ya inválida de QBluetoothLocalDevice permanece inválida incluso si el mismo adaptador Bluetooth se devuelve al sistema.

Véase también allDevices().

QString QBluetoothLocalDevice::name() const

Devuelve el nombre asignado por el usuario a este dispositivo Bluetooth.

[signal] void QBluetoothLocalDevice::pairingFinished(const QBluetoothAddress &address, QBluetoothLocalDevice::Pairing pairing)

Se ha completado el emparejamiento o desemparejamiento con address. El estado actual del emparejamiento aparece en pairing. Si la solicitud de emparejamiento no ha tenido éxito, no se emitirá esta señal. La señal errorOccurred() se emite si la solicitud de emparejamiento ha fallado. La señal sólo se emite para peticiones de emparejamiento que hayan sido solicitadas previamente llamando a requestPairing() de la instancia de objeto actual.

QBluetoothLocalDevice::Pairing QBluetoothLocalDevice::pairingStatus(const QBluetoothAddress &address) const

Devuelve el estado actual de emparejamiento bluetooth de address, si está sin emparejar, emparejado, o emparejado y autorizado.

void QBluetoothLocalDevice::powerOn()

Enciende el dispositivo después de devolverlo al estado hostMode(), si estaba apagado.

void QBluetoothLocalDevice::requestPairing(const QBluetoothAddress &address, QBluetoothLocalDevice::Pairing pairing)

Establezca el estado pairing con address. Los resultados son devueltos por la señal, pairingFinished().

En Android y macOS, AuthorizedPaired no es posible y tendrá el mismo comportamiento que Emparejado. En Windows, la decisión exacta del modo de emparejamiento depende del sistema operativo.

En macOS, no es posible desemparejar un dispositivo. Si se solicita Desemparejado, se emite inmediatamente pairingFinished() aunque el dispositivo permanece emparejado. Es posible solicitar el emparejamiento de un dispositivo previamente desemparejado. Además AuthorizedPaired tiene el mismo comportamiento que Paired.

Atención: la creación de un emparejamiento puede tardar minutos y puede requerir la confirmación del usuario.

void QBluetoothLocalDevice::setHostMode(QBluetoothLocalDevice::HostMode mode)

Establece el modo host de este dispositivo Bluetooth local en mode.

Algunas transiciones, como encender o apagar el dispositivo, pueden tardar algún tiempo. Por lo tanto, las llamadas posteriores sólo deben realizarse una vez que la señal hostModeStateChanged() haya concluido la solicitud anterior. Si esto se ignora, el resultado de tal serie de llamadas no estará bien definido.

Véase también hostMode().