新聞中心

這里有您想知道的互聯(lián)網(wǎng)營(yíng)銷(xiāo)解決方案

創(chuàng)新互聯(lián)百度小程序教程：swan.ai.faceDetect

swan.ai.faceDetect
- 方法參數(shù)
  - object 參數(shù)說(shuō)明
  - success 返回參數(shù)說(shuō)明
  - result 參數(shù)說(shuō)明
  - face_list 參數(shù)說(shuō)明
  - location 返回值說(shuō)明
  - angel 返回值說(shuō)明
  - expression 返回值說(shuō)明
  - face_shape 返回值說(shuō)明
  - gender 返回值說(shuō)明
  - glasses 返回值說(shuō)明
  - eye_status 返回值說(shuō)明
  - emotion 返回值說(shuō)明
  - race 返回值說(shuō)明
  - face_type 返回值說(shuō)明
  - landmark 返回值說(shuō)明
  - quality 返回值說(shuō)明
  - occlusion 返回值說(shuō)明
- 示例
  - 圖片示例
  - 代碼示例 1：image_type 為 BASE64
  - 代碼示例 2：image_type 為 URL
  - 代碼示例 3：image_type 為 FACE_TOKEN
  - 返回值示例

swan.ai.faceDetect

基礎(chǔ)庫(kù) 3.20.11 開(kāi)始支持，低版本需做兼容處理。
成都創(chuàng)新互聯(lián)成立于2013年，先為安徽等服務(wù)建站，安徽等地企業(yè)，進(jìn)行企業(yè)商務(wù)咨詢服務(wù)。為安徽企業(yè)網(wǎng)站制作PC+手機(jī)+微官網(wǎng)三網(wǎng)同步一站式服務(wù)解決您的所有建站問(wèn)題。

解釋：人臉檢測(cè)，檢測(cè)圖片中的人臉并標(biāo)記出相應(yīng)的信息位置，同時(shí)可以展示出人臉的關(guān)鍵信息和屬性信息，比如年齡，性別等。使用本功能需要小程序開(kāi)發(fā)者后臺(tái)登錄超級(jí)管理員賬號(hào)，點(diǎn)擊云平臺(tái)付費(fèi)鏈接開(kāi)通云賬號(hào)付費(fèi)功能。
Web 態(tài)說(shuō)明：受宿主環(huán)境限制，Web 態(tài)暫不支持 AI 能力相關(guān)接口。在 Web 態(tài)會(huì)做 打開(kāi)百度 App 對(duì)應(yīng)小程序頁(yè)面 的降級(jí)處理。

方法參數(shù)

Object object

object 參數(shù)說(shuō)明

image

String

是

圖片信息（總數(shù)據(jù)大小應(yīng)小于 10M），圖片上傳方式根據(jù) image_type 來(lái)判斷。注意：
· 圖片尺寸建議：1920 * 1080 以內(nèi)
· 支持格式：支持 jpg、jpeg、png、bmp，不支持 gif 圖

image_type

String

是

圖片類(lèi)型。有效值：
· BASE64：圖片的 base64 值，base64 編碼后的圖片數(shù)據(jù)，編碼后的圖片大小不超過(guò) 2M
· URL：圖片的 URL 地址（可能由于網(wǎng)絡(luò)等原因?qū)е孪螺d圖片時(shí)間過(guò)長(zhǎng)）
· FACE_TOKEN：人臉圖片的唯一標(biāo)識(shí)，調(diào)用人臉檢測(cè)接口時(shí)，會(huì)為每個(gè)人臉圖片賦予一個(gè)唯一的 FACE_TOKEN，同一張圖片多次檢測(cè)得到的 FACE_TOKEN 是同一個(gè)

face_field

String

否

包括 age、beauty、expression、face_shape、gender、glasses、landmark、race、quality、eye_status、emotion、face_type 信息，逗號(hào)分隔。默認(rèn)只返回 face_token 、人臉框、概率和旋轉(zhuǎn)角度

max_face_num

String

否

最多處理人臉的數(shù)目，默認(rèn)值為 1 ，僅檢測(cè)圖片中面積最大的那個(gè)人臉；最大值 10 ，檢測(cè)圖片中面積最大的幾張人臉

face_type

String

否

LIVE

人臉的類(lèi)型。有效值：
· LIVE 表示生活照：通常為手機(jī)、相機(jī)拍攝的人像圖片、或從網(wǎng)絡(luò)獲取的人像圖片等
· IDCARD 表示身份證芯片照：二代身份證內(nèi)置芯片中的人像照片
· WATERMARK 表示帶水印證件照：一般為帶水印的小圖，如公安網(wǎng)小圖
· CERT 表示證件照片：如拍攝的身份證、工卡、護(hù)照、學(xué)生證等證件圖片；默認(rèn) LIVE

