bricks/docs/ai/webspeech.md

# 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，否则会打印不支持提示。