[TOC]

声纹识别，主要是提供基于用户声纹特征的注册、验证服务。讯飞开放平台支持2种类型的声纹密码类型，即文本密码和数字密码，在注册时需要指定声纹类型。

1.1. 声纹注册

  1. //设置声纹工作参数
  2. //设置密码类型，pwdt的取值为1、3，分别表示文本密码和数字密码
  3. [self.identityVerifier setParameter:[NSString stringWithFormat:@"%d",pwdt] forKey:@"pwdt"];

pwdt的取值说明如下表所示：

值说明
1文本密码。用户通过读出指定的文本内容来进行声纹注册和验证，现阶段支持的文本只有“芝麻开门”一种。
3数字密码。从云端拉取一组特定的数字串（共分5组，每组8位数字），用户依次读出这5组数字进行注册，在验证过程中会生成一串特定的数字，用户通过朗读这串数字进行验证。
  1. 密码内容需调用接口从云端获取：
  2. //通过调用getPasswordList方法来获取密码。
  3. //获取密码的时候需指定声纹密码类型，pwdt为1表示固定文本密码，pwdt为3表示数字密码。 //getPasswordList可以参照demo所示。NSString   *paramTemp = [NSString stringWithFormat:@"sub=ivp,rse=utf-8,pwdt=%d,",pwdt];
  4. 获取到密码后，接下来进行声纹注册。
  6. // 设置业务类型为训练    
  7. [self.identityVerifier setParameter:@"enroll"  forKey:@"MFV_SST"];  
  9. // 设置密码类型    
  10. [self.identityVerifier setParameter:[NSString stringWithFormat:@"%d",pwdt] forKey:@"pwdt"];
  12. // 对于文本密码和数字密码，必须设置密码的文本内容.
  13. // ptxt的取值为“我的地盘我做主”、“移动改变生活”、“芝麻开门”或者是从云端拉取的数字密码(每8位用“-”隔开)。
  14. [self.identityVerifier setParameter:ptxt forKey:@"ptxt"];
  16. // 设置声纹对应的auth_id，它用于标识声纹对应的用户
  17. [self.identityVerifier setParameter:auth_id forKey:@"auth_id"];
  19. // 设置有效录音时间
  20. [self.identityVerifier setParameter:@"3000" forKey:@"vad_timeout"];
  22. // 末端静音检测时间，用于检测到静音自动停止录音
  23. [self.identityVerifier setParameter:@"700" forKey:@"vad_speech_tail"];
  25. // 启动训练服务
  26. // 开始注册，当得到注册结果时，SDK会将其封装成NSDictionary对象，回调onResult方法进行处理，处理方法详见Demo示例
  27. [self.identityVerifier startListening];
  29. // 声纹协议IFlyISVDelegate实现
  30. //会话结果返回回调
  31. -(void) onResult:(NSDictionary *)dic;
  33. //会话结束回调
  34. -(void) onCompleted:(IFlySpeechError *) errorCode; 
  36. //结果处理中回调
  37. -(void) onRecognition;
  39. //录音音量改变回调 
  40. -(void) onVolumeChanged: (int)volume;

推荐在注册声纹模型时每个用户都指定一个唯一的auth_id。auth_id的格式为：6-18个字符，为字母、数字和下划线的组合且必须以字母开头，不支持中文字符，不能包含空格。 开发者通过重写onResult方法来处理注册和验证结果。在结果result中携带错误码，用来判别注册是否成功以及出错原因，部分错误码的含义如下表所示：

错误码说明
10106缺少某个必要参数
10107某个必要参数存在但无效
10110引擎授权不足或者说授权客户端用户数达到上限
10114操作超时
10116数据库中模型不存在
10212数据库中模型已经存在
10400数据库中一般性错误，此时此ssb已经登录超过3次且均失败
10407APPID非法
10606音频太短

1.2. 声纹验证

声纹验证过程与声纹注册类似，不同之处仅在于“sst”参数需要设置为“verify”，其他参数的设置、验证结果的处理过程可参考上一节。另外，为了达到较好的效果，请在声纹注册与验证过程中尽量与麦克风保持同样的距离（建议的最佳距离是15厘米左右）。若距离较远，可能会对验证通过率产生较大影响。

1.3. 声纹模型操作

  1. 声纹注册成功后，在云端会生成一个对应的模型来存储声纹信息，声纹模型的操作即对模型进行查询和删除。
  3. //开发者调用sendRequest方法查询或者删除模型，该函数的定义如下：
  5. //cmd: @”query”表示查询，@”del”表示删除
  7. //auth_id表示用户名;
  9. //pwdt表示声纹类型；
  11. //ptxt表示查询或者删除的密码文本；
  13. //vid是用户注册成功后服务器返回的32位标识，查询和删除时，vid可以设置位nil;
  15. //err是查询的错误码。 通常查询或者删除成功，该函数会返回YES,否则返回NO;
  16. -(BOOL) sendRequest:(NSString*)cmd authid:(NSString *)auth_id  pwdt:(int)pwdt ptxt:(NSString *)ptxt vid:(NSString *)vid err:(int *)err;

1.4. 声纹业务返回结果格式和参数说明

请参见 附录 声纹业务