视频接入分析服务 VIAS-创建边缘人脸提取作业:提取结果

时间:2023-12-26 14:16:16

提取结果

  1. 输出的JSON字符串主要包含两类信息:人脸图和原始图。
    • 输出类型支持配置data_category参数,取值范围为[FaceImage,OriginImage],分别表示是否发送人脸图和原始图(发送原始图片前,需要将origin_image_send_sw参数设置为1)。
    • 支持输出JSON字符串到指定的DIS。
    • 支持输出JSON字符串和图片到localpath(边缘节点本地路径),具体请参见存储路径的创建规则
    • 支持输出JSON字符串到用户填写的webhook请求头指定的URL。
  2. 输出结果示例:
    • 人脸图的JSON示例
      输出人脸图的JSON字符串到DIS:
      { 
          "event_type": 65536,
          "task_id": "a066974ae7334649a37257242c5fa4c3",
          "stream_id": "001", 
          "timestamp": 1527603463,
          "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688",
          "data": {
              "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97",
              "face_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9217",
              "detection_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218",
              "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218",
              "origin_image_path":"001/originimage/20181121/pic/2.jpg", 
              "origin_json_path":"001/originimage/20181121/json/2.txt",
              "bounding_box": { 
                  "x": 32, 
                  "y": 379, 
                  "w": 49, 
                  "h": 65 
              }
          },
          "image_base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE..." 
      } 

      输出人脸图的JSON字符串到localpath:

      { 
          "event_type": 65536,
          "task_id": "a066974ae7334649a37257242c5fa4c3",
          "stream_id": "001", 
          "timestamp": 1527603463,
          "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688",
          "data": {
              "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97",
              "face_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9217",
              "detection_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218",
              "image_path": "001/faceimage/20181121/pic/1.jpg",
              "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218",
              "origin_image_path":"001/originimage/20181121/pic/2.jpg", 
              "origin_json_path":"001/originimage/20181121/json/2.txt",
              "bounding_box": { 
                  "x": 32, 
                  "y": 379, 
                  "w": 49, 
                  "h": 65 
              }
          }
      } 

      输出人脸图的JSON字符串到webhook指定的URL:

      {
          "event_type": 65536,
          "task_id": "a066974ae7334649a37257242c5fa4c3",
          "stream_id": "001", 
          "timestamp": 1527603463,
          "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688",
          "data": {
              "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97",
              "face_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9217",
              "detection_id": "0DD1BEA6-634B-11E8-8B0B-407D0FAD9218",
              "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218",
              "origin_image_path":"001/originimage/20181121/pic/2.jpg", 
              "origin_json_path":"001/originimage/20181121/json/2.txt",
              "bounding_box": { 
                  "x": 32, 
                  "y": 379, 
                  "w": 49, 
                  "h": 65 
              }
          },
          "image_base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE..."
      }
    • 原始图的JSON示例
      输出原始图的JSON到DIS:
      { 
          "event_type": 65537,
          "task_id": "a066974ae7334649a37257242c5fa4c3",
          "stream_id": "001", 
          "timestamp": 1527603463,
          "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688",
          "data": {
              "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97",
              "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218",
          },
          "image_base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE..."
      }

      输出原始图的JSON到localpath:

      { 
          "event_type": 65537,
          "task_id": "a066974ae7334649a37257242c5fa4c3",
          "stream_id": "001", 
          "timestamp": 1527603463,
          "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688",
          "data": {
              "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97",
              "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218",
              "image_path": "001/originimage/20181121/pic/1.jpg"
          }
      } 

      输出原始图的JSON到webhook指定的URL:

      { 
          "event_type": 65537,
          "task_id": "a066974ae7334649a37257242c5fa4c3",
          "stream_id": "001", 
          "timestamp": 1527603463,
          "message_id": "E87B6D7C-4FFD-11EA-AD9D-34B354BC6688",
          "data": {
              "node_id": "8a188f57-1ac4-4ded-a485-972830ef8c97",
              "origin_image_id": "0DD1BF0A-634B-11E8-8B0B-407D0FAD9218",
          },
          "image_base64": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAIBAQE..."
      }
  3. 人脸图的JSON字段说明:
    • JSON格式说明

      字段

      类型

      说明

      stream_id

      String

      摄像头ID。

      event_type

      Uint64

      快速标识人脸提取算法的输出消息类型。人脸图json消息固定为65536,对应16进制为 0x 0000 0000 0001 0000。

      task_id

      String

      作业ID。

      timestamp

      Uint64

      图片解码时间的时间戳。

      message_id

      String

      本条数据的UUID。

      image_base64

      String

      人脸图Base64编码结果,输出类型为DIS、webhook时携带此字段。

      data

      Object

      人脸图业务输入内容。

    • data参数格式说明

      字段

      类型

      说明

      node_id

      String

      边缘节点编号。

      face_id

      String

      人脸图UUID。

      detection_id

      String

      人脸的检测ID,相同的detection_id表示同一个人脸。由于遮挡等原因,会存在人的跟踪路线丢失而ID发生变化的情况,所以该字段不建议作为检测自然人的唯一标识,仅作为辅助手段使用。

      image_path

      String

      人脸图本地存储路径,仅当输出类型为LOCALPATH时携带此字段。

      • 该路径(image_path)生成规则为“{stream_id}/faceimage/{当前日期}/pic/*.jpg”,文件名从“1.jpg”开始依次编号。
      • 人脸图片绝对路径={用户输入的挂载路径}+{image_path}。

      origin_image_id

      String

      人脸原始图UUID。如果“origin_image_send_sw”参数设为 0,即不输出原始图,则该字段为“00000000-0000-0000-0000-000000000000”

      origin_image_path

      String

      原始图本地存储路径。当原始图输出类型为Localpath并开启“发送原图开关”时,该字段才有信息,否则,字段内容为空。

      • 该路径(origin_image_path)生成规则为“{stream_id}/originimage/{当前日期}/pic/*.jpg”,文件名从“1.jpg”开始依次编号。
      • 原始图绝对路径={用户输入挂载路径}+{origin_image_path}。

      origin_json_path

      String

      原始图JSON结构化信息本地存储路径。当原始图输出类型为Localpath并开启“发送原图开关”时,该字段才有信息,否则,字段内容为空。

      • 该路径(origin_json_path)生成规则为“{stream_id}/originimage/{当前日期}/json/*.txt”,文件名从“1.txt”开始依次编号。
      • 原始图JSON结构化信息绝对路径={用户输入挂载路径}+{origin_json_path}。

      bounding_box

      Object

      人脸图在原始图中的位置信息。

    • bounding_box参数格式说明

      字段

      类型

      说明

      x

      Int

      矩形框左上角横坐标。

      y

      Int

      矩形框左上角纵坐标。

      w

      Int

      矩形框宽度。

      h

      Int

      矩形框高度。

  4. 原始图的JSON字段说明:
    • JSON格式说明

      字段

      类型

      说明

      stream_id

      String

      摄像头编号。

      event_type

      Uint64

      快速标识人脸提取算法的输出消息类型。原始图json消息固定为65537,对应16进制为 0x 0000 0000 0001 0001。

      task_id

      String

      作业ID。

      timestamp

      Uint64

      图片解码时间的时间戳。

      message_id

      String

      本条数据的UUID。

      image_base64

      String

      原始图Base64编码结果,输出类型为DIS、webhook时携带此字段。

      data

      Object

      原始图业务输入内容。

    • data参数格式说明

      字段

      类型

      说明

      node_id

      String

      边缘节点编号。

      origin_image_id

      String

      人脸原始图UUID。

      image_path

      String

      原始图信息本地存储路径,仅当输出类型为LOCALPATH时携带此字段。

      • 该路径(image_path)生成规则为“{stream_id}/originimage/{当前日期}/pic/*.jpg”,文件名从“1.jpg”开始依次编号。
      • 原始图绝对路径={用户输入挂载路径}+{image_path}。
  5. 输出类型为LOCALPATH时,会根据用户的选择,将人脸图或者原始图存储在边缘节点上,图片和JSON结构化信息分开存储。具体存储路径按照如下规则创建:
    • 人脸图JSON结构数据

      文件绝对路径={用户输入的挂载路径}/{stream_id}/faceimage/{当前日期}/json/*.txt

    • 人脸图

      文件绝对路径={用户输入的挂载路径}/{stream_id}/faceimage/{当前日期}/pic/*.jpg

    • 原始图JSON结构数据

      文件绝对路径={用户输入的挂载路径}/{stream_id}/originimage/{当前日期}/json/*.txt

    • 原始图

      文件绝对路径={用户输入的挂载路径}/{stream_id}/originimage/{当前日期}/pic/*.jpg

    • 文件名从1.txt或者1.jpg开始依次编号,人脸图或者原始图的JSON结构数据,与图片文件名相互对应。文件按照天存储,可以通过输入参数local_file_save_time对保存的天数进行控制,超期的文件将被自动删除。
    • 当使用同一个摄像头下发多个视觉作业的时候,需要确保每一个作业的挂载路径不一样,否则不同任务的数据会写到同一个文件夹下,造成数据冲突。
    • 当选择Localpath作为输出类型时,并且设置了发送原始图,挂载点路径需要有足够多的硬盘空间来保存原始图,否则会把挂载点的磁盘空间耗尽。
support.huaweicloud.com/api-vias/vias_03_0013.html