Flutter开发中如何实现TTS朗读时对应单词的下划线或高亮效果
Flutter TTS 单词级朗读联动高亮实现指南
核心实现思路
完全不需要靠定时器估算朗读进度去匹配高亮位置(这种方式误差极大,语速变化、语音停顿都会导致高亮错位),直接依托TTS引擎原生提供的单词级进度回调做联动,就能把高亮和实际朗读的时间差控制在100ms以内,达到自然的实时联动效果。
具体实现步骤
- 提前处理文本结构
把待朗读的全文本预先做边界拆分:英文按空格拆分单词,中文按分词结果拆成独立语义单元,每个单元记录自己在全文中的起始字符偏移、结束字符偏移。同时把页面的文本渲染替换为RichText组件,每个拆分后的单元对应一个独立的TextSpan,为后续单独修改样式做准备。 - 绑定TTS进度回调
初始化TTS功能时,注册引擎自带的朗读进度回调。回调会在朗读过程中实时触发,返回当前正在朗读的文本片段、片段在全文中的起始位置、结束位置,不需要自行计算朗读节奏。 - 状态联动更新样式
维护一个可全局监听的状态值,记录当前正在朗读的文本单元索引。每次进度回调触发时,根据返回的位置匹配到对应的文本单元,更新高亮状态:匹配到的单元实时加上下划线效果、背景色高亮等自定义样式,其余单元保持默认文本样式即可。
避坑提示
- 选择TTS依赖时优先选透传系统引擎原生回调的官方维护包,避免选没有实现单词级进度透传的第三方封装,否则还是要回到靠定时器估算的老路上,精度根本达不到要求。
- 部分老旧机型的TTS引擎可能存在进度回调精度不足的问题,比如跳过短单词的位置上报,可以加简单兜底逻辑:当相邻两次上报的位置间隔超过1个单元长度时,按固定短间隔轮询补全中间单元的高亮,避免高亮断档。
- 中文场景不要直接按空格拆分单词,否则会把整句话作为一个整体高亮,需要搭配基础分词逻辑拆分语义单元。
- 高频回调场景下不要直接重建整个
RichText组件,可以用ValueListenableBuilder绑定高亮索引,只更新对应位置的TextSpan,避免频繁渲染导致的页面掉帧。 - 不需要针对调整后的朗读语速手动计算高亮延迟,TTS引擎的进度回调本身是和实际朗读节奏强绑定的,不管设置什么语速,回调节奏都会自动适配。
内容的提问来源于stack exchange,提问作者Daniel Salas DG
相关产品推荐
相关产品推荐

