- 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ō)明
| 屬性名 | 類(lèi)型 | 必填 | 默認(rèn)值 | 說(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
|
否
|
1
|
最多處理人臉的數(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í)行)
|
success 返回參數(shù)說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(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ì)象的集合
|
result 參數(shù)說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(shuō)明 |
|---|
|
face_num
|
Number
|
檢測(cè)到圖片中的人臉數(shù)量
|
|
face_list
|
Array
|
人臉信息列表
|
face_list 參數(shù)說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(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í)返回
|
location 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(shuō)明 |
|---|
|
left
|
Number
|
人臉區(qū)域離左邊界的距離
|
|
top
|
Number
|
人臉區(qū)域離上邊界的距離
|
|
width
|
Number
|
人臉區(qū)域的寬度
|
|
height
|
Number
|
人臉區(qū)域的高度
|
|
rotation
|
Number
|
人臉框相對(duì)于豎直方向的順時(shí)針旋轉(zhuǎn)角,[-180,180]
|
angel 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(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í)針)]
|
expression 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(shuō)明 |
|---|
|
type
|
String
|
none:不笑;smile:微笑;laugh:大笑
|
|
probability
|
Number
|
表情置信度,范圍 [0-1] ,0 最小、1 最大
|
face_shape 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(shuō)明 |
|---|
|
type
|
String
|
square:正方形;triangle:三角形;oval:橢圓;heart:心形;round:圓形
|
|
probability
|
Number
|
置信度,范圍 [0-1] ,代表這是人臉形狀判斷正確的概率,0 最小、1 最大
|
gender 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(shuō)明 |
|---|
|
type
|
String
|
male:男性;female:女性
|
|
probability
|
Number
|
性別置信度,范圍 [0-1] ,0 代表概率最小、1 代表最大
|
glasses 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(shuō)明 |
|---|
|
type
|
String
|
none:無(wú)眼鏡;common:普通眼鏡;sun:墨鏡
|
|
probability
|
Number
|
眼鏡置信度,范圍 [0-1],0 代表概率最小、1 代表最大
|
eye_status 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(shuō)明 |
|---|
|
left_eye
|
Number
|
左眼狀態(tài) [0,1] 取值,越接近 0 閉合的可能性越大
|
|
right_eye
|
Number
|
右眼狀態(tài) [0,1] 取值,越接近 0 閉合的可能性越大
|
emotion 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(shuō)明 |
|---|
|
type
|
String
|
angry:憤怒;disgust:厭惡;fear:恐懼;happy:高興;sad:傷心;surprise:驚訝;neutral:無(wú)情緒
|
|
probability
|
Number
|
情緒置信度,范圍 [0-1]
|
race 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(shuō)明 |
|---|
|
type
|
String
|
yellow:黃種人;white:白種人;black:黑種人;arabs:阿拉伯人
|
|
probability
|
Number
|
人種置信度,范圍 [0-1] ,0:代表概率最小、1:代表最大
|
face_type 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(shuō)明 |
|---|
|
type
|
String
|
human:真實(shí)人臉;cartoon:卡通人臉
|
|
probability
|
Number
|
人臉類(lèi)型判斷正確的置信度,范圍 [0-1] ,0:代表概率最小、1:代表最大
|
landmark 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(shuō)明 |
|---|
|
landmark72
|
Array
|
72 個(gè)特征點(diǎn)位置 face_field 包含 landmark72 時(shí)返回
|
|
landmark150
|
Array
|
150 個(gè)特征點(diǎn)位置 face_field 包含 landmark150 時(shí)返回
|
quality 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(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)
|
occlusion 返回值說(shuō)明
| 參數(shù)名 | 參數(shù)類(lèi)型 | 說(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:表示完全遮擋
|
示例
掃碼體驗(yàn)
代碼示例
請(qǐng)使用百度APP掃碼
圖片示例
代碼示例 1:image_type 為 BASE64
在開(kāi)發(fā)者工具中打開(kāi)
在開(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)
在開(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)
在開(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'
});
}
}
})
}
});
返回值示例
{
"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
}
}
]
}
本文標(biāo)題:創(chuàng)新互聯(lián)百度小程序教程:swan.ai.faceDetect
文章網(wǎng)址:
http://uogjgqi.cn/article/ccsisss.html