在如何在小程序中实现文件上传下载文章中,我们介绍了小程序的上传基本使用教程,文末我们留下了一个引子。本文将介绍在小程序端,使用腾讯云云智AI应用服务来进行人脸识别检测分析,实现人脸识别等功能。
腾讯云人脸识别服务每月为各个接口提供 1 万次 的免费调用,我们可以利用腾讯云人脸识别服务所提供的API来实现我们一些简单的demo实验。目前腾讯云人脸识别服务所提供人脸检测与分析、五官定位、人脸比对与验证、人脸检索、多脸检索、静态活体检测等功能,为了方便演示,本教程只介绍人脸检测与分析API的使用,更多接口使用请参考腾讯云人脸识别文档。
在教程开始之前,需要搭建搭建好小程序的基础开发环境,关于如何配置,大家可以参考如何入门小程序开发这篇文章的入门教程。
人脸识别API申请
如果要使用人脸识别API,必须在腾讯云进行实名认证,实名认证后,您可以登录腾讯云 控制台 进行使用。如果没有账号,请参考账号 注册教程。注册完成后,需要创建相关开发密钥,不然无法使用API。
创建密钥
您需要在 访问管理 创建密钥,点击图中的新建密钥,即可创建密钥。
创建完成后,点击SecretKey的显示按钮,显示当前SecretKey,然后将APPID
、SecretId
、SecretKey
记录下了,后面教程中使用。人脸识别服务通过签名来验证请求的合法性,所以接下来的步骤,我们将介绍如何进行签名。
生成签名
签名步骤官方文档写的非常详细,本文仅作简单介绍。签名方法非常简单,就两个步骤,拼接签名、生成签名。
拼接签名主要需要APPID
、Secret ID
、bucket
、expiredTime
、currentTime
、rand
、fileid
这几个参数,APPID
、Secret ID
、在上一步骤中我们已经介绍。Bucket
是图片资源的组织管理单元,历史遗留字段,可不填。expiredTime
为签名的有效期。currentTime
为当前时间。rand
为随机串,需要自己生成。fileid
资源存储的唯一标识,如果你的签名想使用多次,可不填。
当拼接完成后,需要HMAC-SHA1 算法对拼接签名进行加密,之后在将签名结果放在末尾,在进行base64编码。最终生成签名,是不是签名生成过程看蒙了?没关系,官方提供了相关签名代码,我们直接使用。我们只需要APPID
、Secret ID
、SecretKey
这三个参数即可生成签名。首先,根据如何在小程序中实现文件上传下载文章,搭建好上传文件所需环境,然后在服务器端,网站根目录,新建一个名为signature.php
的文件。
cd /usr/share/nginx/html
sudo nano signature.php
然后写入下面的代码
代码语言:txt复制<?php
$appid = "YOUR APPID_ID";
$bucket = "tencentyun";
$secret_id = "YOUR SECRET_ID";
$secret_key = "YOUR SECRET_KEY";
$expired = time() 2592000;
$onceExpired = 0;
$current = time();
$rdm = rand();
$userid = "0";
$fileid = "tencentyunSignTest";
$srcStr = 'a='.$appid.'&b='.$bucket.'&k='.$secret_id.'&e='.$expired.'&t='.$current.'&r='.$rdm.'&f=';
$srcWithFile = 'a='.$appid.'&b='.$bucket.'&k='.$secret_id.'&e='.$expired.'&t='.$current.'&r='.$rdm.'&f='.$fileid;
$srcStrOnce= 'a='.$appid.'&b='.$bucket.'&k='.$secret_id.'&e='.$onceExpired .'&t='.$current.'&r='.$rdm
.'&f='.$fileid;
$signStr = base64_encode(hash_hmac('SHA1', $srcStr, $secret_key, true).$srcStr);
$srcWithFile = base64_encode(hash_hmac('SHA1', $srcWithFile , $secret_key, true).$srcWithFile );
$signStrOnce = base64_encode(hash_hmac('SHA1',$srcStrOnce,$secret_key, true).$srcStrOnce);
echo $signStr."n";
echo $srcWithFile ."n";
echo $signStrOnce."n";
?>
注意,将YOUR APPID_ID
替换为你的APPID
,将YOUR SECRET_ID
替换为你的Secret ID
,将YOUR SECRET_KEY
替换为你的SecretKey
,如图。
保存后,在浏览器访问你配置服务器的地址,比如我的签名地址是https://weixin.techeek.cn/signature.php
,如图。
这里会输出三行数据,第一行为可多次使用的签名,第二行验证与当前操作的文件路径是否一致才能使用的签名,第三行为单次使用签名,为了方便演示,我这里将介绍多次使用的签名使用,复制第一行全部内容,保存下来,后续使用。
到这里,我们所有的签名工作就完成了,建议签名完成后删除该文件,以防止其他人访问。
服务器端配置
在如何在小程序中实现文件上传下载文章的教程中,我们已经配置好了上传服务器,没有配置好的同学请参考这篇教程。接下来,需要在服务器端增加人脸识别API。
后续小程序将图片传输到服务器,由服务器向腾讯云的服务器发起HTTP请求,并将返回的请求数据返回给小程序。我们修改index.php
文件为下面的内容。注意,将YOUR SIGNATURE
修改为你在上一步中保存的一长串内容。将YOUR APPID_ID
替换为你的APPID
。将YOUR DOMAIN
替换为你的域名,不要加https://
。
<?php
move_uploaded_file($_FILES["file"]["tmp_name"], "upload/" . $_FILES["file"]["name"]);
$curl = curl_init();
$appid = "YOUR APPID_ID";
$domain_url = "YOUR DOMAIN";
$signature = "YOUR SIGNATURE";
$face_url = "------WebKitFormBoundaryrnContent-Disposition: form-data; name="appid"rnrn" . $appid . "rn------WebKitFormBoundaryrnContent-Disposition: form-data; name="url"rnrnhttps://". $domain_url ."/upload/" . $_FILES["file"]["name"] . "rn------WebKitFormBoundary--";
curl_setopt_array($curl, array(
CURLOPT_URL => "https://recognition.image.myzijiebao.com/face/detect",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => $face_url,
CURLOPT_HTTPHEADER => array(
"authorization:" . $signature ."",
"cache-control: no-cache",
"content-type: multipart/form-data; boundary=----WebKitFormBoundary",
"host: recognition.image.myzijiebao.com"
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
修改完成后如图。注意,这里上传完图片路径存储在/upload/
目录下,如果你没有按照我的教程去做,请修改你存储图片的目录。
现在,访问你的配置的小程序域名https://weixin.techeek.cn/
如果看到如图的内容,证明服务器已经搭建,这里报错正常,因为我们没有传输图片到这个接口,所以会报错。
到这一步,我们的服务器搭建步骤就完成了。我解释一下服务端代码的作用吧,首先将图片上传到刚刚创建的weixin.techeek.cn
(注意域名,需要改成你自己的)接口,该接口将上传的文件复制到upload/
目录下,之后,服务器向https://recognition.image.myzijiebao.com/face/detect
接口发起HTTP请求,将你的图片的url地址及签名信息发送给腾讯云人脸识别接口,人脸识别接口识别图片后,返回相关数据,然后你的服务器将这些数据原封不动返回给前端,接下来的步骤中,我们将这些数据导入到小程序中处理。
小程序端配置
服务器端已经配置完成,接下来,我们需要配置小程序端的代码,首先,我们配置后端代码,打开index.js
文件,修改代码如下。
Page({
wx_face(){
wx.chooseImage({
success(res) {
const tempFilePaths = res.tempFilePaths
wx.uploadFile({
url: 'https://weixin.techeek.cn/', //替换为你自己的接口地址
header:{
'Content-Type': 'application/json'
},
filePath: tempFilePaths[0],
name: 'file',
success(res) {
console.log(res.data)
}
})
}
})
},
})
这里就是如何在小程序中实现文件上传下载文章中上传文件的代码,只不success
这里,我们将返回的内容改为了res.data
,有了这段代码,我们就可以实现将服务器端的数据展示出来。接下来,我们撰写前端,修改index.wxml
代码如下。
<button type="primary" bindtap="wx_face">上传</button>
这里我们调用wx_face
上传图片到服务器,等待服务器返回数据。点击控制台的Network
按钮,然后点击我们前端界面的上传
按钮,选择一张带人脸的照片,看看会发生什么。
图片上传到服务器,我们看到小程序返回了一个json数组,这里返回的数组是腾讯云人脸识别接口返回的数据,证明人脸已经识别成功,这是请求成功返回的数据,这里的数组到底是什么意思呢?我们看看腾讯云人脸检测与分析API的文档,如下表。
请求头 header
参数名 | 必选 | 值 | 描述 |
---|---|---|---|
host | 是 | recognition.image.myzijiebao.com | 腾讯云人脸识别服务器域名 |
content-length | 否 | 包体总长度 | 整个请求包体内容的总长度,单位:字节(Byte) |
content-type | 是 | application/json 或 multipart/form-data | 据不同接口选择: 1. 使用 application/json 格式,参数为 url,其值为图片的 url ; 2. 使用 multipart/form-data 格式,参数为 image,其值为图片的二进制内容。 |
authorization | 是 | 鉴权签名 | 多次有效签名,用于鉴权,生成方式见 鉴权签名 |
请求参数
使用 application/json 格式,参数选择 url ;使用 multipart/form-data 格式,参数选择 image。
参数名 | 必选 | 类型 | 参数说明 |
---|---|---|---|
appid | 是 | String | 接入项目的唯一标识,可在 账号信息 或 云 API 密钥 中查看 |
mode | 否 | Int | 检测模式:0-所有人脸,1-最大的人脸 |
image | 否 | Binary | 图片内容 |
url | 否 | String | 图片的 url、image提供一个即可;如果都提供,只使用url |
返回内容
字段 | 类型 | 说明 |
---|---|---|
data.session_id | String | 相应请求的 session 标识符,可用于结果查询 |
data.image_width | Int | 请求图片的宽度 |
data.image_height | Int | 请求图片的高度 |
data.face | Array(faceItem) | 检测出的人脸信息列表 |
code | Int | 返回状态码 |
message | String | 返回错误消息 |
FaceItem 说明
字段 | 类型 | 说明 |
---|---|---|
face_id | String | 人脸标识 |
x | Int | 人脸框左上角 x |
y | Int | 人脸框左上角 y |
width | Float | 人脸框宽度 |
height | Float | 人脸框高度 |
gender | Int | 性别 0(female)~100(male) |
age | Int | 年龄 0~100 |
expression | Int | 微笑0(normal)~50(smile)~100(laugh) |
glass | Bool | 是否有眼镜 true,false |
pitch | Int | 上下偏移-30,30 |
yaw | Int | 左右偏移-30,30 |
roll | Int | 平面旋转-180,180 |
Beauty | Int | 魅力0~100 |
我们先看看请求头 header和请求参数这里的内容眼熟嘛?这里的内容大部分参数我已经将其写在了我们服务器的请求文件index.php
中,大家只需使用即可。撰写小程序时用不到。
我在再看看返回内容和FaceItem 说明,这里的数据是服务器返回的数据,参考这两个表格,我们才能知道当前返回的数据到底是什么意思。为了方便讲解,我将返回的json数组格式化后放在下方。
服务器返回的json数组
代码语言:txt复制{
"code":0,
"message":"OK",
"data":{
"session_id":"",
"image_height":500,
"image_width":500,
"face":[
{
"face_id":"2843632291225292737",
"x":149,
"y":118,
"height":202,
"width":202,
"pitch":14,
"roll":0,
"yaw":0,
"age":22,
"gender":0,
"glass":false,
"expression":35,
"glasses":0,
"mask":0,
"hat":0,
"beauty":81,
"face_shape":{
"face_profile":Array[21],
"left_eye":Array[8],
"right_eye":Array[8],
"left_eyebrow":Array[8],
"right_eyebrow":Array[8],
"mouth":Array[22],
"nose":Array[13]
}
}
]
}
}
因为源文件较长,我将face_shape
中几个数组隐藏掉了。我们对照表格,看看返回的数组到底是什么意思。face_id
为人脸标识,每张图片返回的标识不同,我们可以不用在意。x
、y
为人脸框的坐标标记,返回的数组中为149
和118
。width
和height
为人脸的宽高,返回的数据为202
和202
。接下来pitch
和yaw
为人脸的偏移量,返回的数据为14
和0
证明这张脸基本在中心位置。之后的数据age
为年龄,人脸识别结果为22
岁。gender
为性别,这里的数值为0
根据表格判断为男性。glass
为false
表明不戴眼镜。mask
为当前是否面部被遮挡。这里返回值为0
证明未被遮挡。hat
这里的数值为0
证明没有带帽子。beauty
为魅力,根据表格,这里的魅力为81
。根据这些信息,我们可以判断,这是一个没有戴眼镜,帽子等遮挡物,一个比较帅的小伙子。
但是这里的数据仅仅是给程序员看的,我们能不能把它转换成正常人能读懂的数据呢?当然可以,修改index.wxml
代码如下。
<button type="primary" bindtap="wx_face">上传</button>
<text>上传状态:{{message}}</text>
<text>年龄:{{age}}</text>
<text>是否带眼镜:{{glasses}}</text>
<text>是否带帽子:{{glasses}}</text>
<text>脸部是否被遮挡:{{glasses}}</text>
<text>颜值:{{beauty}}</text>
这段代码中,我们判断其是否带帽子,是否戴眼镜,年龄和颜值是多少。接下来,修改后端代码,打开index.js
文件,代码如下。
Page({
wx_face(){
var myThis = this;
wx.chooseImage({
success(res) {
const tempFilePaths = res.tempFilePaths
wx.uploadFile({
url: 'https://weixin.techeek.cn/', //替换为你自己的接口地址
header:{
'Content-Type': 'application/json'
},
filePath: tempFilePaths[0],
name: 'file',
success(res) {
var obj = JSON.parse(res.data)
myThis.setData({
message: obj.message,
age: obj.data.face[0].age,
glasses: obj.data.face[0].glasses,
beauty: obj.data.face[0].beauty,
mask: obj.data.face[0].mask,
hat: obj.data.face[0].hat
})
}
})
}
})
},
})
这段代码中,我们将返回的的数据通过JSON.parse()
方法转为json数据,然后将返回的数据通过setData
方法赋予相关变量,然后前端显示相关变量,比如age: obj.data.face[0].age
这段代码的意思是将json数组中data数组内的face数组中age数组赋予age
变量。然后在前端显示,如图。
现在上传任意带人脸的图片,就能识别用户的颜值等信息。这里的信息还是较少,并且界面不太好看,我们优化下前端代码。
现在试试能不能正常使用。
已经能够正常使用了!这个小程序的代码我将其分享在了github,感兴趣的小伙伴可以去这里下载。
总结
怎么样,现在会使用小程序调用人脸识别API了吗?我们看到腾讯云的API还是非常准确的,那是因为腾讯云人脸识别立足于社交数据大平台,借助腾讯优图领先的人脸识别技术,可应用在美妆美颜、面部动效合成、安防监控追逃、金融领域身份认证等场景,解决各行业客户的多种多样的人脸特效处理及用户身份确认等需求。目前腾讯云人脸识别服务每月为各个接口提供 1 万次 的免费调用,还等什么赶快去体验下吧!
后续我将会对其他组件做详细的介绍。喜欢的小伙伴请持续关注本专栏。腾讯云联合小程序给大家带来了小程序·云开发解决方案,为开发者提供完整的云端支持,弱化后端和运维操作,使用平台原生 API 进行核心业务开发,实现快速上线和迭代。欢迎免费使用!