> For the complete documentation index, see [llms.txt](https://bm168x.gitbook.io/project/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bm168x.gitbook.io/project/v5r5c01_readme/xi-tong-dui-jie-shuo-ming-shu/dui-jie-se3-he-zi/7.-she-bei-shang-bao-xin-xi-de-jie-kou-gui-fan/7.1-shi-shi-shi-jian-shang-bao-nei-rong.md).

# 1. 实时事件上报

SE3 实时事件上报内容请参考：[SE3实时事件上报](/project/v2r4c01_readme/xi-tong-dui-jie-shuo-ming-shu/dui-jie-se3-he-zi/7.-she-bei-shang-bao-xin-xi-de-jie-kou-gui-fan/7.1-shi-shi-shi-jian-shang-bao-nei-rong.md)。

## 其他SE AI计算盒实时事件上报：

**功能描述：**

SE AI计算盒实时上报所有比对事件到管理平台。

**调用方法**

调用方法: WebSocket

1）websocket端口为：ws\://IP:5679

2）连接成功之后不会发送任何东西，接下来需要对ws进行配置：

主要配置以下几个字段：

| 参数名            | 类型   | 默认值   | 说明                                     |
| -------------- | ---- | ----- | -------------------------------------- |
| need\_face     | bool | False | 是否要返回现场人脸图，数据类型为base64编码的jpg           |
| need\_register | bool | False | 是否需要返回注册的底库图，比对通过的情况，数据类型为base64编码的jpg |
| event\_list    | list | \[ ]  | 需要实时推送的device id list                  |

3）ws有event之后，会根据配置来决定是否需要进行推送

4）获取设备id可以用如下Get接口获取：

<http://IP:5555/SophonDevice/api/Devices>

**参数描述（JSON格式）：**

|                |                  |        |        |                                                                    |                       |
| -------------- | ---------------- | ------ | ------ | ------------------------------------------------------------------ | --------------------- |
| **一级参数**       | **二级参数**         | **类型** | **选择** | **说明**                                                             | 举例                    |
| identity\_id   |                  | string | **必选** | 用户编号                                                               | "12345565"            |
| device\_id     |                  | string | **必选** | 产生event的设备id，uuid                                                  |                       |
| identity\_name |                  | string | **必选** | 用户名称                                                               | "Tom"                 |
| identity\_info |                  | dict   | **必选** | 人员底库注册时候的info字段，陌生人为空字典                                            |                       |
| group\_name    |                  | string | **必选** | 比对的group name，如果没有group\_name返回group\_id                           | "default\_group"      |
| reg\_pic       |                  | base64 | 可选     | 注册的人脸底库，默认上传，可配置去除                                                 | "/9j/6QAEAAD/2wBD..." |
| timestamp      |                  | int32  | **必选** | 事件发生的时间戳                                                           | 1565771454932         |
| score          |                  | float  | **必选** | 比对的分数                                                              | 0.78                  |
| ext\_data      |                  | dict   | **必选** | 拓展数据字段，可迭代添加                                                       |                       |
|                | device\_ip       | sting  | **必选** | 设备ip                                                               | "192.168.1.101"       |
|                | spot\_pic        | base64 | 可选     | 现场照片，迎宾机模式下不传                                                      | "/9j/6QAEAAD/2wBD..." |
|                | recognize\_face  | base64 | 可选     | 背景图中经过剪切后的人脸图                                                      | "/9j/xxewAAD/wds2..." |
|                | person\_type     | int    | **必选** | <p>1：员工（默认为员工，包括这个字段不存在的情况）<br>2：访客<br>3：黑名单<br>4：陌生人<br>5：VIP</p> | 1                     |
|                | device\_type     | string | **必选** | <p>0：闸机<br>1：抓拍机<br>3：IPC 动态<br>4：门禁</p>                           | 0                     |
|                | grab\_fiqa\_info | dict   | **必选** | 返回抓拍机得人脸质量检测结果，详细参考历史信息详情示例                                        |                       |
|                | box\_fiqa\_info  | dict   | **必选** | 返回AI BOX得人脸质量检测结果，详细参考历史信息详情示例(臻识抓拍机有效)                            |                       |

**返回信息：**

```
{
    "reg_pic":"/9j/6QAEAAD/2wBD...",
    "ext_data":{
        "person_type":5,
        "grab_fiqa_info":{

        },
        "device_ip":"192.168.1.243",
        "box_fiqa_info":{

        },
        "device_type":"0",
        "spot_pic":"/9j/6QAEAAD/2wBD..."，
        "recognize_face":"/9j/xxewAAD/wds2..."
    },
    "identity_id":"666666",
    "device_id":"23c7232b-0b35-4813-be6b-6ec4ee21ac4f",
    "identity_info":{
            "image_id" : "7bab3d75-ae0b-44db-bbbd-8d5eb788385a",
        "permission_ids" : [ 
            "9ded10eff6804f3da4d99c25fcaf7383"
        ],
        "type" : 1,
        "user_id" : "01220615",
        "face_ids" : [ 
            "53be77f3-91a7-4835-bbb8-1cced2354785"
        ],
        "name" : "ran93717829",
        "ext_info" : {
            "building_no" : "1",
            "room" : "101",
            "address" : "address",
            "floor" : "1"
        }
    }
    "score":0.6231614351272583,
    "timestamp":1566016554020,
    "group_name":"default_group",
    "identity_name":"小明"
}
```

websocket获取结果示例：

```
import websocket
import json
s=websocket.WebSocket()
s.connect('ws://192.168.1.52:5679')
config = {'need_face':True, 'need_register':True, 'event_list':["04f98265-1fad-47e5-9dda-66e191272055", "f9f0768f-497c-45f3-9307-ae80a9d89390", "804b1218-218e-4465-8e1f-c305a5981001", "9483034a-da64-4db0-b223-64e87d5567db"]}
json_data = json.dumps(config)
s.send(json_data)
while True:
info = s.recv_data(4096)
event = json.loads(str(info[1], encoding='utf8'))
print("{} {}".format(event['video_id'], event['event_id']))
```