Skip to main content
版本:v3

HeartRate

API_LEVEL 2.0 开始支持,API 兼容性请参考 API_LEVEL

心率传感器。

信息

权限代码: data:user.hd.heart_rate

方法

getCurrent

获取最近一次心率持续测量的测量值,此方法需要在 onCurrentChange 回调函数中使用,注册 onCurrentChange 事件后,设备会开启心率持续测量,以一定频率更新心率持续测量的测量值

getCurrent(): number

getLast

获取最近一次的心率测量值。设备心率自动监测会更新心率测量值,注册 onCurrentChange 后设备开始持续测量心率,也会更新心率测量值

getLast(): number

getToday

获取当日自 0 时起至当前时刻以分钟计的心率测量值数据,数组最长为 60*24

getToday(): Array<number>

onCurrentChange

API_LEVEL 2.1

调用此方法后设备开始心率持续测量,并注册回调函数,当有测量结果时调用回调函数,在回调函数中调用 getCurrent 方法可以获取心率持续测量的测量值,如需停止持续心率测量,需要调用 offCurrentChange 方法

onCurrentChange(callback: () => void): void

offCurrentChange

API_LEVEL 2.1

取消持续心率测量,并取消回调函数监听

offCurrentChange(callback: () => void): void

onLastChange

API_LEVEL 2.1

注册心率测量值变化事件回调函数

onLastChange(callback: () => void): void

offLastChange

API_LEVEL 2.1

取消心率测量值变化事件回调函数

offLastChange(callback: () => void): void

getDailySummary

API_LEVEL 3.0

获取心率日统计数据

getDailySummary(): Result

Result

属性类型说明API_LEVEL
maximumMaximum最高心率信息3.0

Maximum

属性类型说明API_LEVEL
hr_valuenumber最高心率值3.0
timenumber最高心率的测量时间3.0

getResting

API_LEVEL 3.0

获取当前静息心率

getResting(): number

getAFibRecord

API_LEVEL 3.0

获取房颤数据数组

getAFibRecord(): Result

Result

类型说明
Array<AfibInfo>房颤信息数组

AfibInfo

属性类型说明API_LEVEL
flagnumber房颤检测结果,0 - 正常、1 - 高预警、2 - 低预警、3 - 房颤3.0
valnumber房颤数据值,值为 0 - 255 的整数3.0
maxValuenumber房颤数据最大值,值为 0 - 255 的整数3.0
minValuenumber房颤数据最小值,值为 0 - 255 的整数3.0
timenumber房颤数据采集的时间,UTC 秒3.0
durationnumber持续时间,单位秒3.0

onRestingChange

API_LEVEL 3.0

调用此方法后设备开始实时静息心率测量,并注册回调函数,当有测量结果时调用回调函数,在回调函数中调用 getResting 方法可以获取静息心率测量值,如需停止静息心率测量,需要调用 offRestingChange 方法

onRestingChange(callback: () => void): void

offRestingChange

API_LEVEL 3.0

取消静息心率持续测量,并取消回调函数监听

offRestingChange(callback: () => void): void

代码示例

import { HeartRate } from '@zos/sensor'

const heartRate = new HeartRate()
const lastValue = heartRate.getLast()

const callback = () => {
console.log(heartRate.getCurrent())
}

heartRate.onCurrentChange(callback)

// When not needed for use
heartRate.offCurrentChange(callback)