Speech

稿件来源: 互联网   撰稿作者: 匿名   发表日期: 2015-03-23   阅读次数: 521   查看权限: 游客查看

Speech模块管理语音输入功能,提供语音识别功能,可支持用户通过麦克风设备进行语音输入内容。通过plus.speech可获取语音输入管理对象。

方法:

对象:

    • apis.objects.object.abstract

回调方法:

startRecognize

启动语音识别

void plus.speech.startRecognize( options, successCB, errorCB );

说明:

启动语音识别时调用,当语音识别成功后通过successCallback回调返回识别出文本内容,调用语音识别失败则通过errorCallback回调返回。

参数:

  • options (SpeechRecognizeOption) 可选 语音识别参数,用于控制语音引擎的各种技术参数
  • successCB (RecognitionSuccessCallback) 可选 当语音识别引擎识别数据成功时的回调函数,并返回识别出的文本内容。
  • errorCB (RecognitionErrorCallback) 可选 当语音识别引擎识别数据失败时的回调函数,并返回失败的错误信息。

返回值:

示例:

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>Speech Example</title>
	<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕,现在可以正常调用扩展API
	// ...
}, false );
var text=null;
function startRecognize () {
	var options = {};
	options.engine = 'iFly';
	text = "";
	alert( "开始语音识别:" );
	plus.speech.startRecognize( options, function ( s ) {
		text += s;
	}, function ( e ) {
		alert( "语音识别失败:"+e.message );
	} );
}
	</script>
	</head>
	<body>
		<button onclick="startRecognize">开始识别</button><br/>
		<button onclick="alert(text);">识别内容</button>
	</body>
</html>

stopRecognize

停止语音识别

void plus.speech.stopRecognize();

说明:

当语音识别完成时或用户取消语音识别时调用,调用此方法将导致errorCallback回调函数的调用。

返回值:

示例:

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>Speech Example</title>
	<script type="text/javascript">
// 监听plusready事件
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕,现在可以正常调用扩展API
	// ...
}, false );
var text=null;
function startRecognize () {
	var options = {};
	options.engine = 'iFly';
	text = "";
	alert( "开始语音识别:" );
	plus.speech.startRecognize( options, function ( s ) {
		text += s;
	}, function ( e ) {
		alert( "语音识别失败:"+e.message );
	} );
	setTimeout( stopRecognize, 10000 );
}
function stopRecognize(){
	plus.speech.stopRecognize();
}
	</script>
	</head>
	<body>
		<button onclick="startRecognize">开始识别(10s后自动关闭)</button><br/>
		<button onclick="alert(text);">识别内容</button>
	</body>
</html>

SpeechRecognizeOption

JSON对象,语音识别参数

interface plus.speech.SpeechRecognizeOption {
	attribute DOMString engine;
	attribute DOMString service;
	attribute Number timeout;
	attribute DOMString lang;
	attribute Boolean continue;
	attribute Number nbest;
	attribute Boolean userInterface;
	attribute EventHandler onstart;
	attribute EventHandler onend;
	attribute EventHandler onaudiostart;
	attribute EventHandler onaudioend;
	attribute EventHandler onrecognizestart;
	attribute EventHandler onrecognizeend;
}

说明:

控制语音识别引擎内部参数,在JS中为JSON对象,在启动语音识别时使用。

属性:

  • engine:DOMString,用于兼容多语音识别引擎的浏览器,建议使用语音识别厂商的产品名称,如未设置或设置不正确则使用浏览器默认的语音识别引擎。
  • service:DOMString,可使用url地址或ip地址,如service:192.168.1.99指定定制的语音识别引擎服务器。默认值为浏览器内置服务器地址。
  • timeout:Number,语音识别超时的时间,单位为ms,如timeout:60000,默认值为10s。
  • lang:DOMString,用于定义语音识别引擎的语言,其取值需符合W3C的Language codes规范。默认值为浏览器的默认语言。
  • continue:Boolean,设置为true表示语音引擎不会根据语音输入自动结束,识别到文本内容将多次调用successCallback函数返回,如果需要结束语音识别则必须调用stopRecognize接口,默认值为false。
  • nbest:Number,用于指定识别结果识别包括多候选结果。如nbest:3,识别返回3个候选结果,默认值为1。
  • userInterface:Boolean,用于指定识别时是否显示用户界面,设置为true表示显示浏览器内置语音识别界面;设置为false表示不显示浏览器内置语音识别界面。默认值为true。
  • onstart:EventHandler,事件函数,语音识别开始启动,在调用startRecognize方法后触发,与onend事件成对触发。
  • onend:EventHandler,事件函数,语音识别结束,在调用stopRecognize方法后触发,或者在引擎内部自动完成语音识别后触发,与onstart事件成对触发。
  • onaudiostart:EventHandler,事件函数,录音开始事件,启动语音识别后,调用设备麦克风设备开始一段语音录音时触发,与onaudioend事件成对触发。
  • onaudioend:EventHandler,事件函数,录音结束事件,调用麦克风完成一段语音录音时触发,与onaudiostart事件成对触发。
  • onrecognizestart:EventHandler,事件函数,录音识别开始事件,开始对语音录音数据分析识别,与onrecognizeend事件成对触发。
  • onrecognizeend:EventHandler,事件函数,录音识别结束事件,开始对语音录音数据分析识别完成,与onrecognizestart事件成对触发。

RecognitionSuccessCallback

语音识别成功回调

void RecognitionSuccessCallback ( results ) {
	// Recognition success code
}

说明:

当语音识别成功时的回调函数,用于返回语音识别出的文本内容。

参数:

  • results (DOMString[]) 可选 语音识别出的候选文本内容,区配度高的在数组的前面,通过其length属性可获取总的候选内容的长度

RecognitionErrorCallback

语音识别失败回调

void RecognitionErrorCallback ( error ) {
	// Recognition error code
}

说明:

当语音识别失败时的回调函数,用于返回语音识别失败的错误信息。

参数:

  • error (DOMException) 可选 语音识别失败的错误信息

关键词: html5puls,Speech   编辑时间: 2015-03-23 23:22:51

  • 感到高兴

    0

    高兴
  • 感到支持

    0

    支持
  • 感到搞笑

    0

    搞笑
  • 感到不解

    0

    不解
  • 感到谎言

    0

    谎言
  • 感到枪稿

    0

    枪稿
  • 感到震惊

    0

    震惊
  • 感到无奈

    0

    无奈
  • 感到无聊

    0

    无聊
  • 感到反对

    0

    反对
  • 感到愤怒

    0

    愤怒
0%(0)
0%(0)
上一篇:Share
下一篇:Statistic
共有0 条评论 发言请遵守【相关规定

网友评论

会员头像
发 表同步腾讯微博    验证码:  点击更新请先登陆
  • 暂无评论
关闭模块文章图片 article Pictrue
  • 我的妈妈爸爸
  • 基于koa2+mysql+vue2.0+Element阳光内容管理系统
  • 代码覆盖率工具 Istanbul 入门教程
  • 全栈工程师的武器——MEAN
  • 9款超炫的 CSS3 复选框(Checkbox)
  • 微信开发在线翻译功能
  • CSS3那些不为人知的高级属性
  • 给easyui的datebox添加清空事件
  • flash写字效果
  • kendoUI系列教程之DropDownList下拉菜单
  • kendoUI系列教程之datetimepicker日期时间选择
  • kendoUI系列教程之datepicker日期选择
  • kendoUI系列教程之combobox下拉列表框
  • kendoUI系列教程之colorpicker
  • kendoUI系列教程之calendar日历表
  • kendoUI系列教程之autocomplete自动补齐