SpeakerVerifier

Xunfei Voice+



com.iflytek.speech 类 SpeakerVerifier

java.lang.Object
  继承者 com.iflytek.speech.SpeakerVerifier

public class SpeakerVerifier
extends java.lang.Object

声纹识别。

作者:
iflytek

嵌套类摘要
static interface SpeakerVerifier.DownloadListener
          声纹密码下载回调接口。
 class SpeakerVerifier.PassWord
          密码。
 
构造方法摘要
SpeakerVerifier(android.content.Context context, InitListener listener)
          创建声纹识别对象。
 
方法摘要
 java.lang.String getParameter(java.lang.String key)
          获取当前参数值。
 int getPasswordList(android.content.Context context, SpeakerVerifier.DownloadListener listener, java.lang.String pwdType)
          获取密码文本。
 int identify(java.lang.String vidlist, java.lang.String params, VerifierListener listener)
          声纹密码鉴别。
 int register(java.lang.String vid, java.lang.String params, VerifierListener listener)
          声纹模型训练。
 int setParameter(java.lang.String key, java.lang.String value)
          设置语义参数。
 int verify(java.lang.String vid, java.lang.String params, VerifierListener listener)
          声纹密码确认。
 
从类 java.lang.Object 继承的方法
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

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 - 参数名称
返回:
参数值