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

语音输入接口可使得网页开发人员能快速调用设备的麦克风进行语音输入,而不需要安装额外的浏览器插件。规范不定义底层语音识别引擎的技术架构,浏览器实现可基于语音识别服务器或本地内置语音识别模块。

方法:

  • startRecognize: 启动语音识别
  • stopRecognize: 停止语音识别
  • addEventListener: 监听语音识别事件

对象:

  • SpeechRecognizeOptions: JSON对象,语音识别参数
  • SpeechRecoginzeEvents: 语音识别事件类型

回调方法:

  • RecognitionEventCallback: 语音识别事件回调函数
  • RecognitionSuccessCallback: 语音识别成功回调
  • RecognitionErrorCallback : 语音识别失败回调

权限:

permissions

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#ffffff">{</span>
<span style="color:#87ceeb">// ...</span>
<span style="color:#ffa0a0">"permissions"</span><span style="color:#ffffff">:{</span><span style="color:#87ceeb">// ...</span><span style="color:#ffa0a0">"Speech"</span><span style="color:#ffffff">:</span> <span style="color:#ffffff">{</span><span style="color:#ffa0a0">"description"</span><span style="color:#ffffff">:</span> <span style="color:#ffa0a0">"语音输入"</span><span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span></code></span></span>

startRecognize

启动语音识别

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">speech</span><span style="color:#ffffff">.</span><span style="color:#ffffff">startRecognize</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> options</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> successCB</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> errorCB </span><span style="color:#ffffff">);</span></code></span></span>

说明:

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

参数:

  • options: ( SpeechRecognizeOptions ) 必选 语音识别参数,用于控制语音引擎的各种技术参数
  • successCB: ( RecognitionSuccessCallback ) 可选 语音识别成功回调

    当语音识别引擎识别数据成功时的回调函数,并返回识别出的文本内容。

  • errorCB: ( RecognitionErrorCallback ) 可选 语音识别失败时的回调函数

    当语音识别引擎识别数据失败时的回调函数,并返回失败的错误信息。

返回值:

void : 无

示例:

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

uni-app使用plus注意事项

stopRecognize

停止语音识别

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">speech</span><span style="color:#ffffff">.</span><span style="color:#ffffff">stopRecognize</span><span style="color:#ffffff">();</span></code></span></span>

说明:

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

参数:

返回值:

void : 无

示例:

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

uni-app使用plus注意事项

addEventListener

监听语音识别事件

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">speech</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#f0e68c"><strong>event</strong></span><span style="color:#ffffff">,</span><span style="color:#ffffff"> listener</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> capture</span><span style="color:#ffffff">);</span></code></span></span>

说明:

向语音识别模块添加事件监听器,当指定的事件发生时,将触发listener函数的执行。 可多次调用此方法添加多个监听器,当监听的事件发生时,将按照添加的先后顺序触发执行。

参数:

  • event: ( SpeechRecoginzeEvents ) 必选 语音识别事件类型
  • listener: ( RecognitionEventCallback ) 必选 监听事件发生时执行的回调函数
  • capture: ( Boolean ) 可选 捕获事件流顺序,暂无效果

返回值:

void : 无

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span><span style="color:#f0e68c"><strong><head></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>/></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>name</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"viewport"</span> <span style="color:#bdb76b"><strong>content</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"initial-scale=1.0, maximum-scale=1.0, user-scalable=no"</span><span style="color:#f0e68c"><strong>/></strong></span><span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Speech Example</span><span style="color:#f0e68c"><strong></title></strong></span><span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// 监听plusready事件  </span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"plusready"</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(){</span><span style="color:#87ceeb">// 监听语音识别事件</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">speech</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"start"</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(){</span><span style="color:#ffffff">text </span><span style="color:#ffffff">=</span> <span style="color:#f0e68c"><strong>null</strong></span><span style="color:#ffffff">;</span><span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">speech</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"recognition"</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">){</span><span style="color:#ffffff">text </span><span style="color:#ffffff">+=</span><span style="color:#ffffff"> e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">result</span><span style="color:#ffffff">;</span><span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">speech</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"end"</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(){</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"Success: "</span><span style="color:#ffffff">+</span><span style="color:#ffffff">text</span><span style="color:#ffffff">);</span><span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>false</strong></span> <span style="color:#ffffff">);</span>
<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> text</span><span style="color:#ffffff">=</span><span style="color:#f0e68c"><strong>null</strong></span><span style="color:#ffffff">;</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> startRecognize</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> options </span><span style="color:#ffffff">=</span> <span style="color:#ffffff">{};</span><span style="color:#ffffff">text </span><span style="color:#ffffff">=</span> <span style="color:#ffa0a0">""</span><span style="color:#ffffff">;</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">speech</span><span style="color:#ffffff">.</span><span style="color:#ffffff">startRecognize</span><span style="color:#ffffff">(</span><span style="color:#ffffff">options</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong></script></strong></span><span style="color:#f0e68c"><strong></head></strong></span><span style="color:#f0e68c"><strong><body></strong></span><span style="color:#f0e68c"><strong><button</strong></span> <span style="color:#bdb76b"><strong>onclick</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">startRecognize</span><span style="color:#ffffff">()</span><span style="color:#ffa0a0">"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">开始识别</span><span style="color:#f0e68c"><strong></button><br/></strong></span><span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span></code></span></span>

