语音评测(Evaluator)
这里介绍的是iOS API关于语音评测(Evaluator)的相关说明，点击右侧目录可快速找到相应文件。
#类IFlySpeechEvaluator
| Inherits from | NSObject |
|---|---|
| Conforms to | IFlySpeechEvaluatorDelegate |
| Declared in | IFlySpeechEvaluator.h |
#语音评测类
#音频流评测
音频流评测可以将文件分段写入
#Other Methods
#delegate
设置委托对象
@property (assign) id<IFlySpeechEvaluatorDelegate> delegate
Declared In
IFlySpeechEvaluator.h
#+ sharedInstance
返回评测对象的单例
+ (instancetype)sharedInstance
Return Value
别对象的单例
Declared In:
IFlySpeechEvaluator.h
#– destroy
销毁评测对象。
- (BOOL)destroy
Return Value
成功返回YES，失败返回NO。
Declared In
IFlySpeechEvaluator.h
#– setParameter:forKey:
设置评测引擎的参数
- (BOOL)setParameter:(NSString *)value forKey:(NSString *)key
Parameters
| value | 评测引擎参数值 |
|---|---|
| key | 评测引擎参数 |
Return Value
设置的参数和取值正确返回YES,失败返回NO
Declared In
IFlySpeechEvaluator.h
#– parameterForKey:
获得评测引擎的参数
- (NSString *)parameterForKey:(NSString *)key
Parameters:
| key | 评测引擎参数 |
|---|---|
Return Value
key对应的参数值
Declared In
IFlySpeechEvaluator.h
#– startListening:params:
开始评测
同时只能进行一路会话,这次会话没有结束不能进行下一路会话，否则会报错
- (BOOL)startListening:(NSData *)data params:(NSString *)params
Parameters
| data | 评测的试题 |
|---|---|
| params | 评测的参数 |
Return Value
成功返回YES，失败返回NO
Declared In
IFlySpeechEvaluator.h
#– stopListening
停止录音
调用此函数会停止录音，并开始进行语音识别
- (void)stopListening
Declared In
IFlySpeechEvaluator.h
#– cancel
取消本次会话
- (void)cancel
Declared In
IFlySpeechEvaluator.h
#IFlyStreamISERecognizer Methods
#– writeAudio:
写入音频流
- (BOOL)writeAudio:(NSData *)audioData
Parameters
| audioData | 音频数据 |
|---|---|
Return Value
写入成功返回YES，写入失败返回NO
Declared In
IFlySpeechEvaluator.h
#协议IFlySpeechEvaluatorDelegate
| Conforms to | NSObject |
|---|---|
| Declared in | IFlySpeechEvaluatorDelegate.h |
#评测协议
#–onVolumeChanged:buffer: required method
音量和数据回调
- (void)onVolumeChanged:(int)volume buffer:(NSData *)buffer
Parameters
| volume | 音量 |
|---|---|
| buffer | 音频数据 |
Declared In
IFlySpeechEvaluatorDelegate.h
#– onBeginOfSpeech required method
开始录音回调
当调用了startListening函数之后，如果没有发生错误则会回调此函数。如果发生错误则回调onCompleted:函数
- (void)onBeginOfSpeech
Declared In
IFlySpeechEvaluatorDelegate.h
#– onEndOfSpeech required method
停止录音回调
当调用了stopListening函数或者引擎内部自动检测到断点，如果没有发生错误则回调此函数。
如果发生错误则回调onCompleted:函数
- (void)onEndOfSpeech
Declared In
IFlySpeechEvaluatorDelegate.h
#– onCancel required method
- (void)onCancel
Declared In
IFlySpeechEvaluatorDelegate.h
#– onCompleted: required method
评测错误回调
- (void)onCompleted:(IFlySpeechError *)errorCode
Parameters
| errorCode | 错误描述类 |
|---|---|
Discussion
在进行语音评测过程中的任何时刻都有可能回调此函数，你可以根据errorCode进行相应的处理.当errorCode没有错误时，表示此次会话正常结束，否则，表示此次会话有错误发生。特别的当调用cancel函数时，引擎不会自动结束，需要等到回调此函数，才表示此次会话结束。在没有回调此函数之前如果重新调用了startListenging函数则会报错误。
Declared In
IFlySpeechEvaluatorDelegate.h
#– onResults:isLast: required method
评测结果回调
在评测过程中可能会多次回调此函数，你最好不要在此回调函数中进行界面的更改等操作，只需要将回调的结果保存起来。
- (void)onResults:(NSData *)results isLast:(BOOL)isLast
Parameter:
| results | -[out] 评测结果。 |
|---|---|
| isLast | -[out] 是否最后一条结果 |
Declared In
IFlySpeechEvaluatorDelegate.h