iOS 语音评测(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