bricks/docs/ai/vadtext.md

# VadText

控件功能：一个集成语音采集、音频播放和语音识别文本展示的复合控件，用户点击按钮开始录音，当检测到语音结束时自动将音频转为 WAV 格式并发送至后端进行语音识别，返回结果实时显示在文本区域中。  
类型：容器控件  
父类控件：bricks.VBox

## 初始化参数

- `opts.name` *(可选)*: 控件名称，默认为 `'asr_text'`。
- `opts.height`: 默认设置为 `'100%'`，占据父容器全部高度。
- 其他继承自 `VBox` 的通用布局参数（如 `width`, `align` 等）也可传入。

## 主要事件

- `audio_ready`: 当语音活动检测（VAD）捕获到一段完整的语音并生成音频数据时触发。携带参数为 `Float32Array` 类型的音频样本数据。
- `changed`: 当语音识别完成且有非空文本内容时，在停止录音后触发。携带当前控件的值对象 `{ [name]: text }`，可用于表单提交或状态同步。