Bluetooth Low Energy-Herzfrequenz-Spiel

Das Bluetooth Low Energy-Herzfrequenz-Spiel zeigt, wie man mithilfe der Qt Bluetooth API. Die Anwendung umfasst das Scannen nach Bluetooth Low Energy-Geräten, die Verbindung zu einem Herzfrequenz-Dienst auf dem Gerät, das Schreiben von Merkmalen und Deskriptoren sowie das Empfangen von Aktualisierungen vom Gerät, sobald sich die Herzfrequenz geändert hat.

Das Beispiel stellt die folgenden Qt-Klassen vor:

• QLowEnergyController
• QLowEnergyService
• QLowEnergyCharacteristic
• QLowEnergyDescriptor

Damit diese Anwendung funktioniert, ist ein Bluetooth-Low-Energy-Gerät mit einem Herzfrequenzdienst erforderlich. Eine Alternative könnte ein programmierbares Bluetooth-Low-Energy-Gerät sein, das den Dienst simulieren kann. Zu diesem Zweck können Sie auch das Beispiel „Heart Rate Server“ verwenden. Falls kein solches Gerät verfügbar ist, steht ein Demomodus zur Verfügung, der Zufallswerte generiert und anzeigt. Dieser Demomodus wird durch die Übergabe von „ --simulator “ über die Befehlszeile aktiviert.

Das Ziel des Spiels ist es, die gemessene Herzfrequenz so weit wie möglich zu erhöhen.

Eine ausführliche Erläuterung der in diesem Beispiel verwendeten APIs finden Sie im Abschnitt „Verwendung der Qt Bluetooth Low Energy-API“ der Qt Bluetooth Moduldokumentation.

Das Beispiel „Bluetooth Low Energy Scanner“ ist möglicherweise besser geeignet, wenn kein Herzfrequenzmessgerät verfügbar ist. Das Scanner-Beispiel funktioniert mit jedem beliebigen Bluetooth-Low-Energy-Peripheriegerät.

Ausführen des Beispiels

Sie können das Beispiel ausführen unter:

• Qt Creator

  Öffnen Sie den Modus „ Welcome “ und wählen Sie das Beispiel unter „ Examples “ aus. Weitere Informationen finden Sie unter Qt Creator: Tutorial: Erstellen und Ausführen.

• Qt Extension for Visual Studio Code

  Führen Sie den Befehl „ Qt: Open Qt examples “ aus dem Verzeichnis „ Command Palette “ aus und wählen Sie das Beispiel aus der Liste aus. Weitere Informationen finden Sie unter Qt Extension for Visual Studio Code: Tutorial: Erstellen und Ausführen.

Bluetooth-Berechtigungen prüfen

Bevor die Anwendung Bluetooth nutzen kann, müssen wir überprüfen, ob die entsprechenden Berechtigungen erteilt wurden:

QBluetoothPermission permission{};
permission.setCommunicationModes(QBluetoothPermission::Access);
switch (qApp->checkPermission(permission)) {
case Qt::PermissionStatus::Undetermined:
    qApp->requestPermission(permission, this, &DeviceFinder::startSearch);
   return;
case Qt::PermissionStatus::Denied:
    setError(tr("Bluetooth-Berechtigungen nicht erteilt!"));
    setIcon(IconError);
    return;
case Qt::PermissionStatus::Granted:
    break; // mit der Suche fortfahren
}

Visuelle Führung

Die Anwendung sucht nach allen Bluetooth-Low-Energy-Peripheriegeräten in der Umgebung. Es wird davon ausgegangen, dass die entfernten Geräte ihre Anwesenheit bekannt geben. Die gefundenen Geräte werden in einer Liste angezeigt. Beachten Sie, dass alle gefundenen Bluetooth-Low-Energy-Geräte aufgelistet werden, auch wenn sie keinen Herzfrequenzdienst anbieten.

Nachdem der Benutzer ein Zielgerät ausgewählt hat, stellt die Beispielanwendung eine Verbindung zu dessen Herzfrequenzdienst her, sofern ein solcher verfügbar ist. Sie aktiviert automatisch Benachrichtigungen zum Herzfrequenzwert und zeigt den aktuellen Wert auf dem Bildschirm an.

Sobald der Überwachungsvorgang abgeschlossen ist, wird eine kurze Zusammenfassung der empfangenen Werte angezeigt.

Beispielprojekt @ code.qt.io