success

Function

否

接口調(diào)用成功后的回調(diào)函數(shù)

fail

Function

否

接口調(diào)用失敗的回調(diào)函數(shù)

complete

Function

否

接口調(diào)用結(jié)束的回調(diào)函數(shù)（調(diào)用成功、失敗都會(huì)執(zhí)行）

屬性名	類(lèi)型	必填	默認(rèn)值	說(shuō)明

success 返回參數(shù)說(shuō)明

log_id

Number

唯一的 log id ，用于問(wèn)題定位

error_code

Number

錯(cuò)誤碼，錯(cuò)誤碼為 0 時(shí)，人臉檢測(cè)成功

error_msg

String

錯(cuò)誤描述信息，幫助理解和解決發(fā)生的錯(cuò)誤

result

Object

人臉屬性對(duì)象的集合

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

result 參數(shù)說(shuō)明

face_num

Number

檢測(cè)到圖片中的人臉數(shù)量

face_list

Array

人臉信息列表

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

face_list 參數(shù)說(shuō)明

face_token

String

人臉圖片的唯一標(biāo)識(shí)

location

Object

人臉在圖片中的位置

face_probability

Number

人臉置信度，范圍 [0-1] ，代表這是一張人臉的概率，0：最小、1：最大

angel

Object

人臉旋轉(zhuǎn)角度參數(shù)

age

Number

年齡，當(dāng) face_field 包含 age 時(shí)返回

beauty

Number

美丑打分，范圍 [0-100]，越大表示越美，當(dāng) face_fields 包含 beauty 時(shí)返回

expression

Object

表情，當(dāng) face_field 包含 expression 時(shí)返回

face_shape

Object

臉型，當(dāng) face_field 包含 face_shape 時(shí)返回

gender

Object

性別，face_field 包含 gender 時(shí)返回

glasses

Object

是否帶眼鏡，face_field 包含 glasses 時(shí)返回

eye_status

Object

雙眼狀態(tài)（睜開(kāi)/閉合）face_field 包含 eye_status 時(shí)返回

emotion

Object

情緒，face_field 包含 emotion 時(shí)返回

race

Object

人種 face_field 包含 race 時(shí)返回

face_type

Object

真實(shí)人臉/卡通人臉 face_field 包含 face_type 時(shí)返回

landmark

Object

4 個(gè)關(guān)鍵點(diǎn)位置，左眼中心、右眼中心、鼻尖、嘴中心。face_field 包含 landmark 時(shí)返回

quality

Object

人臉質(zhì)量信息，face_field 包含 quality 時(shí)返回

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

location 返回值說(shuō)明

left

Number

人臉區(qū)域離左邊界的距離

top

Number

人臉區(qū)域離上邊界的距離

width

Number

人臉區(qū)域的寬度

height

Number

人臉區(qū)域的高度

rotation

Number

人臉框相對(duì)于豎直方向的順時(shí)針旋轉(zhuǎn)角，[-180,180]

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

angel 返回值說(shuō)明

yaw

Number

三維旋轉(zhuǎn)之左右旋轉(zhuǎn)角 [-90(左),90(右)]

pitch

Number

三維旋轉(zhuǎn)之俯仰角度 [-90(上),90(下)]

roll

Number

平面內(nèi)旋轉(zhuǎn)角 [-180(逆時(shí)針),180(順時(shí)針)]

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

expression 返回值說(shuō)明

type

String

none：不笑；smile：微笑；laugh：大笑

probability

Number

表情置信度，范圍 [0-1] ，0 最小、1 最大

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

face_shape 返回值說(shuō)明

type

String

square：正方形；triangle：三角形；oval：橢圓；heart：心形；round：圓形

probability

Number

置信度，范圍 [0-1] ，代表這是人臉形狀判斷正確的概率，0 最小、1 最大

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

gender 返回值說(shuō)明

type

String

male：男性；female：女性

probability

Number

性別置信度，范圍 [0-1] ，0 代表概率最小、1 代表最大

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

glasses 返回值說(shuō)明

type

String

none：無(wú)眼鏡；common：普通眼鏡；sun：墨鏡

probability

Number

眼鏡置信度，范圍 [0-1]，0 代表概率最小、1 代表最大

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

eye_status 返回值說(shuō)明

left_eye

Number

左眼狀態(tài) [0,1] 取值，越接近 0 閉合的可能性越大

right_eye

Number

右眼狀態(tài) [0,1] 取值，越接近 0 閉合的可能性越大

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

emotion 返回值說(shuō)明

type

String

angry：憤怒；disgust：厭惡；fear：恐懼；happy：高興；sad：傷心；surprise：驚訝；neutral：無(wú)情緒

probability

