修复 EPUB 与 PDF 阅读器朗读交互

PDF 朗读的逐词回调会在同一页内持续触发高亮，原实现每次都调用翻页入口，使用户在朗读过程中反复看到页面转场。现仅在目标页变化时定位，并对朗读产生的跨页定位禁用动画，保留高亮刷新而不重复翻页。\n\nEPUB/TXT 此前只提供内容源，缺少将朗读进度回写到阅读器的会话层，无法从当前阅读位置开始朗读、随内容跨页及显示临时高亮。新增 EPUB 朗读会话，使用 href 与 UTF-16 偏移恢复位置；文本重排 EPUB 与 TXT 按实际页面定位并高亮，Web EPUB 则按章节安全定位以避免词级回调导致跳页。URL 阅读器同时提供可选会话入口，图片型阅读器保持不可朗读。\n\n已执行 ReadViewDemo 的 Debug Simulator 构建，结果为 BUILD SUCCEEDED。
2026-07-30 18:33:04 +09:00
parent 529663829f
commit e01cbc169d
5 changed files with 145 additions and 8 deletions
@@ -37,10 +37,10 @@ try await session.start(from: 0)
 ## Use with EPUB

 ```swift
-let provider = reader.makeSpeechContentProvider()
-let speech = RDSpeechReaderController(contentProvider: provider)
-try await speech.start(from: nil)
+let session = reader.makeSpeechSession()
+try await session.start()
 ```

-Speech locations use EPUB `href` plus a UTF-16 text offset. They remain stable
-when the user changes fonts or page size, unlike screen page numbers.
+EPUB/TXT 会话默认从当前阅读位置开始。文本重排 EPUB 与 TXT 会临时高亮当前朗读范围，
+并且只在朗读跨页时定位；朗读位置使用 EPUB `href` 与 UTF-16 文本偏移，因此用户修改
+字体或页面大小后仍可稳定恢复。