com.supermap.mapping.speech

接口 IntelligentSpeechListener

public interface IntelligentSpeechListener

语音识别监听的接口：通过实现此接口，获取当前识别的状态和结果。

方法概要

限定符和类型	方法和说明
void	onBeginOfSpeech() 开始说话 在录音模式下，调用开始录音函数后，会自动开启系统的录音机，并在录音机开启后，会回调此函数（这中间的过程应该在几毫秒内，可以忽略，除非系统响应很慢）。
void	onEndOfSpeech() 在SDK检测到音频的静音端点时，回调此函数（应用层主动调用stopListening()则不会回调此函数， 在识别出错时，可能不会回调此函数）。
void	onError(java.lang.String error) 当此函数回调时，说明当次会话出现错误，会话自动结束，录音也会停止。
void	onResult(java.lang.String info, boolean isLast) 返回的结果可能为null，请增加判断处理。
void	onVolumeChanged(int volume) 当开始识别，到停止录音 或SDK返回最后一个结果自动结束识别为止， SDK检测到音频数据（正在录音）的音量变化时，会多次通过此函数回调，告知应用层当前的音量值。

方法详细资料

onBeginOfSpeech

void onBeginOfSpeech()

开始说话 在录音模式下，调用开始录音函数后，会自动开启系统的录音机，并在录音机开启后，会回调此函数（这中间的过程应该在几毫秒内，可以忽略，除非系统响应很慢）。 应用层可通过此函数回调，告知用户，当前可开始说话。若应用层使用的是声音提示， 则应该在调用开始录音函数前，提放提示音， 并在提示音非静音数据播放结束时，调用开始录音函数，开始录音。若太早调用，则可能会把提示音录进要识别的音频中，若太晚，则可能会漏掉部分用户说话的音频。

onEndOfSpeech

void onEndOfSpeech()

在SDK检测到音频的静音端点时，回调此函数（应用层主动调用stopListening()则不会回调此函数， 在识别出错时，可能不会回调此函数）。 在此函数回调后，当前识别会话可能并没有结束，识别结果可能还要等待一定的时间才会返回。 应用层可以通过此函数回调，告知用户，当次说话已结束，正在等待识别结果（若结果未返回）等。

onVolumeChanged

void onVolumeChanged(int volume)

当开始识别，到停止录音 或SDK返回最后一个结果自动结束识别为止， SDK检测到音频数据（正在录音）的音量变化时，会多次通过此函数回调，告知应用层当前的音量值。 应用层可通过此函数传入的值变化，改变自定义UI的画面等。 参数: volume - 当前音量值，范围[0-30]

参数:

volume - 音量大小

onError

void onError(java.lang.String error)

当此函数回调时，说明当次会话出现错误，会话自动结束，录音也会停止。

参数:

error - 错误信息

onResult

void onResult(java.lang.String info,
              boolean isLast)

返回的结果可能为null，请增加判断处理。 一次识别会话的结果可能会多次返回（即多次回调此函数），通过参数isLast, 判断是否是最后一个结果，true时为最后一个结果，否则不是。 当最后一个结果返回时，本次会话结束，录音也会停止。 当出现错误，或应用层调用cancel()取消当次识别时，在当次识别会话过程可能不会回调此函数。 识别采用边录边上传的分次上传音频数据方式，可能在结束录音前，就有结果返回。 注意：如果有多次返回，最终的结果应该是由多次返回的结果拼接而成。

参数:

info - 返回的结果数据（语音对应的文本信息）

isLast - 是否最后一次结果标记