# 视频生理分析
# 1) 请求地址
/healthAnalysis
Request Header: Content-Type:application/x-www-form-urlencoded
# 2) 调用方式:HTTP POST
# 3) 接口描述:
- 视频文件上传成功后,调用视频分析接口来获取生理数据
# 4) 请求参数:
# POST参数:
| 参数名 | 格式 | 必填 | 说明 |
|---|---|---|---|
| pid | String(32) | Y | 合作客户平台ID,由奇点分配 |
| appid | String(32) | Y | 合作客户申请开通的服务ID,由奇点分配 |
| timestamp | Long(13) | Y | 毫秒级时间戳,请求时间和奇点服务器时间相差不能超过10分钟,否则会拒绝请求 |
| sign | String(32) | Y | 请求签名 |
| token | String(64) | N | 接口调用临时token,token有效期24小时,超过有效期或token错误需要校验签名 |
| obj_name | String(64) | Y | oss 上传的 obj_name 例如 health_video/yourvideo.mp4 |
| uid | String(32) | N | 被测者id,客户的用户自定义,不做要求 |
| rot | int | N | 某些设备录制的视频角度存在偏移,此参数用来修正视频旋转角度(90,180,270) |
| left | int | N | 用来标记人脸所在区域左上角x坐标 |
| top | int | N | 用来标记人脸所在区域左上角y坐标 |
| width | int | N | 用来标记人脸所在区域宽度 |
| height | int | N | 用来标记人脸所在区域高度 |
| player_age | int | N | 被测者年龄 |
| player_height | int | N | 被测者身高 厘米 |
| player_weight | int | N | 被测者体重 市斤 |
# 视频 file 参数:
编码格式:H.264 FPS: 30 码率:720p > 3500Kbps; 1080p > 8500Kbps 时长:至少15s 音频:非必要
注:15 秒视频,帧率 30fps,意味着需要总帧数不少于 450 帧,建议录制视频时长略长于 15s,如果视频帧率无法达到 30fps,可适当延长录制时长以满足总帧数不少于 450 帧,过低的视频帧率会严重影响准确度。
同时录制的视频中人脸尽量保持静止,否则也会影响准确度
# 5) 请求返回结果:
正确:
{
"ret": true,
"result": {
"hr": "75",
"spo2": "96.0",
"br": "15",
"bmi":"23",
"sbp": "134.93327",
"dbp": "88.83565"
},
"token": "F#IS9S@1*L^owoM742P*R=VsQv7skm4Rfa=mosMdhbI$&z6/vHyNR4D=tebLQjGK",
"tokenExpiryTime": 1631129416000
}
错误:
{
"ret": false,
"ErrorCode": "TimestampExpiration",
"ErrorMessage": "Signatures are valid for more than 10 minutes"
}
# 6) 请求返回结果参数说明:
| 字段名称 | 字段说明 | 类型 | 必填 | 备注 |
|---|---|---|---|---|
| ret | 成功与否 | bool | Y | - |
| token | openapi token | string | N | ret 为 true 必填 |
| tokenExpiryTime | openapi token 过期时间 | long | N | ret 为 true 必填 |
| ErrorCode | 错误码 | string | N | ret 为 false 必填 |
| ErrorMessage | 错误信息 | string | N | ret 为 false 必填 |
| result | 返回结果 | obj | N | ret 为 true 必填 |
| hr | 心率 | string | N | ret 为 true 必填 |
| sbp | 收缩压 | string | N | ret 为 true 必填 |
| dbp | 舒张压 | string | N | ret 为 true 必填 |
| br | 呼吸率 | string | N | ret 为 true 必填 |
| spo2 | 血氧 | string | N | ret 为 true 必填 |
| bmi | 身体质量指数 | string | N | ret 为 true 必填 |