You need to enable JavaScript to run this app. SwiftUI中如何适配String类型实现语音朗读文本高亮?
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 06:36:05