Number

情緒置信度，范圍 [0-1]

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

race 返回值說(shuō)明

type

String

yellow：黃種人；white：白種人；black：黑種人；arabs：阿拉伯人

probability

Number

人種置信度，范圍 [0-1] ，0：代表概率最小、1：代表最大

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

face_type 返回值說(shuō)明

type

String

human：真實(shí)人臉；cartoon：卡通人臉

probability

Number

人臉類(lèi)型判斷正確的置信度，范圍 [0-1] ，0：代表概率最小、1：代表最大

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

landmark 返回值說(shuō)明

landmark72

Array

72 個(gè)特征點(diǎn)位置 face_field 包含 landmark72 時(shí)返回

landmark150

Array

150 個(gè)特征點(diǎn)位置 face_field 包含 landmark150 時(shí)返回

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

quality 返回值說(shuō)明

occlusion

Number

人臉各部分遮擋的概率，范圍 [0-1] ，0：表示完整，1：表示不完整

blur

Number

人臉模糊程度，范圍 [0-1] ，0：表示清晰，1：表示模糊

illumination

Number

取值范圍在 [0-255] ，表示臉部區(qū)域的光照程度越大表示光照越好

completeness

Number

人臉完整度，0 或 1 ，0：為人臉溢出圖像邊界，1：為人臉都在圖像邊界內(nèi)

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

occlusion 返回值說(shuō)明

left_eye

Number

左眼遮擋比例，[0-1] ，1：表示完全遮擋

right_eye

Number

右眼遮擋比例，[0-1] ，1：表示完全遮擋

nose

Number

鼻子遮擋比例，[0-1] ，1：表示完全遮擋

left_cheek

Number

左臉頰遮擋比例，[0-1] ，1：表示完全遮擋

right_cheek

Number

右臉頰遮擋比例，[0-1] ，1：表示完全遮擋

chin

Number

下巴遮擋比例，[0-1] ，1：表示完全遮擋

參數(shù)名	參數(shù)類(lèi)型	說(shuō)明

示例

掃碼體驗(yàn)

代碼示例

請(qǐng)使用百度APP掃碼

圖片示例

代碼示例 1：image_type 為 BASE64

在開(kāi)發(fā)者工具中打開(kāi)

在 WEB IDE 中打開(kāi)

 
 
   
  
  Page({  
  
   faceDetect() {  
  
   swan.chooseImage({  
  
   success: res => {  
  
   let image = res.tempFilePaths[0];  
  
   // AI系列的api有宿主使用限制,只可在百度App中使用,建議使用時(shí)加一層判斷防止代碼報(bào)未知錯(cuò)誤  
  
   let host = swan.getSystemInfoSync().host;  
  
   if (host === 'baiduboxapp') {  
  
   swan.ai.faceDetect({  
  
   image,  
  
   image_type: 'BASE64',  
  
   face_field: 'age,beauty,angle,expression,face_shape,gender,glasses,eye_status,race,quality',  
  
   max_face_num: '1',  
  
   face_type: 'LIVE',  
  
   success: res => {  
  
   console.log(res.face_list);  
  
   },  
  
   fail: err => {  
  
   console.log( err);  
  
   }  
  
   });  
  
   }  
  
   else {  
  
   swan.showToast({  
  
   title: '此api目前僅可在百度App上使用',  
  
   icon: 'none'  
  
   });  
  
   }  
  
   }  
  
   })  
  
   }  
  
  });

代碼示例 2：image_type 為 URL

在開(kāi)發(fā)者工具中打開(kāi)

在 WEB IDE 中打開(kāi)

 
 
   
  
  Page({  
  
   faceDetect() {  
  
   swan.chooseImage({  
  
   success: res => {  
  
   let image = res.tempFilePaths[0];  
  
   // AI系列的api有宿主使用限制,只可在百度App中使用,建議使用時(shí)加一層判斷防止代碼報(bào)未知錯(cuò)誤  
  
   let host = swan.getSystemInfoSync().host;  
  
   if (host === 'baiduboxapp') {  
  
   swan.ai.faceDetect({  
  
   image:'https://b.bdstatic.com/miniapp/image/faceDetect.png',  
  
   image_type: 'URL',  
  
   face_field: 'age,beauty,angle,expression,face_shape,gender,glasses,eye_status,race,quality',  
  
   max_face_num: '1',  
  
   face_type: 'LIVE',  
  
   success: res => {  
  
   console.log(res.face_list);  
  
   },  
  
   fail: err => {  
  
   console.log( err);  
  
   }  
  
   });  
  
   }  
  
   else {  
  
   swan.showToast({  
  
   title: '此api目前僅可在百度App上使用',  
  
   icon: 'none'  
  
   });  
  
   }  
  
   }  
  
   })  
  
   }  
  
  });

