com.iflytek.cloud

类 FaceRequest

java.lang.Object

com.iflytek.cloud.msc.module.SpeechInterface

com.iflytek.cloud.FaceRequest

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初始化。

从以下版本开始:

version:1073

作者:

另请参阅:

SpeechUtility.createUtility(Context, java.lang.String), RequestListener, SpeechConstant

嵌套类概要

从类继承的嵌套类/接口 com.iflytek.cloud.msc.module.SpeechInterface

com.iflytek.cloud.msc.module.SpeechInterface.ENGINE_MODE

构造器概要

构造器

构造器和说明
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) 设置参数 在会话开始前，设置当前会话的业务类型等。

从类继承的方法 com.iflytek.cloud.msc.module.SpeechInterface

setParameter

从类继承的方法 java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

FaceRequest

public FaceRequest(Context context)

构造函数

创建实例用于人脸识别。

参数:

context -

方法详细资料

sendRequest

public int sendRequest(byte[] img,
                       RequestListener listener)

开始人脸识别

开始人脸注册、验证、检测和聚焦等。在调用本函数开始开会前，可以通过 setParameter(String, String)来设置参数，指定业务类型等。

参数:

img - 图片数据

listener - 识别状态、结果监听器

返回:

错误码，0表示成功，否则出现错误，参考ErrorCode类的错误码定义。

另请参阅:

setParameter(String, String), FaceRequest(Context), RequestListener, cancel()

cancel

public void cancel()

取消人脸识别

取消当前人脸识别会话。

另请参阅:

sendRequest(byte[], RequestListener)

setParameter

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.SpeechInterface

参数:

key - 参数名称

value - 参数值

返回:

true 设置成功，否则设置失败

另请参阅:

getParameter(String), sendRequest(byte[], RequestListener)

getParameter

public java.lang.String getParameter(java.lang.String key)

获取识别参数

获取指定的参数的当前值。

某些有默认的值的参数，如SpeechConstant.NET_TIMEOUT，在应用层未 调用setParameter(String, String)来设置参数值前，可能获取到的是null值， 但在实际会话会始时，SDK会使用默认值传给服务器。

覆盖:

getParameter 在类中 com.iflytek.cloud.msc.module.SpeechInterface

参数:

key - 参数名称

返回:

参数值

另请参阅:

setParameter(String, String)