public class FaceRequest
extends com.iflytek.cloud.msc.module.SpeechInterface
人脸识别与声纹密码类似,作为人生理特征身份认证的其中一种,
包括人脸检测、聚焦、注册、验证。在开始会话前,通过设置SpeechConstant.WFR_SST
指定业务类型。人脸识别的结果说明,请参考新手指南的PDF文档。
当前人脸识别支持以下图片格式:PNG,BMP, JPG,GIF。不需要针对不同格式设置格式参数,引擎 根据传入的图片数据自动辨别。
人脸注册(reg),应用给终端用户指定一个授权ID后,上传
用户的人脸照片,在服务器生成一个人脸模型,用于生理特征身份认证。
人脸验证(verify),应用指定由注册时的终端用户授权ID,上传
用户的人脸照片,通过注册时在服务器已经保存的人脸模型,验证与注册时是否为同一人。
人脸检测(detect),检测出图片中人脸的位置 (支持多张人脸) ,返回位置的坐标。用于 图片编辑、游戏等领域。
人脸聚焦(align),检测出图片中人脸的关键点坐标 (支持多张人脸),返回坐标集。
在当前应用生命周期第一次使用本类的任何函数前,须先调用
SpeechUtility.createUtility(Context, java.lang.String)进行SDK初始化。
SpeechUtility.createUtility(Context, java.lang.String),
RequestListener,
SpeechConstant| 构造器和说明 |
|---|
FaceRequest(Context context)
构造函数
创建实例用于人脸识别。
|
| 限定符和类型 | 方法和说明 |
|---|---|
void |
cancel()
取消人脸识别
取消当前人脸识别会话。
|
java.lang.String |
getParameter(java.lang.String key)
获取识别参数
获取指定的参数的当前值。
|
int |
sendRequest(byte[] img,
RequestListener listener)
开始人脸识别
开始人脸注册、验证、检测和聚焦等。
|
boolean |
setParameter(java.lang.String key,
java.lang.String value)
设置参数
在会话开始前,设置当前会话的业务类型等。
|
public int sendRequest(byte[] img,
RequestListener listener)
开始人脸注册、验证、检测和聚焦等。在调用本函数开始开会前,可以通过
setParameter(String, String)来设置参数,指定业务类型等。
img - 图片数据listener - 识别状态、结果监听器ErrorCode类的错误码定义。setParameter(String, String),
FaceRequest(Context),
RequestListener,
cancel()public void cancel()
取消当前人脸识别会话。
public boolean setParameter(java.lang.String key,
java.lang.String value)
在会话开始前,设置当前会话的业务类型等。
与人脸相关的参数有:
SpeechConstant.NET_TIMEOUT: 网络连接超时时间
SpeechConstant.WFR_SST: 人脸识别业务类型
SpeechConstant.AUTH_ID: 授权ID
setParameter 在类中 com.iflytek.cloud.msc.module.SpeechInterfacekey - 参数名称value - 参数值getParameter(String),
sendRequest(byte[], RequestListener)public java.lang.String getParameter(java.lang.String key)
获取指定的参数的当前值。
某些有默认的值的参数,如SpeechConstant.NET_TIMEOUT,在应用层未
调用setParameter(String, String)来设置参数值前,可能获取到的是null值,
但在实际会话会始时,SDK会使用默认值传给服务器。
getParameter 在类中 com.iflytek.cloud.msc.module.SpeechInterfacekey - 参数名称setParameter(String, String)