Guides

介绍

本章节介绍如何在 Android 应用中集成 CPDFReaderView，以及阅读场景下的常用能力，包括文档加载状态、显示模式、页面导航、文本搜索、页面缩放、主题和无障碍支持。

如果你是首次接入查看器，建议先完成基础接入，再按需阅读后续专题。

从 2.6.6 版本开始，ComPDF Android PDF 查看器支持 TalkBack 无障碍能力，可为查看器中的关键交互元素提供朗读与焦点反馈，帮助开发者构建更易访问的阅读体验。

建议阅读顺序

1. 先看 使用CPDFReaderView，完成基础接入。
2. 再看 文档状态与错误回调，了解加载状态和异常处理。
3. 如果需要支持屏幕阅读器，可继续阅读 TalkBack 无障碍支持，了解适用版本、验证方式和接入建议。
4. 然后按需阅读显示模式、导航、搜索、主题等专题，补充具体能力。

本章内容

概览与接入

• 使用CPDFReaderView

  在 XML 布局中集成 CPDFReaderView，完成 PDF 阅读器的基础接入。

• 文档状态与错误回调

  监听文档加载状态、错误提示和模式变化，便于处理加载失败和交互异常。

基础阅读

• 显示模式

  配置单页、双页、书本、翻页或连续滚动等阅读模式，以及裁切模式和视图模式。

• 页面导航

  跳转到指定页面，并监听阅读器中的翻页和滚动事件。

• 页面缩放

  调整页面缩放比例，以适配不同的阅读需求和显示场景。

• 主题

  使用预设主题或自定义颜色，适配不同的阅读环境。

文档导航

• 大纲

  通过文档大纲快速定位章节和内容结构。

• 书签

  管理书签并快速跳转到已标记的位置。

文本交互

• 搜索和选取

  搜索关键字、高亮命中结果，并按范围提取页面文本。

• 获取选中内容

  获取查看器中当前选中的文本内容。

• 文本重排

  重新排列页面文本，以适配不同设备的屏幕尺寸。

交互增强

• 高亮表单字段和超链接

  高亮表单字段和超链接，提升文档中的交互可见性。

• PDF 页面转图片

  将 PDF 页面渲染为图片，用于导出、预览或二次处理。

高级定制

• 自定义菜单

  自定义上下文菜单，扩展阅读过程中的快捷操作。

无障碍

• TalkBack 无障碍支持

  说明 TalkBack 支持的适用版本、验证方式和接入建议，帮助评估 Android PDF 查看器的无障碍体验。