本文介紹人臉人體（facebody）類目下的線上監考MonitorExamination的語法及示例。

功能描述

在線監考能力可以對線上考試的考生行為進行識別，支持屏幕聊天工具檢測和考生狀態檢測。

  • 屏幕聊天工具檢測：輸入截屏圖像，判斷是否出現常見的聊天工具。
  • 考生狀態檢測：利用考生的前置攝像機獲取圖像，判斷出現的人臉人體個數、人臉角度朝向、是否戴耳機，是否使用手機。
說明
  • 您可以進入在線咨詢獲取在線人工幫助。
  • 當前能力可在視覺智能開放平臺有完整的免費產品體驗，您可以單擊立即試用對該能力進行更直觀試用以及在線購買。
  • 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等，請通過釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢群聯系我們。

應用場景

  • 個人遠程在線考試。
  • 個人線下固定機位考試。

特色優勢

  • 功能集成度高，一個接口可輸出對當前考生的所有行為監測。
  • 針對常見聊天工具有單獨的頁面檢測，可杜絕考生遠程聊天作弊。
  • 可支持單機位（如PC），也可根據需求支持雙機位算法（如手機架設）。

接入指引

1. 注冊阿里云賬號：打開阿里云官網，在阿里云官網右上角，單擊立即注冊，按照操作提示完成賬號注冊。

2. 開通能力：請確保您已開通人臉人體服務，若未開通服務請立即開通。

重要

本能力支持企業或個人認證用戶開通。更多實名認證操作信息，請參見實名認證。

3. 創建AccessKey：請確保您已創建AccessKey，如果您使用的是子賬號AccessKey，您需要給子賬號賦予AliyunVIAPIFullAccess權限，具體操作，請參見RAM授權。

4. 在線調試（可選）：您可以通過OpenAPI Explorer在線調試能力，查看完整的調用示例代碼及SDK依賴信息，也可以下載完整的工程。

5. 開發接入步驟：

  • 在SDK總覽中選擇您要接入使用的SDK語言。
  • 在對應語言的SDK文檔中找到AI類目為人臉人體（facebody）的SDK包進行安裝。
  • 參考文檔中提供的示例代碼進行適當修改后調用。

6. 示例代碼：該能力常用語言的示例代碼，請參見線上監考示例代碼。

7. 客戶端直接調用：該能力常用的客戶端調用方式包括以下幾種。

輸入限制

  • 圖像格式：JPG、PNG。
  • 圖像大小：小于5 MB。
  • 圖像分辨率：建議大于480×640像素，小于720×1280像素。
  • URL地址中不能包含中文字符。
說明 當圖像分辨率超過最大限制時，請先將圖片進行縮放，調整圖片大小，具體請參見圖片縮放。

計費說明

關于線上監考的計費方式及報價，請參見計費介紹。

說明 下方調試接口為付費接口，如需免費體驗調試請前往體驗中心。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 MonitorExamination

系統規定參數。取值：MonitorExamination。
Type Long 是 1

檢測類型。

  • 0：屏幕聊天工具檢測
  • 1：考生狀態檢測
ImageURL String 是 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MonitorExamination/1MonitorExamination1.jpg

圖像URL地址。推薦使用上海地域的OSS鏈接，對于文件在本地或者非上海地域OSS鏈接的情況，請參見文件URL處理。

返回數據

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

請求ID。
Data Object

返回的結果數據內容。
FaceInfo Object

中心人物的人臉信息。當請求參數Type取值為1時顯示該參數。
Completeness Float 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時顯示該參數。

SDK參考

阿里云視覺AI人臉人體類目下的線上監考能力推薦使用SDK調用，支持多種編程語言，調用時請選擇AI類目為人臉人體（facebody）的SDK包，文件參數通過SDK調用可支持本地文件及任意URL，具體可參見SDK總覽。

示例代碼

該能力常用語言的示例代碼，請參見線上監考示例代碼。

示例

請求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=MonitorExamination   //更多關于訪問域名（Endpoint）信息，請參見：http://bestwisewords.com/document_detail/143103.html
&Type=1
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/MonitorExamination/1MonitorExamination1.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
  }
}

錯誤碼

關于在線監考的錯誤碼，詳情請參見常見錯誤碼。

安全聲明

  • 請確保上傳的圖片或文件來源符合相應的法律法規。
  • 通過體驗調試上傳的臨時文件有效期為1小時，在24小時后會被系統自動清理刪除。