接口名	描述
getDefaultHandler(path: string): Promise<BookParserHandler>	获取书籍默认解析器。
getCatalogList(): CatalogItem[]	获取书籍目录列表。
getDomPosByCatalogHref(href: string): string	获取阅读起始位置domPos。
getSpineList(): SpineItem[]	获取书脊内容列表。

开发步骤

导入相关模块。

import { common } from '@kit.AbilityKit';
import { bookParser } from '@kit.ReaderKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

通过提前导入到应用沙箱目录中的书籍文件，初始化书籍解析器。

private defaultHandler: bookParser.BookParserHandler | null = null;

aboutToAppear(): void {
  this.init().then(() => {
  });
}

private async init() {
  let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  let path: string = `${context.filesDir}/abc.epub`;
  try {
    this.defaultHandler = await bookParser.getDefaultHandler(path);
  } catch (error) {
    hilog.error(0x0000, "testTAG", `getDefaultHandler failed, Code: ${error.code}, message: ${error.message}`);
  }
}

获取目录列表并进行展示。

@State catalogItemList: bookParser.CatalogItem[] = [];

aboutToAppear(): void {
  this.init().then(() => {
    this.getCatalogList();
  });
}

private getCatalogList() {
  try {
    this.catalogItemList = this.defaultHandler?.getCatalogList() || [];
  } catch (error) {
    hilog.error(0x0000, "testTAG", `getCatalogList failed, Code: ${error.code}, message: ${error.message}`);
  }
}

build() {
  Column() {
    List() {
      ForEach(this.catalogItemList, (item: bookParser.CatalogItem) => {
        ListItem() {
          Column() {
            Row() {
              Row() {
                Text(' · ')
                  .fontSize(14)
                Text(item.catalogName)
                  .fontSize(14)
                  .textOverflow({ overflow: TextOverflow.Ellipsis })
                  .padding({ top: 8, bottom: 8 })
                  .maxLines(2)
                  .layoutWeight(1)
              }

            }
            .width('100%')
            .height(48)
            .justifyContent(FlexAlign.Center)
            .alignItems(VerticalAlign.Center)

            Divider()
          }
          .padding({
            left: item.catalogLevel ? item.catalogLevel * 26 : 10,
            right: item.catalogLevel ? item.catalogLevel * 26 : 10,
            top: 6,
            bottom: 6
          })
          .onClick(async () => {
            // 在此实现点击目录跳转到指定章节功能
            this.jumpToCatalogItem(item);
          })
        }
      })
    }
    .scrollBar(BarState.Off)
    .width('100%')
    .height('100%')
  }
  .width('100%')
  .height('100%')
}

获取跳转用的目录位置及资源信息。

private jumpToCatalogItem(catalogItem: bookParser.CatalogItem) {
  let domPos = this.getDomPos(catalogItem);
  let resourceIndex = this.getResourceItemByCatalog(catalogItem).index;
  // 通过domPos及resourceIndex信息，即可通过startPlay接口跳转到指定位置
  hilog.info(0x0000, "testTAG", `jumpToCatalogItem domPos:${domPos}, resourceIndex:${resourceIndex}`);
}

private getDomPos(catalogItem: bookParser.CatalogItem): string {
  try {
    let domPos: string = this.defaultHandler?.getDomPosByCatalogHref(catalogItem.href || '') || '';
    return domPos;
  } catch (error) {
    hilog.error(0x0000, "testTAG", `getDomPos failed, Code: ${error.code}, message: ${error.message}`);
  }
  return '';
}

/**
 * 获取书籍目录对应的资源条目
 *
 * @param catalogItem 目录条目
 */
private getResourceItemByCatalog(catalogItem: bookParser.CatalogItem): bookParser.SpineItem {
  let resourceFile = catalogItem.resourceFile || '';
  try {
    let spineList: bookParser.SpineItem[] = this.defaultHandler?.getSpineList() || []
    // 查找目录对应的资源条目
    let resourceItemArr = spineList.filter(item => item.href === resourceFile);
    if (resourceItemArr.length > 0) {
      hilog.info(0x0000, 'testTag', 'getResourceItemByCatalog get resource ', resourceItemArr[0]);
      let resourceItem = resourceItemArr[0];
      return resourceItem;
    } else if (spineList.length > 0) {
      // 如果查找不到，则默认返回第1个资源条目
      hilog.info(0x0000, 'testTag', 'getResourceItemByCatalog get resource in resourceList', spineList[0]);
      return spineList[0];
    }
  } catch (error) {
    hilog.error(0x0000, "testTAG", `getResourceItemByCatalog failed, Code: ${error.code}, message: ${error.message}`);
  }
  // 如果没有资源条目，则返回默认值
  hilog.info(0x0000, 'testTag', 'getResourceItemByCatalog get resource in escape');
  return {
    idRef: '',
    index: 0,
    href: '',
    properties: ''
  };
}

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问