QBluetoothLocalDevice Class

Documentation des fonctions membres

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

Construit un objet `QBluetoothLocalDevice` avec ` parent`.

Voir également isValid().

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

Construisez un nouvel objet `QBluetoothLocalDevice` pour ` address`. Si ` address ` est instancié par défaut, le périphérique local résultant sélectionne le périphérique local par défaut.

Voir également isValid().

[virtual noexcept] QBluetoothLocalDevice::~QBluetoothLocalDevice()

Supprime l'QBluetoothLocalDevice.

QBluetoothAddress QBluetoothLocalDevice::address() const

Renvoie l'adresse MAC de ce périphérique Bluetooth.

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

Renvoie une liste de tous les périphériques Bluetooth locaux disponibles. Sous macOS, il n'existe qu'un seul périphérique local, le « périphérique par défaut ».

QList<QBluetoothAddress> QBluetoothLocalDevice::connectedDevices() const

Renvoie la liste des appareils connectés. Cette liste est différente de celle des appareils actuellement appairés.

Sous Android et macOS, il n'est pas possible de récupérer la liste des appareils connectés. Il est uniquement possible de surveiller les changements de connexion et de déconnexion. Pour plus de commodité, cette classe surveille tous les événements de connexion et de déconnexion depuis sa création et renvoie la liste actuelle lors de l'appel de cette fonction. Il est donc possible que cette fonction renvoie une liste vide peu après la création d'une instance.

Voir également deviceConnected() et deviceDisconnected().

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

Ce signal est émis lorsque l'appareil local établit une connexion avec un appareil distant via address.

Voir également deviceDisconnected() et connectedDevices().

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

Ce signal est émis lorsque l'appareil local se déconnecte d'un appareil Bluetooth distant via la fonction « address ».

Voir également deviceConnected() et connectedDevices().

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

Signal émis en cas d'error s exceptionnelles lors de l'appairage.

Cette fonction a été introduite dans Qt 6.2.

QBluetoothLocalDevice::HostMode QBluetoothLocalDevice::hostMode() const

Renvoie le mode hôte actuel de ce périphérique Bluetooth local. Sous macOS, il s'agit soit de « HostPoweredOff », soit de « HostConnectable ».

Voir également setHostMode().

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

L'state e de l'hébergeur a été transférée vers une autre adresse : HostMode.

bool QBluetoothLocalDevice::isValid() const

Renvoie « true » si l'QBluetoothLocalDevice e un périphérique Bluetooth local disponible ; sinon, renvoie « false ».

Si l’adaptateur Bluetooth local représenté par une instance de cette classe est retiré du système (par exemple, retrait de la clé Bluetooth sous-jacente), cette instance devient alors invalide. Une instance QBluetoothLocalDevice déjà invalide reste invalide même si le même adaptateur Bluetooth est réintégré au système.

Voir également allDevices().

QString QBluetoothLocalDevice::name() const

Renvoie le nom attribué par l'utilisateur à cet appareil Bluetooth.

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

Le couplage ou le découplage s'est achevé avec address. L'état actuel du couplage est disponible à l'adresse pairing. Si la demande de couplage a échoué, ce signal ne sera pas émis. Le signal errorOccurred() est émis si la demande de couplage a échoué. Ce signal n'est émis que pour les demandes de couplage qui ont été préalablement initiées en appelant la méthode requestPairing() de l'instance d'objet actuelle.

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

Renvoie l'état actuel de l'appairage Bluetooth de l'address, qu'il soit non appairé, appairé ou appairé et autorisé.

void QBluetoothLocalDevice::powerOn()

Allume l'appareil après l'avoir remis à l'état « hostMode » (), s'il était éteint.

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

Définissez l'état « pairing » à l'aide de ` address`. Les résultats sont renvoyés par le signal ` pairingFinished()`.

Sous Android et macOS, le mode « AuthorizedPaired » n’est pas disponible et le comportement est identique à celui du mode « Paired ». Sous Windows, le choix du mode d’appairage exact relève du système d’exploitation.

Sous macOS, il n’est pas possible de désappairer un appareil. Si « Unpaired » est demandé, pairingFinished() est immédiatement émis bien que l’appareil reste appairé. Il est possible de demander l’appairage d’un appareil précédemment désappairé. De plus, AuthorizedPaired se comporte de la même manière que Paired.

Attention : la création d'un appairage peut prendre plusieurs minutes et peut nécessiter une confirmation de la part de l'utilisateur.

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

Définit le mode hôte de ce périphérique Bluetooth local sur « mode ».

Certaines transitions, telles que la mise sous tension ou hors tension de l'appareil, peuvent prendre un certain temps. Par conséquent, les appels suivants ne doivent être effectués qu'une fois que le signal ` hostModeStateChanged()` a terminé la requête précédente. Si cette consigne n'est pas respectée, le résultat d'une telle série d'appels n'est pas bien défini.

Voir également hostMode().