（1）语音播报模式、语音播报模式自定义内容

设备成功识别人员后，默认1：不播报语音。可选择1：不播报语音，2：播报名字，100：自定义。

 注意：a）播报自定义内容，只允许{name}字段，{name}字段格式固定，其他内容只允许数字、英文和汉字，不允许符号，长度限制255个字符。如：{name}欢迎光临。

b）生僻字、大写汉字、除英文外的其他语言文字无法播报，可播报简单的英文单词。

c）若人员设置了时间段权限passTime（参见时间段权限设置），人员在非允许的时间段内识别，设备会播报“姓名权限不足”。

（2）屏幕显示模式、屏幕显示模式自定义内容

设备成功识别人员后，默认1：显示人员姓名。可选择1：显示名字，100：自定义。

 注意：a）显示自定义内容，只允许{name}字段，{name}字段格式固定，其他内容只允许数字、中英文和中英文符号，长度限制255个字符。如：{name}，签到成功！

c）若人员设置了时间段权限passTime，人员在非允许的时间段内识别，设备识别人员后会显示 “姓名+权限不足” （参见时间段权限设置）。

（3）串口输出模式、串口输出模式自定义内容

设备成功人员后，串口输出默认1：开门信号，若设备连接了门禁，人员识别成功后就会触发开门。串口输出可选择1：开门，2：不输出，3：输出人员id，4：输出卡号idcardNum，100自定义。

 注意：a）只允许{id}、{idcardNum}字段，字段格式固定，其他内容只允许英文和英文字符，长度限制255个字符。

b）串口支持输出韦根信号，设备需要外接串口→韦根信号转换小板，小板由本公司定制。串口输出模式选择自定义，写入格式如图所示。{id}、{idcardNum}字段+数字组合后，韦根26范围为1-65535，有效范围为5位；韦根34范围为1-4294967295，有效范围10位。若超出范围，则输出的信号会进行转换，输出无效信号。

• 韦根26输出，”comModContent”: “#WG{id}#”
• 韦根34输出，”comModContent”: “#34WG{id}#”

（4）韦根类型及输出

设置韦根口的韦根信号输出，此参数只对Uface-M72XX设备有效。

韦根26传参格式为：”wg”:”#WG{id}#” 或 “wg”:”#WG{idcardNum}#”

韦根34传参格式为：”wg”:”#34WG{id}#” 或 “wg”:”#34WG{idcardNum}#”

 注意：a）Uface-M5201系列设备可以通过串口转换输出韦根信号。Uface-M7202系列、Uface-M7212设备硬件接口有串口和韦根口，既可通过串口转换输出韦根信号，也可通过韦根口直接输出韦根信号。

b）韦根26范围为1-65535，有效范围为5位；韦根34范围为1-4294967295，有效范围为10位。若超出范围，则输出的信号会进行转换，输出无效信号。

1.2.3.2陌生人参数

（1）陌生人开关

设备默认1：不识别陌生人，即只识别注册人员，对检测到的陌生人（非注册人员）不会记录识别结果。可选择2：识别陌生人，识别回调（参见识别回调）和识别记录都会有陌生人识别结果。

 注意：选择“识别陌生人”选项后，陌生人语音播报模式、陌生人判定配置项才会生效，参见（2）。

（2）陌生人语音播报模式、陌生人语音播报自定义内容

设备识别到陌生人后，设备不会弹窗文字提示，默认1：不播报语音。可选择1：不播报语音，2：语音播报 “陌生人警报”，100：自定义。

 注意：a）播报自定义内容，只允许数字、英文和汉字，不允许符号，长度限制255个字符。如：注意陌生人。

b）生僻字、大写汉字、除英文外的其他语言文字无法播报，可播报简单的英文单词。

（3）陌生人判定

设备判定人脸为陌生人所需时间等级，默认3；传入值请选择1-20之间的整数，1表示快速判定但精确率最低，随着数值增加，判定时间增长，精确度提高。

 注意：设备检测到人脸并进行识别，若多次识别均为非注册人员，则判定为陌生人。此处“时间等级”可理解为对同一人脸的识别次数。

1.2.3.3识别参数

（1）识别距离

• 设备对识别距离范围内的人脸进行检测识别，超出识别距离的人脸不会进行检测。默认0，无距离限制，只要设备检测到人脸（即出现人脸框）都会进行识别。
• 默认0：无限制，1：5米以内，2：1米以内，3：1.5米以内，4：2米以内，5：3米以内，6：4米以内。Uface-M5201系列设备设置0-6档均有效；Uface-M7202系列、Uface-M7212设备若识别等级设置为1或2，则识别距离可设置0-6档，若识别等级设置为3，则识别距离仅可设置0-3档。参见（4）识别等级。

 a）注意：识别距离不是通过距离感应，而是检测到的人脸框的大小通过函数计算得来的，因此识别距离不是精确的。

b）识别距离默认0：无限制。这里无限制表示只要人脸大小达到检测要求，就对人脸进行识别。识别等级1、等级2最远识别距离可达4-5米，识别等级3最远识别距为1.5-2米。

 

 

（2）识别（分数）阈值

设备识别人脸结果的过程，实际上是抓拍到的人脸与库内人员的注册照片进行比对，比对分数达到分数阈值，则判定人脸身份。识别分数阈值默认80，要求传入值为50-100的整数，分数越高，识别准确率越高，但识别速度会变慢。

 注意：a）设备对同一人脸进行多次比对，若前几次达不到分数阈值，则设备不会给出识别结果，因此会感觉识别时间较长、设备反应慢。

b）若设置分数阈值达到85分以上，抓拍人脸与注册照比对有很大概率达不到分数阈值，设备无法给出识别结果，即“不识别”。

（3）识别记录时间窗

时间窗内（N秒），同一人脸多次识别，只保留第一条识别记录。若设置了识别回调（参见识别回调），只回调第一条记录。默认值为0，即回调无时间间隔限制，每次识别都会进行回调。

 注意：a）时间窗对陌生人无效。

b）设备对人脸的每次识别结果，在网络通畅的情况下，都会实时推送到回调地址，时间差为毫秒级。

（4）识别等级

是否需要活体识别，此参数只对配备活体检测功能的Uface-72XX设备有效。等级1：快速识别，不能拒绝照片；等级2：能拒绝部分照片；等级3：能拒绝照片和视频。

 注意：Uface-M72XX设备，默认等级3，可更改识别等级。使用等级3时，识别距离最大建议1.5m。参见（1）识别距离。

（5）多个人脸检测设置

设备默认1：检测多个人脸并进行识别，即只要设备检测到人脸都会进行识别，每个人脸都会有识别结果（成功或失败）。可选择2：只检测多个人脸中最大的人脸并进行识别，即多个人脸只有最大人脸会有一个识别结果（成功或失败），适用于闸机等一次一人的场景。

（6）继电器控制时间

识别成功后，继电器输出开关量信号的持续的时间，默认500ms。连接门禁时表现为：识别成功后，开门到关门的时间间隔。传入值要求为100-25500，单位为ms。

 注意：a）根据使用的场景，选择开门到关门之间的时间间隔。

b）输入数值小于100会报错；数值向下取整百，如：输入101-199之间的数值，实际生效时间均为100ms。

c）Uface-M5201设备只有串口，因此外接信号转换后只能韦根、开关量（继电器）二选一。同理，Uface-M5201-GH内置三合一小板，接线有串口、韦根、继电器，但原始信号（串口）只有一个，只能选择一种信号输出