输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
指南
指南应用服务Reader Kit（阅读服务）书籍内容交互阅读进度通知

阅读进度通知

更新时间: 2026-09-09 06:54
本文导读

当页面展示时，会通过页面展示回调接口返回页面渲染信息。页面渲染信息提供用于阅读进度跳转的domPos及resourceIndex属性，开发者可将属性缓存到数据库当中，用于阅读进度的恢复。

接口说明

阅读进度通知涉及2个接口，具体介绍如下表所示。

展开
接口名 描述
on('pageShow') 注册页面展示的通知服务，该通知在页面排版成功展示后触发。
off('pageShow') 注销章节内容分页展示结果回调，可在页面销毁时调用。

开发准备

在进行阅读进度通知监听之前，请先确保已经“构建阅读器”。

开发步骤

  1. 通过ReaderComponentController组件控制器监听页面展示回调。

    当排版引擎渲染完页面后会回调on('pageShow')接口，将页面渲染信息进行返回。通过页面渲染信息的domPos及resourceIndex属性，可标识当前阅读进度。

    开发者可在on('pageShow')接口回调中将阅读进度实时保存到数据库当中，防止用户异常退出阅读器时的进度丢失。当用户下次继续阅读时，可将保存domPos及resourceIndex属性传入到startPlay接口中，用于阅读进度的恢复。

    aboutToAppear(): void {
  this.setOnPageShowListener();
}

private async setOnPageShowListener(){
  try {
      this.readerComponentController.on('pageShow', (data: readerCore.PageDataInfo): void => {
      // 开发者可在此保存内容分页排版数据，利用data.resourceIndex及data.startDomPos数据调用startPlay接口继续阅读
      hilog.info(0x0000, 'testTag', 'pageshow: data is: ' + JSON.stringify(data));
    });
  } catch (err) {
    hilog.error(0x0000, 'testTag', `failed to init, Code is ${err.code}, message is ${err.message}`);
  }
}

  2. 页面销毁时，需要调用注销页面展示接口。

    aboutToDisappear(): void {
  this.readerComponentController.off('pageShow');
}
手动触发翻页
Scenario Fusion Kit（融合场景服务）
相关推荐
文档发布进度条类型通知
文档监听文本缩放因子变化
文档签到、完成浏览任务获取积分
文档支付结果回调通知
文档签约结果回调通知
文档测试服务端通知
文档网络场景识别
文档动态订阅公共事件
文档NotificationInfo
文档传感器开发指导
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词