Coolwear SDK 指标清单

这份清单只说明 SDK 留了接口。具体戒指是否支持，要看固件和功能开关，也还没有用真戒指验证过。

来源：Coolwear/iosSdk 提交 19d603a（2026-11-02），主文档 v1.0.4（2026-10-24）。

按依据筛选

健康指标

7 项

指标	字段	单位和获取方式	依据
心率	`heartNum`、`time`	次/分。单次测量、自动、历史。	文档
运动中心率	`heartNum`、`time`	次/分。运动中上报。	文档
血氧	`oxygen`、`time`	%。单次测量、自动、历史。	文档
皮肤温度	`tempNum`、`time`	℃。仅历史，上限截在 42℃。	文档
压力	`heartNum`、`time`	单位文档未写。单次测量、自动、历史。来自旧版 HRV 接口；文档说它存放压力值，同一处又说可能是 HRV 指标或异常值，含义要找厂商确认。	文档
血压	`systolic`、`diastolic`、`time`	文档为 mmHg。单次测量。	文档
ECG 汇总	`heart`、`sbp`、`dbp`、`oxygen`、`time`	单位未逐项写明。单次测量，没有波形。	文档

9 项

新版 RRI-HRV 有实时和历史两种，每条结果都包含下面这些字段。

指标	字段	单位或取值	依据
平均 RR 间期	`meanRR`	毫秒	头文件
SDNN	`sdnn`	毫秒	头文件
RMSSD	`rmssd`	毫秒	头文件
pNN50	`pnn50`	%	头文件
平均心率	`meanHR`	次/分	头文件
有效间期数	`validCount`	个	头文件
被剔除间期数	`rejectedCount`	个	头文件
数据质量	`quality`	0 无效，1 低，2 中，3 好	头文件
状态标记	`flags`	含义未写明	头文件

3 项

SDK 只给分段状态，没有现成的睡眠时长、深睡时长、睡眠效率或睡眠得分，这些要 App 自己算。

8 项

指标	字段	单位或说明	依据
步数、距离	`walkSteps`、`walkDistance`	距离单位未写明	文档
卡路里	`walkCalories`	单位文档未写	文档
活动时长	`walkDuration`	秒	文档
运动类型	`sport_type`	140 多种	文档
运动起止和总时长	`start_time`、`end_time`、`total_time`	总时长单位未写明	文档
单次运动步数、距离、卡路里	`step`、`distance`、`calories`	单位文档未写	文档
单次运动速度	`speed`、`max_speed`	单位文档未写	文档
单次运动心率	`heartrate`、`aver_hr`、`max_hr`	单位文档未写	文档

3 项

数据	字段	说明	依据
PPG 原始数据	`ppgData`	有开关指令，格式未写明。	库字段
加速度原始数据	`gsensorRawDatas`	有开关指令。库里相邻字段有 `sample_rate`、`sample_count`，推测属于它。	库字段
体感数据	`speed_throw`、`x`、`y`	用于体感游戏，未写明来自哪种传感器。	文档

7 项

指标	字段	说明	依据
电量	`battery_capacity`	0–100	文档
充电状态	`charger_status`	文档说一般 0 未充电、1 充电中	文档
设备标识	`macAddr`、`version`	MAC 地址和版本号	文档
硬件版本信息	`hardware_id`、`code_id`、`picture_id`、`font_id`	各模块版本号	文档
计数器	`counterNum`	可读取和清零	文档
手势场景	`data`	手势配置的返回值	文档
功能开关	`hrvSupport`、`temp_supported`、`gestureSupport` 等	用来判断型号支持哪些功能	文档

佩戴状态、电池续航估算、LED 波长和颗数。

睡眠得分、效率、时长和入睡时长。

精力分、生物年龄、恢复分和个人基线。

呼吸率、打鼾和呼吸暂停。