本文介绍线上监考MonitorExamination的语法及示例。

功能描述

在线监考可以对线上考试的考生行为进行识别,支持屏幕聊天工具检测和考生状态检测。

  • 屏幕聊天工具检测:输入截屏图像,判断是否出现常见的聊天工具。
  • 考生状态检测:利用考生的前置摄像机获取图像,判断出现的人脸人体个数、人脸角度朝向、是否戴耳机,是否使用手机。

应用场景

  • 个人远程在线考试。
  • 个人线下固定机位考试。

特色优势

  • 功能集成度高,一个接口可输出对当前考生的所有行为监测。
  • 针对常见聊天工具有单独的页面检测,可杜绝考生远程聊天作弊。
  • 可支持单机位(如PC),也可根据需求支持双机位算法(如手机架设)。

前提条件

请确保您已开通人脸人体服务,若未开通服务请立即开通

输入限制

  • 图像格式:JPG、PNG。
  • 图像大小:小于5M。
  • 图像分辨率:大于480×640像素,小于720×1280像素。
  • URL地址中不能包含中文字符。
说明 当图像分辨率超过最大限制时,请先将图片进行缩放,调整图片大小,具体请参见图片缩放

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Type Long 1

检测类型。

  • 0:屏幕聊天工具检测
  • 1:考生状态检测
ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/MonitorExamination1.jpg

图像URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
RequestId String D0F6EB94-73B6-4CB8-B266-22D2F221C475

请求ID。

Data object

返回的结果数据内容。

FaceInfo object

中心人物的人脸信息。当请求参数Type取值为1时显示该参数。

Completeness Long 1

人脸完整度分数,取值范围(0,1)。

FaceNumber Long 1

检测到的人脸人数,0代表未检测到考生人脸。

Pose object

正对摄像机时3个角度都为0, 取值范围正负90度之间。

Pitch Float -0.9185499548912048

上下俯仰角角度,抬头为正值,低头为负值。

Roll Float -0.18541647493839264

人脸在画面中顺时针转动为正值,逆时针转动为负值。

Yaw Float 8.095342636108398

向左看为正值,向右看为负值。

PersonInfo object

中心人物的属性行为信息。当请求参数Type取值为1时显示该参数。

CellPhone object

打电话。

Score Float 0.39076218008995056

打电话的概率分数,取值范围(0,1)。

Threshold Float 0.6

建议阈值。

说明 仅作为参考,实际应用中根据测试情况选取合适的Score阈值即可。
EarPhone object

戴耳机。

Score Float 0.7980290651321411

戴耳机的概率分数,取值范围(0,1)。

Threshold Float 0.6

建议阈值。

说明 仅作为参考,实际应用中根据测试情况选取合适的Score阈值即可。
PersonNumber Long 1

检测到的总人数,0代表未检测到考生。

ChatScore Float 0.28805577754974365

屏幕截图包含聊天工具的概率,取值范围(0,1)。

当请求参数Type取值为0时显示该参数。

Threshold Float 0.5

建议阈值,取值范围(0,1)。当ChatScore大于阈值时,系统判定输入屏幕截图中包含聊天工具。

当请求参数Type取值为0时显示该参数。

示例

请求示例

http(s)://[Endpoint]/?Type=1
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/MonitorExamination1.jpg
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>D0F6EB94-73B6-4CB8-B266-22D2F221C475</RequestId>
<Data>
    <FaceInfo>
        <Completeness>1</Completeness>
        <FaceNumber>1</FaceNumber>
        <Pose>
            <Pitch>-0.91854995</Pitch>
            <Roll>-0.18541647</Roll>
            <Yaw>8.095343</Yaw>
        </Pose>
    </FaceInfo>
    <PersonInfo>
        <CellPhone>
            <Score>0.39076218</Score>
            <Threshold>0.6</Threshold>
        </CellPhone>
        <EarPhone>
            <Score>0.79802907</Score>
            <Threshold>0.6</Threshold>
        </EarPhone>
        <PersonNumber>1</PersonNumber>
    </PersonInfo>
    <ChatScore>0.28805578</ChatScore>
    <Threshold>0.5</Threshold>
</Data>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "D0F6EB94-73B6-4CB8-B266-22D2F221C475",
  "Data" : {
    "FaceInfo" : {
      "Completeness" : 1,
      "FaceNumber" : 1,
      "Pose" : {
        "Pitch" : -0.91854995,
        "Roll" : -0.18541647,
        "Yaw" : 8.095343
      }
    },
    "PersonInfo" : {
      "CellPhone" : {
        "Score" : 0.39076218,
        "Threshold" : 0.6
      },
      "EarPhone" : {
        "Score" : 0.79802907,
        "Threshold" : 0.6
      },
      "PersonNumber" : 1
    },
    "ChatScore" : 0.28805578,
    "Threshold" : 0.5
  }
}

错误码

关于在线监考的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。