功能描述

動作行為識別能力可以識別視頻和圖像中的人體動作行為，并返回識別后的行為類別。當(dāng)前可以識別的行為類別包括：舉手、吃喝、吸煙、打電話、玩手機(jī)、趴桌睡覺、跌倒、洗手、拍照。您可以根據(jù)系統(tǒng)提供的動作置信度判斷閾值，對識別的動作進(jìn)行判斷。

• 舉手：手臂伸直高高舉起，手腕高過頭頂。
• 吃喝：吃東西或者喝水。
• 吸煙：將煙點(diǎn)著，真吸煙，畫面中需要能看清煙。
• 打電話：電話或者微信語音，手機(jī)必須靠近耳朵或者嘴邊。
• 玩手機(jī)：用手機(jī)打字、瀏覽手機(jī)、看視頻、玩游戲，視頻聊天等玩手機(jī)行為，畫面中需要能看清手機(jī)。
• 趴桌睡覺：頭趴在桌子上睡覺。
• 跌倒：整個人跌倒在地，身體倒下。
• 洗手：在水龍頭或者盆中洗手。
• 拍照：手機(jī)稍微舉起，用手機(jī)對著某人或物拍照。

應(yīng)用場景

• 駕駛員監(jiān)控系統(tǒng)（DMS）：檢測駕駛員是否存在吸煙、吃喝、打電話、玩手機(jī)等影響安全駕駛的行為。
• 學(xué)習(xí)狀況監(jiān)測：監(jiān)測學(xué)習(xí)過程是否存在舉手、玩手機(jī)、趴桌子睡覺等行為。
• 公共場所行為監(jiān)測：監(jiān)測在博物館、展覽館等公共場所是否存在吸煙、打電話、拍照等不文明行為，以及是否有跌倒這樣的異常情況發(fā)生。
• 工作場所監(jiān)督：監(jiān)測在工作場所是否存在吃喝、吸煙、打電話、趴桌子睡覺等行為，是否有按要求洗手。

特色優(yōu)勢

• 覆蓋多種應(yīng)用場景：支持識別舉手、吃喝、吸煙、打電話、玩手機(jī)、睡覺、跌打、洗手、拍照等行為，涵蓋駕駛、學(xué)習(xí)、泛安防等多種場景。
• 適應(yīng)多種光照條件：適應(yīng)在自然光、室內(nèi)光照、夜晚紅外模式等光照條件下的行為識別。

接入指引

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

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

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

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

5. 開發(fā)接入步驟：

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

6. 示例代碼：該能力常用語言的示例代碼，請參見動作行為識別示例代碼。

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

• Web前端直接調(diào)用
• 小程序場景下直接調(diào)用
• Android端直接調(diào)用
• iOS端直接調(diào)用

輸入限制

• 視頻要求：

  1. 時長大于2秒，小于5秒。如果輸入視頻時長大于5秒，系統(tǒng)僅返回前5秒的檢測結(jié)果。

  2. 視頻大小應(yīng)小于10 MB。

  3. 分辨率大于256×256像素，小于等于1280×720像素。

  4. 支持一些常見的視頻格式，例如MPEG、AVI、MOV、MP4。

  說明 建議為居家攝像頭或近距離監(jiān)控場景。即攝像頭固定不動，拍攝距離為2米~10米。

• 圖像要求：

  1. 幀數(shù)4幀，必須是同一個視頻連續(xù)2秒均勻抽幀的結(jié)果。如果輸入4幀非同一個視頻中的，會導(dǎo)致識別報錯。

  2. 分辨率大于256×256像素，小于等于1280×720像素。

  3. 支持的格式為JPEG、PNG、BMP、JPG。

  4. 可使用URL與Base64編碼字符串混合輸入。

• URL地址中不能包含中文字符。

計(jì)費(fèi)說明

關(guān)于動作行為識別的計(jì)費(fèi)方式及報價，請參見計(jì)費(fèi)介紹。

請求參數(shù)

返回?cái)?shù)據(jù)

SDK參考

阿里云視覺AI人臉人體類目下的動作行為識別能力推薦使用SDK調(diào)用，支持多種編程語言，調(diào)用時請選擇AI類目為人臉人體（facebody）的SDK包，文件參數(shù)通過SDK調(diào)用可支持本地文件及任意URL，具體可參見SDK總覽。

示例代碼

該能力常用語言的示例代碼，請參見動作行為識別示例代碼。

示例

請求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=RecognizeAction      //更多關(guān)于訪問域名（Endpoint）信息，請參見：http://bestwisewords.com/document_detail/143103.html
&Type=0
&VideoUrl=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeAction/RecognizeAction-video1.mp4
&URLList=[{"URL":"http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/RecognizeAction/1RecognizeAction1.png","imageData":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgQ****"}]
&VideoData=iVBORw0KGgoAAAANSUhEUgAAAoAAAAHJCAIAAACaEB9NAAEAAElEQVR4nNT9Wb****
&公共請求參數(shù)

正常返回示例

XML格式

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

<RequestId>E9C40AF5-A7F8-49D5-8A0C-B21F15A07F17</RequestId>
<Data>
    <Elements>
        <Timestamp>1</Timestamp>
    </Elements>
    <Elements>
        <Scores>0.702967643737793</Scores>
        <Labels>跌倒</Labels>
        <Timestamp>3</Timestamp>
        <Boxes>
            <Box>1119</Box>
            <Box>576</Box>
            <Box>1373</Box>
            <Box>970</Box>
        </Boxes>
    </Elements>
    <Elements>
        <Scores>0.7334273457527161</Scores>
        <Labels>跌倒</Labels>
        <Timestamp>5</Timestamp>
        <Boxes>
            <Box>1128</Box>
            <Box>613</Box>
            <Box>1363</Box>
            <Box>991</Box>
        </Boxes>
    </Elements>
</Data>

JSON格式

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

{
  "RequestId" : "E9C40AF5-A7F8-49D5-8A0C-B21F15A07F17",
  "Data" : {
    "Elements" : [ {
      "Timestamp" : 1
    }, {
      "Scores" : 0.702967643737793,
      "Labels" : "跌倒",
      "Timestamp" : 3,
      "Boxes" : {
        "Box" : [ 1119, 576, 1373, 970 ]
      }
    }, {
      "Scores" : 0.7334273457527161,
      "Labels" : "跌倒",
      "Timestamp" : 5,
      "Boxes" : {
        "Box" : [ 1128, 613, 1363, 991 ]
      }
    } ]
  }
}

錯誤碼

關(guān)于動作行為識別的錯誤碼，詳情請參見常見錯誤碼。

安全聲明

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