블루투스 저에너지 심박수 게임

이 ‘블루투스 저에너지 심박수 게임’은 다음을 활용하여 블루투스 저에너지 애플리케이션을 개발하는 방법을 보여줍니다 Qt Bluetooth API를 사용하여 블루투스 저에너지 애플리케이션을 개발하는 방법을 보여줍니다. 이 애플리케이션은 블루투스 저에너지 장치 검색, 장치의 심박수 서비스에 연결, 특성 및 설명자 기록, 그리고 심박수가 변경되었을 때 장치로부터 업데이트를 수신하는 과정을 다룹니다.

이 예제에서는 다음과 같은 Qt 클래스를 소개합니다:

• QLowEnergyController
• QLowEnergyService
• QLowEnergyCharacteristic
• QLowEnergyDescriptor

이 애플리케이션이 작동하려면 심박수 서비스가 탑재된 블루투스 저에너지(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: 튜토리얼: 빌드 및 실행을 참조하십시오.

블루투스 권한 확인

애플리케이션이 블루투스를 사용하기 전에, 적절한 권한이 부여되었는지 확인해야 합니다:

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("블루투스 권한이 허용되지 않았습니다!"));
    setIcon(IconError);
    return;
case Qt::PermissionStatus::Granted:
    break; // 검색으로 진행
}

시각적 안내

이 애플리케이션은 주변의 모든 블루투스 저에너지(Bluetooth Low Energy) 주변 기기를 검색합니다. 원격 기기들이 자신의 존재를 알리고 있다고 가정합니다. 검색된 기기들은 목록으로 표시됩니다. 심박수 서비스를 제공하지 않는 블루투스 저에너지 기기라도 검색된 모든 기기가 목록에 표시된다는 점에 유의하십시오.

사용자가 대상 기기를 선택하면, 이 예제는 심박수 서비스가 사용 가능한 경우 해당 서비스에 연결합니다. 이후 심박수 값에 대한 알림 업데이트를 자동으로 활성화하고 화면에 현재 값을 표시합니다.

모니터링 과정이 완료되면 수신된 값에 대한 간략한 요약이 표시됩니다.

예제 프로젝트 @ code.qt.io