SpeakerVerifier

com.iflytek.speech 类 SpeakerVerifier

java.lang.Object
  com.iflytek.speech.SpeakerVerifier

public class SpeakerVerifier

extends java.lang.Object

声纹识别。

作者：

iflytek

SpeakerVerifier

public SpeakerVerifier(android.content.Context context,
                       InitListener listener)

创建声纹识别对象。

说明：
1、初始化声纹密码客户端对象，通过传入APPID等信息来创建声纹密码对象， 该对象可用于获取密码文本、声纹模型训练、确认、鉴别等操作。

参数：

context - 上下文环境

listener - 回调接口

register

public int register(java.lang.String vid,
                    java.lang.String params,
                    VerifierListener listener)

声纹模型训练。

说明：
1、 params参数必须携带pwdt及pwid参数； 例：注册定制密码：”pwdt=0,ptid=1”； 注册自由文本密码：”pwdt=2,ptid=波若波罗密”。
2、训练成功，回调结果中VerifyResult.ret为true，并且VerifyResult.vid表示注册返回的声纹ID。
3、一台硬件设备最多允许注册16个声纹id，超过16个需要携带vid字段，服务端会执行清理操作，否则，服务端会返回10110授权不足错误。

参数：

vid - 如果用户已经进行注册，需要执行覆盖操作时，需要将已注册的声纹ID传入，服务端将会把已注册的声纹ID删除， 传入null表示生成新的声纹id

params - 参数列表： 1、pwdt：注册密码类型，0表示定制密码，1表示文本密码，2表示自由密码； 2、ptid：密码id，当pwdt等于0或1时，ptid传入对应密码id，请参考PassWord说明， 当pwdt为2时，ptid携带的是用户的自由密码文本； 3、rgn：声纹密码注册次数，即用户需要通过语音输入多少次文本才能完成训练，服务端默认为5，可选择范围为1-5；

listener - 回调接口

返回：

返回值，0表示成功

verify

public int verify(java.lang.String vid,
                  java.lang.String params,
                  VerifierListener listener)

声纹密码确认。

说明：
1、用户确认成功，回调结果中VerifyResult.ret为true，false表示确认失败。

参数：

vid - 声纹模型id，即用户声纹模型训练时服务端返回的声纹ID

params - 附件参数，无特殊约定传null

listener - 回调接口

返回：

返回值，0表示成功

identify

public int identify(java.lang.String vidlist,
                    java.lang.String params,
                    VerifierListener listener)

声纹密码鉴别。

说明：
1.鉴别成功，回调结果中VerifyResult.ret为true，并且VerifyResult.vid表示鉴别成功的用户声纹ID。
2.鉴别时，必须携带多个声纹id信息。

参数：

vidlist - 声纹id列表，多个用户进行鉴别，需要将对应用户声纹id进行拼接，每个id中间以半角逗号进行分割

params - 声纹鉴别参数

listener - 回调接口

返回：

返回值，0表示成功

getPasswordList

public int getPasswordList(android.content.Context context,
                           SpeakerVerifier.DownloadListener listener,
                           java.lang.String pwdType)

获取密码文本。

说明：
1、在注册声纹密码之前需要先获取密码文本及id信息，密码文本包含三种类型，对应接口中pwdType参数， 分别为：0表示定制密码，1表示文本密码，2表示自由密码，自由密码为用户自定义文本，无需调用此接口获得，只有为0或1时才有效。
2、文本的获取内容通过listener回调监听器获取，需要注意的是监听器的返回有两种情况：获取密码成功， 通过onData返回ArrayList类型的密码列表；获取密码失败，通过onError返回错误码信息。
3、调用此接口会在客户端生成缓存，多次调用不会重复通过网络获取，但是仍然会通过回调接口直接返回。

参数：

context - 上下文环境

listener - 回调接口

pwdType - 文本类型（0：表示定制密码，1：表示文本密码，2：表示自由密码）

返回：

返回值，0表示成功

setParameter

public int setParameter(java.lang.String key,
                        java.lang.String value)

设置语义参数。 设置的参数值在下次识别仍然有效。 包括引擎类型、语言、语言区域、场景、前后端点超时等

参数：

key - 参数名称

value - 参数值

返回：

错误码，0表示成功

getParameter

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

获取当前参数值。 包括引擎类型、语言、语言区域、场景、前后端点超时等，另外包括支持的语言列表等

参数：

key - 参数名称

返回：

参数值