shenandshen
948004eed1
源码注释： - 为 ~60 个 Swift 文件补充缺失的 doc comment（file header、类型、属性、方法） - 修正 4 处错误注释：翻页模式数量、搜索行为描述、手势识别器描述、悬空文档块 文档维护： - 删除重复文档：WXRead/读书EPUB阅读器实现架构.md（与微信读书版完全一致） - 合并重叠文档：阅读器规划.md → 阅读器功能开发计划.md（单一真值） - 修正过时内容：所有文档中"四种翻页模式"→"三种"，移除 horizontalCoverScroll - 更新架构图：补齐 EPUBUI/ReaderController、Paging/、Typesetter/ 等子目录 - 更新 index.md 索引：新增开发计划和架构对比文档引用
72 lines
2.9 KiB
Swift
72 lines
2.9 KiB
Swift
import Foundation
|
|
|
|
/// EPUB 阅读器位置协调器：负责阅读位置的恢复、查询和持久化。
|
|
///
|
|
/// 职责：
|
|
/// - 根据保存的位置恢复阅读进度
|
|
/// - 获取当前可见页面的阅读位置
|
|
/// - 从持久化存储加载已保存位置
|
|
/// - 持久化当前位置并通知委托
|
|
final class RDEPUBReaderLocationCoordinator {
|
|
private unowned let context: RDEPUBReaderContext
|
|
|
|
init(context: RDEPUBReaderContext) {
|
|
self.context = context
|
|
}
|
|
|
|
/// 恢复到指定阅读位置，返回是否成功跳转。
|
|
@discardableResult
|
|
func restoreReadingLocation(_ location: RDEPUBLocation, animated: Bool = false) -> Bool {
|
|
guard let controller = context.controller,
|
|
let readerView = context.readerView else { return false }
|
|
guard let targetPageNumber = controller.pageNumber(for: location) else {
|
|
readerView.transitionToPage(pageNum: 0)
|
|
context.readingSession?.transition(to: .idle)
|
|
return false
|
|
}
|
|
|
|
if context.textBook == nil {
|
|
_ = context.readingSession?.queueNavigation(
|
|
to: location,
|
|
relativeToSpineIndex: nil,
|
|
bookIdentifier: context.currentBookIdentifier
|
|
)
|
|
} else {
|
|
context.readingSession?.transition(to: .jumping)
|
|
}
|
|
readerView.transitionToPage(pageNum: max(targetPageNumber - 1, 0), animated: animated)
|
|
return true
|
|
}
|
|
|
|
/// 获取当前可见页面对应的阅读位置。
|
|
func currentVisibleLocation() -> RDEPUBLocation? {
|
|
guard let controller = context.controller,
|
|
let readerView = context.readerView else {
|
|
return nil
|
|
}
|
|
if context.textBook != nil, readerView.currentPage >= 0 {
|
|
return controller.resolvedTextLocation(forPageNumber: readerView.currentPage + 1)
|
|
}
|
|
return context.readingSession?.currentReadingLocation(bookIdentifier: context.currentBookIdentifier)
|
|
}
|
|
|
|
/// 从持久化存储加载上次保存的阅读位置。
|
|
func persistenceLocation() -> RDEPUBLocation? {
|
|
guard let controller = context.controller,
|
|
let currentBookIdentifier = context.currentBookIdentifier else {
|
|
return nil
|
|
}
|
|
return controller.persistence?.loadLocation(for: currentBookIdentifier)
|
|
}
|
|
|
|
/// 持久化阅读位置，并通知委托更新目录项和书签状态。
|
|
func persist(location: RDEPUBLocation) {
|
|
guard let controller = context.controller,
|
|
let currentBookIdentifier = context.currentBookIdentifier else { return }
|
|
controller.persistence?.saveLocation(location, for: currentBookIdentifier)
|
|
controller.delegate?.epubReader(controller, didUpdateLocation: location)
|
|
controller.delegate?.epubReader(controller, didUpdateCurrentTableOfContentsItem: controller.currentTableOfContentsItem)
|
|
controller.updateBookmarkChrome()
|
|
}
|
|
}
|