Bluetooth Low Energy 心拍数ゲーム

「Bluetooth Low Energy 心拍数ゲーム」では、 Qt Bluetooth APIを使用してBluetooth Low Energyアプリケーションを開発する方法を示しています。このアプリケーションでは、Bluetooth Low Energyデバイスのスキャン、デバイス上の心拍数サービスへの接続、特性値および記述子の書き込み、そして心拍数が変化した際のデバイスからの更新情報の受信といった処理を網羅しています。

このサンプルでは、以下の Qt クラスを紹介しています：

• QLowEnergyController
• QLowEnergyService
• QLowEnergyCharacteristic
• QLowEnergyDescriptor

このアプリケーションを動作させるには、心拍数サービスを備えたBluetooth Low Energyデバイスが必要です。代替手段として、このサービスをシミュレートできるプログラム可能なBluetooth Low Energyデバイスも利用できます。 その目的には、心拍数サーバーのサンプルを使用することもできます。そのようなデバイスが利用できない場合は、ランダムな値を生成して表示するデモモードが利用可能です。このデモモードは、コマンドラインで `--simulator ` を指定することで有効になります。

このゲームの目的は、測定された心拍数をできるだけ高くすることです。

Qt Bluetooth このサンプルで使用されているAPIの詳細な説明は 、Qt Bluetooth モジュールのドキュメントの「xml-ph-0000@deepl.internal Low Energy API の使用」セクションに記載されています。

心拍数測定デバイスが入手できない場合は、「Bluetooth Low Energy スキャナ」のサンプルの方が適している可能性があります。このスキャナのサンプルは、あらゆる種類の Bluetooth Low Energy 周辺機器で動作します。

例の動作

以下の場所からサンプルを実行できます：

• Qt Creator

  Welcome モードを開き、Examples からサンプルを選択してください。詳細については、Qt Creator の「チュートリアル：ビルドと実行」を参照してください。

• Qt Extension for Visual Studio Code

  Command Palette から `Qt: Open Qt examples ` コマンドを実行し、リストからサンプルを選択します。詳細については、Qt Extension for Visual Studio Code の「チュートリアル：ビルドと実行」を参照してください。

Bluetoothの権限の確認

アプリケーションが Bluetooth を使用できるようになる前に、適切な権限が付与されていることを確認する必要があります：

QBluetoothPermission permission{};
permission.setCommunicationModes(QBluetoothPermission::Access);
switch(qApp->checkPermission(permission)) {
caseQt::PermissionStatus::Undetermined:
    qApp->requestPermission(permission, this, &DeviceFinder::startSearch);
   return;
caseQt::PermissionStatus::Denied:
    setError(tr("Bluetoothの権限が許可されていません！"));
    setIcon(IconError);
    return;
caseQt::PermissionStatus::Granted:
    break;// 検索へ進む
}

ビジュアルツアー

このアプリケーションは、周辺にあるすべてのBluetooth Low Energy周辺機器を検索します。リモートデバイスは自身の存在をアドバタイズしているものと想定しています。検出されたデバイスはリストとして表示されます。なお、心拍数サービスを提供していない場合でも、検出されたすべてのBluetooth Low Energyデバイスがリストに表示される点に注意してください。

ユーザーが対象デバイスを選択すると、このサンプルは、利用可能な場合、そのデバイスの心拍数サービスに接続します。心拍数値の通知更新を自動的に有効にし、現在の値を画面に表示します。

モニタリング処理が終了すると、受信した値の簡単な要約が表示されます。

サンプルプロジェクト @ code.qt.io