bricks/dist/docs/zh/webspeech.md
yumoqing 1291f7fee3 fix: UiCode build_options uses valueField/textField fallback to 'value'/'text'
When valueField/textField are not explicitly set in opts, the auto-select
logic (line 1140) and nullable empty-option creation (lines 1144-1145) used
data[0][undefined] which returned undefined, causing:
- Single-option selects to show blank (auto-select failed)
- nullable empty options to have undefined keys

Now extracts vf/tf local variables with ||'value'/||'text' fallback at the
top of build_options(), used consistently throughout.
2026-05-29 23:03:52 +08:00

1.5 KiB
Raw Blame History

WebTTS

控件功能实现基于浏览器的文本转语音Text-to-Speech功能支持多语言、音调和语速设置并提供语音合成过程中的事件回调。
类型:容器控件
父类控件bricks.VBox

初始化参数

  • opts:继承自 bricks.VBox 的初始化参数,用于配置布局和基本属性。
    • 支持 VBox 容器的所有通用配置项(如样式、子控件等)。

主要事件

无自定义事件触发,但内部使用以下语音合成事件进行状态监控:

  • onstart:语音合成开始时输出日志。
  • onend:语音合成结束时输出日志。
  • onerror:语音合成出错时输出错误信息。

注:该控件通过调用 speak(text) 方法执行语音播放,不依赖外部事件绑定机制触发 UI 变化。


WebASR

控件功能实现基于浏览器的语音识别Speech Recognition功能将用户的语音输入转换为文本内容并通过事件派发识别结果。
类型:容器控件
父类控件bricks.VBox

初始化参数

  • opts:继承自 bricks.VBox 的初始化参数,用于配置布局和基本属性。
    • 支持 VBox 容器的所有通用配置项。

主要事件

  • asr_result:当语音识别成功返回结果时触发,携带识别出的文本内容。
    • 数据格式:{ content: string }
    • 示例:{ content: "你好世界" }

注:需浏览器支持 SpeechRecognition API否则会打印不支持提示。