SpeechInput

基于浏览器 Web Speech API 的语音听写输入框，点击麦克风即可口述转文字。

最后更新 2026-10-25 19:27:08

说明

多行文本框右侧带麦克风开关，点击后先行申请（或再次唤起）麦克风权限，识别中的临时文本以预览行实时显示，确认后的整句自动追加到绑定值。Lang 设置识别语言（默认 zh-CN），Continuous 切换持续/单句模式，Interim 控制是否显示临时预览。需在 HTTPS 或 localhost 安全上下文使用；浏览器不支持时自动降级为只读并给出提示；权限被拒绝后可再次点击麦克风重试。

常见能力：

麦克风一键起停
拒绝后再次点击可重新唤起授权
临时文本实时预览
整句自动追加
持续/单句模式
识别语言可配
不支持自动降级

用法

<SpeechInput @bind-Value="@text" Lang="zh-CN" Rows="4" Continuous="true" Placeholder="请说话…" />

API 参数

参数	类型	默认值	说明
`Continuous`	`bool`	`false`	持续识别（说完一句不自动停止），默认单句模式。
`Interim`	`bool`	`true`	是否显示识别中的临时（interim）文本预览。
`Invalid`	`bool`	`false`	错误状态（红框）。
`Lang`	`string`	`"zh-CN"`	识别语言，BCP-47 标签，默认中文（zh-CN）。可设为 en-US 等。
`Live`	`bool`	`false`	输入后立即触发绑定（默认失焦触发）。
`MaxLength`	`int`	`0`	最大字符数，0 表示不限制。
`Placeholder`	`string`	`"请说话…"`	占位文字。
`ReadOnly`	`bool`	`false`	只读（仍可点击麦克风追加，但不可手动编辑文本）。
`Rows`	`int`	`3`	行数（多行输入框高度）。
`Value`	`string`	`null`	绑定值（识别出的文本，可手动编辑）。
`ValueChanged`	`EventCallback<string>`	—	事件
`Visible`	`bool`	`true`	取得或设置组件是否可见，默认为false。
`VisibleChanged`	`EventCallback<bool>`	—	事件取得或设置组件可见性变化时的回调事件。
`Class`	`string`	`null`	取得或设置组件的CSS类名，用于自定义样式。
`Disabled`	`bool`	`false`	取得或设置组件是否禁用，默认为false。
`Style`	`string`	`null`	取得或设置组件的内联样式，用于自定义样式。

所有组件均继承 BaseComponent，除上表参数外还支持 Class、Style、Disabled、Visible。