# 声纹识别 iOS SDK 文档

<key>NSMicrophoneUsageDescription</key>
<string></string>
<key>NSLocationUsageDescription</key>
<string></string>
<key>NSLocationAlwaysUsageDescription</key>
<string></string>
<key>NSContactsUsageDescription</key>
<string></string>

//Appid是应用的身份信息，具有唯一性，初始化时必须要传入Appid。
NSString *initString = [[NSString alloc] initWithFormat:@"appid=%@", @"YourAppid"];
[IFlySpeechUtility createUtility:initString];

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

密码内容需调用接口从云端获取：
//通过调用getPasswordList方法来获取密码。
//获取密码的时候需指定声纹密码类型，pwdt为1表示固定文本密码，pwdt为3表示数字密码。 //getPasswordList可以参照demo所示。NSString   *paramTemp = [NSString stringWithFormat:@"sub=ivp,rse=utf-8,pwdt=%d,",pwdt];
获取到密码后，接下来进行声纹注册。

// 设置业务类型为训练    
[self.identityVerifier setParameter:@"enroll"  forKey:@"MFV_SST"];  

// 设置密码类型    
[self.identityVerifier setParameter:[NSString stringWithFormat:@"%d",pwdt] forKey:@"pwdt"];

// 对于文本密码和数字密码，必须设置密码的文本内容.
// ptxt的取值为“我的地盘我做主”、“移动改变生活”、“芝麻开门”或者是从云端拉取的数字密码(每8位用“-”隔开)。
[self.identityVerifier setParameter:ptxt forKey:@"ptxt"];

// 设置声纹对应的auth_id，它用于标识声纹对应的用户
[self.identityVerifier setParameter:auth_id forKey:@"auth_id"];

// 设置有效录音时间
[self.identityVerifier setParameter:@"3000" forKey:@"vad_timeout"];

// 末端静音检测时间，用于检测到静音自动停止录音
[self.identityVerifier setParameter:@"700" forKey:@"vad_speech_tail"];

// 启动训练服务
// 开始注册，当得到注册结果时，SDK会将其封装成NSDictionary对象，回调onResult方法进行处理，处理方法详见Demo示例
[self.identityVerifier startListening];

// 声纹协议IFlyISVDelegate实现
//会话结果返回回调
-(void) onResult:(NSDictionary *)dic;

//会话结束回调
-(void) onCompleted:(IFlySpeechError *) errorCode; 

//结果处理中回调
-(void) onRecognition;

//录音音量改变回调 
-(void) onVolumeChanged: (int)volume;

声纹注册成功后，在云端会生成一个对应的模型来存储声纹信息，声纹模型的操作即对模型进行查询和删除。

//开发者调用sendRequest方法查询或者删除模型，该函数的定义如下：

//cmd: @”query”表示查询，@”del”表示删除

//auth_id表示用户名;

//pwdt表示声纹类型；

//ptxt表示查询或者删除的密码文本；

//vid是用户注册成功后服务器返回的32位标识，查询和删除时，vid可以设置为nil;

//err是查询的错误码。 通常查询或者删除成功，该函数会返回YES,否则返回NO;
-(BOOL) sendRequest:(NSString*)cmd authid:(NSString *)auth_id  pwdt:(int)pwdt ptxt:(NSString *)ptxt vid:(NSString *)vid err:(int *)err;