uni-app使用plus注意事项

SpeechRecognizeOptions

JSON对象,语音识别参数

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>interface</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">speech</span><span style="color:#ffffff">.</span><span style="color:#98fb98">SpeechRecognizeOptions</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">attribute </span><span style="color:#98fb98">Boolean</span> <span style="color:#f0e68c"><strong>continue</strong></span><span style="color:#ffffff">;</span><span style="color:#ffffff">attribute </span><span style="color:#98fb98">String</span><span style="color:#ffffff"> engine</span><span style="color:#ffffff">;</span><span style="color:#ffffff">attribute </span><span style="color:#98fb98">String</span><span style="color:#ffffff"> lang</span><span style="color:#ffffff">;</span><span style="color:#ffffff">attribute </span><span style="color:#98fb98">Number</span><span style="color:#ffffff"> nbest</span><span style="color:#ffffff">;</span><span style="color:#ffffff">attribute </span><span style="color:#98fb98">String</span><span style="color:#ffffff"> punctuation</span><span style="color:#ffffff">;</span><span style="color:#ffffff">attribute </span><span style="color:#98fb98">Number</span><span style="color:#ffffff"> timeout</span><span style="color:#ffffff">;</span><span style="color:#ffffff">attribute </span><span style="color:#98fb98">Boolean</span><span style="color:#ffffff"> userInterface</span><span style="color:#ffffff">;</span><span style="color:#ffffff">attribute </span><span style="color:#98fb98">EventHandler</span><span style="color:#ffffff"> onstart</span><span style="color:#ffffff">;</span><span style="color:#ffffff">attribute </span><span style="color:#98fb98">EventHandler</span><span style="color:#ffffff"> onend</span><span style="color:#ffffff">;</span>
<span style="color:#ffffff">}</span></code></span></span>

说明:

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

属性:

  • continue: (Boolean 类型 )语音识别是否采用持续模式

    设置为true表示语音引擎不会根据语音输入自动结束,识别到文本内容将多次调用successCallback函数返回,如果需要结束语音识别则必须调用stopRecognize接口,默认值为false。

  • engine: (String 类型 )语音识别引擎标识

    用于兼容多语音识别引擎的浏览器,使用语音识别厂商的产品名称,如未设置或设置不正确则使用运行环境默认的语音识别引擎。 支持以下语音识别引擎: "baidu"-百度语音识别; "iFly"-讯飞语音识别。

  • lang: (String 类型 )语音识别引擎的语言

    用于定义语音识别引擎的语言,其取值需符合W3C的Language codes规范。 目前讯飞语音支持以下语言: "zh-cn"-中文,普通话; "en-us"-英语; "zh-cantonese"-中文,粤语; "zh-henanese"-中文,河南话(百度语音识别不支持此语言)。 默认值为"zh-cn"。

  • nbest: (Number 类型 )指定识别结果识别包括多候选结果

    用于指定识别结果识别包括多候选结果。如nbest:3,识别返回3个候选结果,默认值为1。

  • punctuation: (Boolean 类型 )识别结果中是否包含标点符号

    true表示识别结果文本中包含标点符号,false表示识别结果文本中不包含标点符号。 默认值为true。

    平台支持

    • Android - ALL (支持)
    • iOS - ALL (不支持) :

      百度语音识别不支持标点符号。

  • timeout: (Number 类型 )语音识别超时时间

    语音识别超时的时间,单位为ms,默认值为1000(即10秒)。 注:百度语音识别不支持此参数。

  • userInterface: (Boolean 类型 )识别时是否显示用户界面

    用于指定识别时是否显示用户界面,设置为true表示显示浏览器内置语音识别界面;设置为false表示不显示浏览器内置语音识别界面。默认值为true。

  • onstart: (EventHandler 类型 )语音识别开始事件(已废弃,使用start事件)

    事件函数,语音识别开始启动,在调用startRecognize方法后触发,与onend事件成对触发。 注:iOS平台未支持

  • onend: (EventHandler 类型 )语音识别结束事件(已废弃,使用end事件)

    事件函数,语音识别结束,在调用stopRecognize方法后触发,或者在引擎内部自动完成语音识别后触发,与onstart事件成对触发。 注:iOS平台未支持

