IFlySpeechRecognizer Class Reference

Inherits from	NSObject
Conforms to	IFlySpeechRecognizerDelegate
Declared in	IFlySpeechRecognizer.h

Overview

语音识别类
此类现在设计为单例，你在使用中只需要创建此对象，不能调用release/dealloc函数去释放此对象。所有关于语音识别的操作都在此类中。

音频流识别
音频流识别可以将文件分段写入

Other Methods

`delegate`

设置委托对象

@property (nonatomic, assign) id<IFlySpeechRecognizerDelegate> delegate

Declared In

IFlySpeechRecognizer.h

`+ sharedInstance`

返回识别对象的单例

+ (instancetype)sharedInstance

Return Value

识别对象的单例

Declared In

IFlySpeechRecognizer.h

`– destroy`

销毁识别对象。

- (BOOL)destroy

Return Value

成功返回YES,失败返回NO

Declared In

IFlySpeechRecognizer.h

`– setParameter:forKey:`

设置识别引擎的参数

- (BOOL)setParameter:(NSString *)value forKey:(NSString *)key

Parameters

`value`	参数对应的取值
`key`	识别引擎参数

Return Value

成功返回YES；失败返回NO

Discussion

识别的引擎参数(key)取值如下：

参数	描述
domain	应用的领域: 取值为:iat、search、video、poi、music、asr； iat：普通文本听写； search：热词搜索； video：视频音乐搜索； asr：关键词识别;
vad_bos	前端点检测: 静音超时时间，即用户多长时间不说话则当做超时处理；单位：ms； engine指定iat识别默认值为5000；其他情况默认值为 4000，范围 0-10000。
vad_eos	后断点检测: 后端点静音检测时间,即用户停止说话多长时间内即认为不再输入,自动停止录音；单位:ms; sms 识别默认值为 1800; 其他默认值为 700，范围 0-10000。
sample_rate	采样率:目前支持的采样率设置有 16000 和 8000。
asr_ptt	标点符号设置: 默认为 1，当设置为 0 时，将返回无标点符号文本。
result_type	返回结果的数据格式: 可设置为json，xml，plain，默认为json。
grammarID	识别的语法id: 只针对 domain 设置为”asr”的应用。
asr_audio_path	音频文件名: 设置此参数后，将会自动保存识别的录音文件。路径为Documents/(指定值)。不设置或者设置为nil，则不保存音频。
params	扩展参数: 对于一些特殊的参数可在此设置，一般用于设置语义。

Declared In

IFlySpeechRecognizer.h

`– parameterForKey:`

获取识别引擎参数

- (NSString *)parameterForKey:(NSString *)key

Parameters

`key`	参数key

Return Value

参数值

Declared In

IFlySpeechRecognizer.h

`– startListening`

开始识别

- (BOOL)startListening

Return Value

成功返回YES；失败返回NO

Discussion

同时只能进行一路会话，这次会话没有结束不能进行下一路会话，否则会报错。若有需要多次回话，请在onCompleted回调返回后请求下一路回话。

Declared In

IFlySpeechRecognizer.h

`– stopListening`

停止录音
调用此函数会停止录音，并开始进行语音识别

- (void)stopListening

Declared In

IFlySpeechRecognizer.h

`– cancel`

取消本次会话

- (void)cancel

Declared In

IFlySpeechRecognizer.h

`– buildGrammarCompletionHandler:grammarType:grammarContent:`

上传语法

- (int)buildGrammarCompletionHandler:(IFlyOnBuildFinishCompletionHandler)completionHandler grammarType:(NSString *)grammarType grammarContent:(NSString *)grammarContent

Parameters

`completionHandler`	上传语法完成回调
`grammarType`	语法类型
`grammarContent`	语法内容

Return Value

错误码

Declared In

IFlySpeechRecognizer.h

`isListening`

是否正在识别

@property (nonatomic, readonly) BOOL isListening

Declared In

IFlySpeechRecognizer.h

IFlyStreamRecognizer Methods

`– writeAudio:`

写入音频流

- (BOOL)writeAudio:(NSData *)audioData

Parameters

`audioData`	音频数据

Return Value

写入成功返回YES，写入失败返回NO

Discussion

此方法的使用示例如下:

[_iFlySpeechRecognizer setParameter:@"-1" value:@"audio_source"];
[_iFlySpeechRecognizer startListening];
[_iFlySpeechRecognizer writeAudio:audioData1];
[_iFlySpeechRecognizer writeAudio:audioData2];
...
[_iFlySpeechRecognizer stopListening];

Declared In

IFlySpeechRecognizer.h