华为HILENS-人脸客流统计技能:运行时配置参数

时间:2024-04-03 16:00:19

运行时配置参数

技能在运行时,需要添加运行时配置。配置完成后,参数会从华为HiLens云侧下发到端侧设备。

  • 配置参数说明

    技能相关配置参数设计如表3所示。

    表3 运行时配置参数

    名称

    是否必选

    参数类型

    说明

    logLevel

    Enum

    日志级别,包括INFO,DEBUG,WARNING和ERROR。建议设置为INFO。

    keep_running

    Int

    当技能崩溃是否自动拉起技能并持续运行。此项配置在1.1.0及以后版本起作用。

    multi_camera

    List

    一个设备上多路视频的技能参数,详情请参见表4

    表4 视频参数说明

    名称

    是否必选

    参数类型

    说明

    camera_names

    List

    摄像头名称。可配置多个名称,表示多个摄像头采用同样的技能配置。

    sendOriImgFlag

    Int

    是否发送人脸背景原始图,默认值:0。

    0:表示不发送

    1:表示发送

    sendOriImgCompressionRatio

    Int

    原始图jpeg压缩百分比,默认值为90,表示图片压缩比90%,取值范围[1 100]。

    cropSizeMax

    Int

    发送人脸图片长宽的最大像素,默认值400。

    cropSizeMin

    Int

    发送人脸图片长宽的最小像素,默认值80。

    faceQualityThreshold

    Float

    人脸质量总分阈值,质量分大于此值的人脸才会抓拍,默认值0.25。

    facePoseThreshold

    Float

    人脸姿态分阈值,质量分小于此值的人脸才会抓拍,默认值0.45。

    faceBlurThreshold

    Float

    人脸模糊度阈值,质量分小于此值的人脸才会抓拍,默认值0.55。

    faceMargin

    Float

    上报人脸时人脸框的外扩比例,默认值2.0。

    passLineThreshold

    Float

    进店统计时判断过线的Y轴坐标比值,默认为0.9。例如分辨率为1920x1080,比值0.75即1080*0.75=810。

    sendUrl

    String

    发送技能消息POST请求的URL地址。

  • 示例

    HiLens Kit设备支持多路摄像头接入,如果要为不同的摄像头设置不同的技能配置,或者几个摄像头共用同一技能配置,则可在配置列表中给出相应的配置信息,示例如下:

    //Store001的两个摄像头pos1和pos2配置不同参数:
    { 
      "logLevel": "INFO",
      "keep_running": 1,
      "multi_camera": 
             [{
              "camera_names": ["store001_pos1"],
              "sendOriImgFlag": 0,
              "sendOriImgCompressionRatio": 90,
              "cropSizeMax": 400,
              "cropSizeMin": 100,
              "faceQualityThreshold": 0.25,
              "facePoseThreshold": 0.45,
              "faceBlurThreshold": 0.55,
              "faceMargin": 2.0,
              "passLineThreshold": 0.9,
              "sendUrl": "https://abc.company.com/face",
             },
             {
              "camera_names": ["store001_pos2"],
              "sendOriImgFlag": 1,
              "sendOriImgCompressionRatio": 100,
              "cropSizeMax": 300,
              "cropSizeMin": 80,
              "faceQualityThreshold": 0.25,
              "facePoseThreshold": 0.45,
              "faceBlurThreshold": 0.55,
              "faceMargin": 2.0,
              "passLineThreshold": 0.9,
              "sendUrl": "https://abc.company.com/face",
              }]
    }
    //Store002的两个摄像头pos1和pos2配置相同参数:
    { 
      "logLevel": "INFO",
      "keep_running": 1,
      "multi_camera": 
             [{
              "camera_names": ["store002_pos1","store002_pos2"],
              "sendOriImgFlag": 0,
              "sendOriImgCompressionRatio": 90,
              "cropSizeMax": 400,
              "cropSizeMin": 120,
              "faceQualityThreshold": 0.25,
              "facePoseThreshold": 0.45,
              "faceBlurThreshold": 0.55,
              "faceMargin": 2.0,
              "passLineThreshold": 0.9,
              "sendUrl": "https://abc.company.com/face",
             }]
    }
support.huaweicloud.com/usermanual-hilens/hilens_02_0124.html