SpeechRecoginzeEvents

语音识别事件类型

说明:

描述语音过程的触发事件列表,可以通过调用plus.sppech.addEventListener方法进行注册监听。

常量:

  • start: (String 类型 )开始语音识别

    调用plus.speech.startRecognize方法开始语音识别时触发。 无回调函数参数。

  • volumeChange: (String 类型 )音量变化

    开始语音识别后,麦克风录制到的语音音量变化时触发。 回调函数参数event={volume:"Number类型,取值范围0-1"}。

  • recognizing: (String 类型 )临时语音识别结果

    返回临时语音识别结果时触发。 回调函数参数event={partialResult:"String类型,临时识别结果"}。

  • recognition: (String 类型 )最终语音识别

    返回最终语音识别结果。 回调函数参数event={result:"String类型,最佳识别结果",results:"String数组类型,所有候选结果"}。

  • end: (String 类型 )结束语音识别

    调用plus.speech.stopRecognize方法结束语音识别或语音识别完成后自动结束时触发。 无回调函数参数。

  • error: (String 类型 )语音识别错误

    语音识别发生错误时触发。 回调函数参数event={code:"Number类型,错误编码",message:"String类型,错误描述信息"}。

RecognitionEventCallback

语音识别事件回调函数

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onEvent</span><span style="color:#ffffff">(</span><span style="color:#f0e68c"><strong>event</strong></span><span style="color:#ffffff">){</span><span style="color:#87ceeb">// Event code</span>
<span style="color:#ffffff">}</span></code></span></span>

说明:

调用plus.speech.addEventListener方法监听语音识别事件的回调函数。

参数:

  • event: ( Object ) 可选

    不同事件返回的参数不一样,详情参考SpeechRecoginzeEvents事件说明。

返回值:

void : 无

RecognitionSuccessCallback

语音识别成功回调

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onSuccess</span><span style="color:#ffffff">(</span><span style="color:#ffffff">result</span><span style="color:#ffffff">){</span><span style="color:#87ceeb">// Recognition success code</span>
<span style="color:#ffffff">}</span></code></span></span>

说明:

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

参数:

  • result: ( String ) 必选 语音识别出的文本内容

返回值:

void : 无

RecognitionErrorCallback

语音识别失败回调

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onError</span><span style="color:#ffffff">(</span><span style="color:#ffffff">error</span><span style="color:#ffffff">){</span><span style="color:#87ceeb">// Recognition error code</span>
<span style="color:#ffffff">}</span></code></span></span>

说明:

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

参数:

  • error: ( Exception ) 必选 语音识别失败的错误信息

    可通过error.code(Number类型)获取错误编码; 可通过error.message(String类型)获取错误描述信息。 详细错误描述信息可参考:http://ask.dcloud.net.cn/article/282。

返回值:

