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 }，可用于表单提交或状态同步。