用途:在 Blazor 应用中通过 Syncfusion SpeechToText 组件实现语音输入,将麦克风采集的音频实时转换为文本。组件基于浏览器 Speech Recognition API,自动处理麦克风访问、音频采集、转写与监听生命周期。
主要能力:实时语音转文字;多语言支持(如 en-US、fr-FR、de-DE 等 100 多种语言);监听状态管理(Inactive、Listening、Stopped);通过 AllowInterimResults 提供临时结果实时反馈;错误处理(no-speech、aborted、audio-capture、not-allowed、network 等);浏览器兼容性检测;可自定义工具提示与禁用状态;提供生命周期事件回调。
使用方式:通过 NuGet 安装包,引用 @using Syncfusion.Blazor.Inputs,使用 <SfSpeechToText @bind-Transcript="@transcript"></SfSpeechToText> 进行双向绑定,可配合 SfTextArea 显示与编辑转写文本。常用属性包括 Transcript、Language、ListeningState、AllowInterimResults、ShowTooltip、Disabled、HtmlAttributes。公共方法有 StartListeningAsync() 与 StopListeningAsync()。可通过 SpeechRecognitionStarted、SpeechRecognitionStopped、SpeechRecognitionError 事件处理状态与错误。按钮可通过 SpeechToTextButtonSettings 自定义文本、图标、图标位置与主按钮样式;工具提示通过 SpeechToTextTooltipSettings 配置文本与位置。
适用场景:语音搜索、表单填写、语音笔记、无障碍输入、多语言聊天、听写工具、客服反馈转写等。
限制:依赖浏览器 Speech Recognition API,Firefox 不受支持,Chrome、Edge、Safari、Opera 有版本要求;需要麦克风权限与网络可用性;不支持浏览器需做特性检测与降级处理。具体安装命令、版本号与完整 API 细节请参阅官方文档,资料中暂未提供价格与收费信息。