void : 无

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

  1. 度秘语音引擎app_带有语音识别功能的APP

    实验目的: 调用讯飞api实现一个带有语音识别功能的app, 功能主要包括 1.实现语音输入转换成文本,显示在输入文本框中 2. 实现语音合成,能让文本框中的文字转换成语音输出 先跑通这样的一个dem ...

  2. Qt系列文章之二十五(使用QAudiolnput获取音频输入)

    文章目录 前言 效果图 QAudioInput获取音频输入功能概述 程序主窗口定义与初始化 音频输入设备支持的格式 开始音频输入 流设备MineDisplayDevice的功能实现 源码获取 前言   ...

  3. ChatGPT商业网站源码/支持GPT4.0/ai绘画(MJ绘画模型)/用户会员套餐+支持个人收款/赚取收益/实时语音识别输入/文章资讯发布功能/邀请分佣功能/后台一键版本更新!

    前言 程序已支持ChatGPT4.0.Midjourney绘画.GPT3.5 绘画.语音识别输入.文章资讯发布功能.用户每日签到功能+一键更新版本.支持手机电脑不同布局页面自适应. 1.提问:程序已经 ...

  4. 最新AI创作系统V5.0.2+支持GPT4+支持ai绘画+实时语音识别输入+文章资讯发布功能+用户会员套餐

    最新AI创作系统V5.0.2+支持GPT4+支持ai绘画+实时语音识别输入+文章资讯发布功能+用户会员套餐! AI创作系统 一.源码系统介绍 二.AI创作系统程序下载 三.安装教程 四.主要功能展示 ...

  5. 安卓调用系统语音识别功能全解(谷歌语音服务):获取识别结果,使用语音识别进行搜索。

    全栈工程师开发手册 (作者:栾鹏) 安卓教程全解 安卓调用系统语音识别功能全解(谷歌语音服务):获取识别结果,使用语音识别进行搜索. 首先要添加权限 <uses-permission andro ...

  6. RDIFramework.NET ━ .NET快速信息化系统开发框架 V3.2-新增模块管理界面导出功能(可按条件导出)...

    RDIFramework.NET ━ .NET快速信息化系统开发框架 V3.2->新增模块管理界面导出功能(可按条件导出) 导出功能在很多应用场景中都需要,RDIFramework.NET V3 ...

  7. iOS中 语音识别功能/语音转文字教程具体解释 韩俊强的博客

    前言:近期研究了一下语音识别,从百度语音识别到讯飞语音识别:首先说一下个人针对两者的看法,讯飞毫无疑问比較专业.识别率也非常高真对语音识别是比較精准的,可是非常多开发人员和我一样期望离线识别,而讯飞离 ...

  8. iphone之使用讯飞语音sdk实现语音识别功能

    2.学习里面的demo简单实现了一个小的语音识别功能 先做一个简单demo,看看识别效果.注:语音识别必须联网. 所有接口必需在联网状态下才能正常使用. 效果图: #import #import &q ...

  9. 华为手机计算机怎么语音算术,华为自带的语音识别功能太实用了!这样操作,3秒语音变文字...

    原标题:华为自带的语音识别功能太实用了!这样操作,3秒语音变文字 如果用过华为手机的小伙伴肯定都知道,华为手机有很多实用的实用的功能,对于商务人士来说,特别有用,例如:无线投屏.智能识物等功能,又方便 ...

最新文章

  1. 网络框架 - 收藏集 - 掘金
  2. dataset中有多个表,返回XML字符串设置主从关系
  3. 基于Angular创建后台数据模拟(译)
  4. 猫大叫,鼠速逃,人醒了
  5. PyTorch框架学习三——张量操作
  6. mysql跳过安全_Navicat连接MySQL数据库
  7. 一款可留言的恋爱计时HTML源码
  8. qmail 反垃圾邮件
  9. 吃下这枚安利!翠贝卡电影节上这五部VR视频不容错过
  10. Vim 命令行快捷键
  11. 《Redis实战》一2.2 使用Redis实现购物车
  12. 如何将通讯录批量转换为vcf格式导入手机,苹果手机如何批量删除通讯录?
  13. 关于用友凭证打印模板
  14. 统计遗传学:第五章,多基因评分PGS
  15. python图片表格转excel表格_python提取图片内容并转换成对应表格的markdown代码
  16. 全球与中国绿色多元醇市场现状及未来发展趋势
  17. Xftp5 安装教程
  18. 在Java控制台实现学生成绩管理系统
  19. 三、道阻且长之单例模式
  20. 计算机网络带宽确定,一种计算机网络可用带宽测量方法

热门文章

  1. forward 和 redirect 区别
  2. 谷歌Chrome浏览器在新标签页打开书签链接的五个方法
  3. 物联网LoRa系列-1:物联网系统分层架构
  4. C语言猴子吃桃问题(两种方法)
  5. vue3.0 深度选择器>>> 和 /deep/ 和 ::v-deep 被弃用‘the >>> and /deep/ combinators have been deprecated‘
  6. kali网络配置-临时ip、永久IP
  7. 基于PHP+小程序(MINA框架)+Mysql数据库的物业维修报修小程序系统设计与实现
  8. <8>Linux中的软件管理2021-10-17
  9. 《扬帆优配》互联互通扩容提升港股市场活力
  10. 全国2023年自学考试下半年报考专业一览表