# 视频生理分析

# 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 必填
Last Updated: 3/10/2022, 2:44:22 PM