代碼示例 3：image_type 為 FACE_TOKEN

在開(kāi)發(fā)者工具中打開(kāi)

在 WEB IDE 中打開(kāi)

 
 
   
  
  Page({  
  
   faceDetect() {  
  
   swan.chooseImage({  
  
   success: res => {  
  
   let image = res.tempFilePaths[0];  
  
   // AI系列的api有宿主使用限制,只可在百度App中使用,建議使用時(shí)加一層判斷防止代碼報(bào)未知錯(cuò)誤  
  
   let host = swan.getSystemInfoSync().host;  
  
   if (host === 'baiduboxapp') {  
  
   swan.ai.faceDetect({  
  
   // 可由之前圖片檢測(cè)的返回值中獲得  
  
   image:'4160b708a826b18de95fe5c9a098a436',  
  
   image_type: 'FACE_TOKEN',  
  
   face_field: 'age,beauty,angle,expression,face_shape,gender,glasses,eye_status,race,quality',  
  
   max_face_num: '1',  
  
   face_type: 'LIVE',  
  
   success: res => {  
  
   console.log(res.face_list);  
  
   },  
  
   fail: err => {  
  
   console.log( err);  
  
   }  
  
   });  
  
   }  
  
   else {  
  
   swan.showToast({  
  
   title: '此api目前僅可在百度App上使用',  
  
   icon: 'none'  
  
   });  
  
   }  
  
   }  
  
   })  
  
   }  
  
  });

返回值示例

JSON

 
 
   
  
  {  
  
   "face_num": 1,  
  
   "face_list": [  
  
   {  
  
   "face_token": "35235asfas21421fakghktyfdgh68bio",  
  
   "location": {  
  
   "left": 117,  
  
   "top": 131,  
  
   "width": 172,  
  
   "height": 170,  
  
   "rotation": 4  
  
   },  
  
   "face_probability": 1,  
  
   "angle" :{  
  
   "yaw" : -0.34859421849251  
  
   "pitch" 1.9135693311691  
  
   "roll" :2.3033397197723  
  
   }  
  
   "landmark": [  
  
   {  
  
   "x": 161.74819946289,  
  
   "y": 163.30244445801  
  
   },  
  
   ...  
  
   ],  
  
   "landmark72": [  
  
   {  
  
   "x": 115.86531066895,  
  
   "y": 170.0546875  
  
   }，  
  
   ...  
  
   ],  
  
   "age": 29.298097610474,  
  
   "beauty": 55.128883361816,  
  
   "expression": {  
  
   "type": "smile",  
  
   "probability" : 0.5543018579483  
  
   },  
  
   "gender": {  
  
   "type": "male",  
  
   "probability": 0.99979132413864  
  
   },  
  
   "glasses": {  
  
   "type": "sun",  
  
   "probability": 0.99999964237213  
  
   },  
  
   "race": {  
  
   "type": "yellow",  
  
   "probability": 0.99999976158142  
  
   },  
  
   "face_shape": {  
  
   "type": "triangle",  
  
   "probability": 0.5543018579483  
  
   }  
  
   "quality": {  
  
   "occlusion": {  
  
   "left_eye": 0,  
  
   "right_eye": 0,  
  
   "nose": 0,  
  
   "mouth": 0,  
  
   "left_cheek": 0.0064102564938366,  
  
   "right_cheek": 0.0057411273010075,  
  
   "chin": 0  
  
   },  
  
   "blur": 1.1886881756684e-10,  
  
   "illumination": 141,  
  
   "completeness": 1  
  
   }  
  
   }  
  
   ]  
  
  }

網(wǎng)站欄目：創(chuàng)新互聯(lián)百度小程序教程：swan.ai.faceDetect
路徑分享：http://m.fisionsoft.com.cn/article/ccsisss.html

新聞中心

swan.ai.faceDetect

方法參數(shù)

object 參數(shù)說(shuō)明

success 返回參數(shù)說(shuō)明

result 參數(shù)說(shuō)明

face_list 參數(shù)說(shuō)明

location 返回值說(shuō)明

angel 返回值說(shuō)明

expression 返回值說(shuō)明

face_shape 返回值說(shuō)明

gender 返回值說(shuō)明

glasses 返回值說(shuō)明

eye_status 返回值說(shuō)明

emotion 返回值說(shuō)明

race 返回值說(shuō)明

face_type 返回值說(shuō)明

landmark 返回值說(shuō)明

quality 返回值說(shuō)明

occlusion 返回值說(shuō)明

示例

圖片示例

代碼示例 1：image_type 為 BASE64

代碼示例 2：image_type 為 URL

代碼示例 3：image_type 為 FACE_TOKEN

返回值示例

其他資訊