搜索插件、代码仓与 APP 分类

GitHub 代码仓kvedala/heart_bpm

heart_bpm

使用智能手机摄像头测量心率的 Flutter 插件

heart_bpm 项目封面
星标
22
复刻
19
最近推送(UTC)
2023年10月28日
项目状态
未归档

原始 README

以下为英文项目原文快照,最新内容请访问 GitHub。

heart_bpm

Widget to measure heart rate in beats per minute using the camera of smartphone.

Working principle

Covering the camera lens with the fingertip enables the camera to measure the subtle changes in skin tone. These are proportional to the changes in the blood flow through the arteries just below the skin of the fingertip. This is in-turn correlated to the heart beats. Hence, the variations in the skin tone can be approximated to the instances of heart beats. Measuring the time differences between the peaks provides Beats per Minute.

These values are not stable and hence, an exponential moving average filter is implemented. The smoothing factor α, can be controlled by the user from the calling widget.

Implementation

To access the camera, the module utilizes the camera package. Hence, the requirements to use this package have the same requirements.

Android

Minimum android SDK version: 21

Change the minimum Android sdk version to 21 (or higher) in your android/app/build.gradle file.

minSdkVersion 21
iOS

iOS 10.0 of higher is needed to use the camera plugin. If compiling for any version lower than 10.0 make sure to check the iOS version before using the camera plugin. For example, using the device_info plugin.

Add two rows to the file ios/Runner/Info.plist:

  • one with the key Privacy - Camera Usage Description and a usage description.
  • and one with the key Privacy - Microphone Usage Description and a usage description.

Or in text format add the key:

<key>NSCameraUsageDescription</key>
<string>Heart BPM plugin would like to use camera to measure your heart rate.</string>
<key>NSMicrophoneUsageDescription</key>
<string>Can I use the mic please?</string>

The microphone key is required though the feature is not being used and no audio is enabled in the implementation.

Getting Started

The module can be used simply by accessing it as a widget.

  1. Import the module:

    import 'package:heart_bpm/heart_bpm.dart';
    
  2. Access the widget as simply as:

    /// list to store raw values in
    List<SensorValue> data = [];
    
    /// variable to store measured BPM value
    int bpmValue;
    
    @override
    Widget build(BuildContext context) {
    return Scaffold(
        appBar: AppBar(
            title: Text('Heart BPM Demo'),
        ),
        body: Column(
        children: [
            isBPMEnabled ? HeartBPMDialog(
                    context: context,
                    onRawData: (value) {
                        setState(() {
                            // add raw data points to the list
                            // with a maximum length of 100
                            if (data.length == 100)
                                data.removeAt(0);
                            data.add(value);
                        });
                    },
                    onBPM: (value) => setState(() {
                        bpmValue = value;
                    }),
                )
              : SizedBox(),
          Center(
            child: ElevatedButton.icon(
                icon: Icon(Icons.favorite_rounded),
                label: Text(isBPMEnabled
                    ? "Stop measurement" : "Measure BPM"),
                onPressed: () => setState(() =>
                    isBPMEnabled = !isBPMEnabled
                ),
            ),
          ),
        ],
      ),
    );
    

Contributors

Contributor Profile Picture
Karl Mathuthu Karl Mathuthu
Krishna Vedala Krishna Vedala
Krishna Vedala GitHub avatar
GitHub 作者

Krishna Vedala ↗

Toronto
语言DartRubySwiftKotlinObjective-C

分类

此仓库发布的插件

使用的依赖

依赖清单 4 项

如何选择适合项目的代码仓?

先按使用场景筛选,再比较项目活跃情况,最后到原始仓库核对使用要求。

  1. 通过仓库名、作者或描述搜索,再按技术分类缩小范围。
  2. 结合星标、复刻与最近推送比较项目;星标反映社区关注,不代表质量保证。
  3. 使用前在 GitHub 核对 README、许可证与 Issues。

来源与维护

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