Guides

TalkBack 无障碍支持

从 2.6.6 版本开始，ComPDF Android PDF 查看器支持 TalkBack 无障碍能力。启用 TalkBack 后，用户可以通过系统屏幕阅读器识别查看器中的关键 UI 元素，并获得相应的朗读与焦点反馈。

适用版本

• ComPDF Android PDF SDK 2.6.6 及以上版本。
• 适用于集成 CPDFReaderView 的查看器场景。

支持说明

TalkBack 支持主要面向查看器中的关键交互元素，例如工具栏按钮、导航入口和常见操作控件，帮助用户通过焦点移动和语音播报完成基础阅读操作。

实际朗读内容和交互效果会受到以下因素影响：

• Android 系统版本。
• 宿主应用对查看器 UI 的定制方式。
• 当前页面状态，以及是否启用了搜索、书签、目录等相关功能。

如果应用对查看器外层容器、工具栏或业务按钮做了二次封装，建议同时检查宿主应用自身的无障碍属性配置，确保整体交互链路完整可用。

如何验证 TalkBack 支持

1. 在 Android 设备中启用 TalkBack。
2. 集成 ComPDF Android PDF SDK 2.6.6 或更高版本，并使用 CPDFReaderView 打开 PDF 文档。
3. 通过左右滑动切换焦点，检查查看器中的关键控件是否可以被正确聚焦和播报。
4. 使用双击操作触发按钮或入口，检查核心阅读流程中的交互反馈是否正常。

接入建议

• 首次接入查看器时，先完成 使用CPDFReaderView 的基础集成，再进行 TalkBack 验证。
• 如果应用对查看器 UI 做了自定义布局或额外按钮封装，建议在真机上完成一次完整的焦点遍历测试。
• 如果需要对显示模式、目录、书签、搜索等功能做专项验证，可结合对应章节逐项检查无障碍体验。

注意事项

• 本章节用于说明 ComPDF Android PDF 查看器已提供 TalkBack 支持能力。
• 如果你的应用对查看器进行了深度 UI 定制，最终无障碍体验还需要结合宿主应用的实现共同验证。
• 若你在特定设备、系统版本或定制界面下遇到朗读、聚焦或操作反馈异常，可联系技术支持进一步排查。