视频接入分析服务 VIAS-创建边缘人脸提取作业:提取结果
提取结果
- 输出的JSON字符串主要包含两类信息:人脸图和原始图。
- 输出类型支持配置data_category参数,取值范围为[FaceImage,OriginImage],分别表示是否发送人脸图和原始图(发送原始图片前,需要将origin_image_send_sw参数设置为1)。
- 支持输出JSON字符串到指定的DIS。
- 支持输出JSON字符串和图片到localpath(边缘节点本地路径),具体请参见存储路径的创建规则。
- 支持输出JSON字符串到用户填写的webhook请求头指定的URL。
- 输出结果示例:
- 人脸图的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..." }
- 人脸图的JSON示例
- 人脸图的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
矩形框高度。
- JSON格式说明
- 原始图的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}。
- JSON格式说明
- 输出类型为LOCALPATH时,会根据用户的选择,将人脸图或者原始图存储在边缘节点上,图片和JSON结构化信息分开存储。具体存储路径按照如下规则创建:
- 文件名从1.txt或者1.jpg开始依次编号,人脸图或者原始图的JSON结构数据,与图片文件名相互对应。文件按照天存储,可以通过输入参数local_file_save_time对保存的天数进行控制,超期的文件将被自动删除。
- 当使用同一个摄像头下发多个视觉作业的时候,需要确保每一个作业的挂载路径不一样,否则不同任务的数据会写到同一个文件夹下,造成数据冲突。
- 当选择Localpath作为输出类型时,并且设置了发送原始图,挂载点路径需要有足够多的硬盘空间来保存原始图,否则会把挂载点的磁盘空间耗尽。