华为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:表示发送

    sendRepeatFaceFlag

    Int

    是否重复发送清晰人脸图,开关打开后,同一个人只要显示更清晰的人脸会重复发送, 默认值:0。

    0:表示不发送

    1:表示发送

    sendOriImgCompressionRatio

    Int

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

    cropSizeMax

    Int

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

    cropSizeMin

    Int

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

    roi

    String

    检测区域配置。区域的设置由Polygon开头,其后依次为区域的坐标(按顺时针排列的x,y坐标)。默认值为Polygon 0 0 0 0,表示检测整个画面。

    sendUrl

    String

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

    faceQualityThreshold

    Float

    人脸清晰度阈值。清晰度大于此值的人脸才发送。取值范围[0.0, 1.0],默认值0.38。

    centerMode

    Int

    是否只检测roi区域中的最大人脸,默认值0。

    0:返回所有人脸。

    1:只返回roi中最大的人脸。

  • 示例

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

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