SwiftUI中如何适配String类型实现语音朗读文本高亮?
核心问题根源
- 原UIKit实现依赖直接修改UILabel的富文本属性更新高亮,属于命令式UI逻辑;SwiftUI是数据驱动的声明式渲染体系,不存在直接修改视图组件属性的操作路径,直接套用UIKit逻辑必然出现类型不匹配的报错
- NSMutableAttributedString与String属于完全不同的数据类型:String是无格式的纯字符序列,NSAttributedString是绑定了格式属性的富文本容器,没有无损失直接转换为String的合法路径
- 语音代理回调返回的NSRange基于UTF-16编码计算,Swift原生String的下标基于Character集群(支持 emoji、组合字符等)计算,直接混用会导致高亮位置偏移,是适配过程中容易遗漏的细节
适配核心逻辑
- 将Speaker改造为遵循ObservableObject协议的可观测状态类,不再持有无意义的String类型文本容器,仅维护两类状态:原始待朗读文本、当前需要高亮的字符范围
- 视图层基于当前状态动态生成SwiftUI原生支持的AttributedString,不需要手动维护富文本对象,只要监听的状态发生变化,视图就会自动完成重绘
- 完成编码兼容转换:将代理回调的NSRange映射为Swift原生String的可用范围,避免高亮错位
- 所有涉及状态更新的操作统一在主队列执行,避免后台线程更新UI引发的异常
可运行的修正实现
import AVFoundation import SwiftUI class Speaker: NSObject, ObservableObject { let synth = AVSpeechSynthesizer() // 原始待朗读文本 var fullText: String = "" // 监听当前需要高亮的字符范围,视图会自动随该值更新 @Published var currentHighlightRange: Range<String.Index>? override init() { super.init() synth.delegate = self } func speak(_ string: String) { // 朗读前重置高亮状态 currentHighlightRange = nil fullText = string let utterance = AVSpeechUtterance(string: string) utterance.voice = AVSpeechSynthesisVoice(language: "en-GB") utterance.rate = 0.4 synth.speak(utterance) } } extension Speaker: AVSpeechSynthesizerDelegate { func speechSynthesizer(_ synthesizer: AVSpeechSynthesizer, willSpeakRangeOfSpeechString characterRange: NSRange, utterance: AVSpeechUtterance) { // 将NSRange(UTF-16编码)转换为Swift String可识别的原生范围 guard let nativeRange = Range(characterRange, in: fullText) else { return } DispatchQueue.main.async { self.currentHighlightRange = nativeRange } } func speechSynthesizer(_ synthesizer: AVSpeechSynthesizer, didFinish utterance: AVSpeechUtterance) { DispatchQueue.main.async { // 朗读完成后清除高亮 self.currentHighlightRange = nil } } } struct SpeechHighlightView: View { @StateObject private var speaker = Speaker() private let demoText = "This is a test text for SwiftUI speech highlight effect" var body: some View { VStack(spacing: 20) { Text(generateRenderedString()) .font(.title3) .multilineTextAlignment(.leading) Button("开始朗读") { speaker.speak(demoText) } } .padding() } // 根据当前高亮状态动态生成带格式的文本 private func generateRenderedString() -> AttributedString { var attrStr = AttributedString(demoText) if let highlightRange = speaker.currentHighlightRange, let attrRange = attrStr.range(from: highlightRange) { attrStr[attrRange].foregroundColor = .red } return attrStr } }
自定义扩展提示
- 如需调整高亮样式(比如更换高亮色、添加背景色、设置加粗),只需要在动态生成AttributedString的方法中,给对应范围添加匹配的属性即可,不需要改动核心的语音逻辑
- 如果需要支持大段文本的自动滚动,可以在视图层监听
currentHighlightRange的变化,计算对应文本位置的滚动偏移量即可实现联动效果
内容的提问来源于stack exchange,提问作者MikeMaus
相关产品推荐
相关产品推荐

