epub

来自于：AC模块工作室立即使用

open addEventListener removeEventListener setValue getChapters openChapter getBrightness setBrightness resetWithProgress getAllbooks deleteBookWithBook setNightMode close

概述

本模块实现阅读epub格式电子书功能，可以将阅读书籍存入本地，具有记录阅读位置和阅读器相关设置的功能。可以设置夜间阅读模式，也可以根据进度跳转对应章节。

open

打开阅读器

open({params}, callback(ret, err))

params

path：

  • 类型：字符串
  • 描述：epub文件路径，支持fs,widget

bookId：

  • 类型：字符串
  • 描述：文件存入本地的唯一标识，不同文件标识应为唯一，不同文件不可重复传入

currentChapter：

  • 类型：数字
  • 描述：（可选项）打开书籍的章节数
  • 默认值：第一次打开电子书默认值为 1，第二次及以后默认值为上一次打开的章节

bg：

  • 类型：字符串
  • 描述：（可选项）阅读器的背景，支持颜色（rgb，rgba，#）和图片（支持fs,widget）
  • 默认值：第一次打开阅读器默认值为 #fff，第二次及以后默认值为上一次打设置的背景，

textColor：

  • 类型：字符串
  • 描述：（可选项）阅读器显示文字颜色
  • 默认值：第一次打开阅读器默认值为 #000，第二次及以后默认值为上一次设置的文字颜色

textSize：

  • 类型：数字
  • 描述：（可选项）阅读器显示文字字体大小
  • 默认值：第一次打开阅读器默认值为 12，第二次及以后默认值为上一次打设置的文字字体大小

callback(ret)

ret:

  • 类型：JSON对象
  • 描述：点击的事件类型；
  • 内部字段：
  1. {
  2.     currentChapter:'',        //字符串类型，当前章节
  3.     currentChapterTitle:'',   //字符串类型，当前章节标题
  4.     progress:'',              //字符串类型，当前进度（1-100），可为小数
  6. }

示例代码

  1. var epub = api.require('epub');
  2. epub.open({
  3.     bookId:'123',
  4.     path: 'fs://test.epub'
  5. }, function(ret) {
  6.      alert(JSON.stringify(ret));
  7. });

可用性

iOS系统

可提供的1.0.0及更高版本

addEventListener

添加监听

addEventListener(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.        eventType : 'gestureTap',  //字符串类型；事件类型
  3.        // 取值范围：
  4.        //gestureTap : 点击阅读器事件（单击手势）点击阅读器 上下左右角会进行翻页操作，不会监听到该事件
  5.        //gestureDoubleTap : 双击阅读器事件（双击手势）
  7. }

示例代码

  1. var epub = api.require('epub');
  2. epub.addEventListener(function(ret, err) {
  3.      alert(JSON.stringify(ret));
  4. });

可用性

iOS系统

可提供的1.0.0及更高版本

removeEventListener

移除添加监听

removeEventListener()

示例代码

  1. var epub = api.require('epub');
  2. epub.removeEventListener();

可用性

iOS系统

可提供的1.0.0及更高版本

setValue

设置阅读器的参数

setValue({params})

params

bg：

  • 类型：字符串
  • 描述：（可选项）阅读器的背景色，支持颜色（rgb，rgba，#）和图片（支持fs,widget）
  • 默认值：当前背景色

currentChapter：

  • 类型：数字
  • 描述：（可选项）打开的章节数
  • 默认值：当前章节

textColor：

  • 类型：字符串
  • 描述：（可选项）文字颜色
  • 默认值：当前文字颜色

textSize：

  • 类型：数字
  • 描述：（可选项）文字字体大小。重新设置字体大小后，会重新分页，触发分页的事件
  • 默认值：当前字体大小

示例代码

  1. var epub = api.require('epub');
  2. epub.setValue({
  3.     bg: '#000',
  4.     textColor: '#fff',
  5.     textSize: 15
  6. });

可用性

iOS系统

可提供的1.0.0及更高版本

getChapter

获取章节列表

getChapters(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：获取的章节列表；
  • 内部字段：
  1. {
  2.     chapters:[{            //JSON对象数组
  3.         title:''           //章节标题，字符串类型
  4.         playOrder:''       //章节序列号，数字类型
  5.     }]
  6. }

示例代码

  1. var epub = api.require('epub');
  2. epub.getChapters(function(ret, err) {
  3.     if (ret) {
  4.         alert(JSON.stringify(ret));
  5.     } 
  6. });

可用性

iOS系统

可提供的1.0.0及更高版本

openChapter

打开指定章节

openChapter({params})

params

currentChapter：

  • 类型：数字
  • 描述：（可选项）打开的章节数

示例代码

  1. var epub = api.require('epub');
  2. epub.openChapter({
  3.    currentChapter:6
  4. });

可用性

iOS系统

可提供的1.0.0及更高版本

getBrightness

获取当前屏幕亮度值

getBrightness(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
  1. {
  2.     brightness:            //数字类型；当前屏幕亮度值
  3. }

示例代码

  1. var epub = api.require('epub');
  2. epub.getBrightness(function(ret, err) {
  3.     if (ret) {
  4.         alert(JSON.stringify(ret));
  5.     } 
  6. });

可用性

iOS系统

可提供的1.0.0及更高版本

setBrightness

设置屏幕亮度

setBrightness({params})

params

brightness：

  • 类型：数字
  • 描述：设置的屏幕的亮度，取值范围：0-100，在 iOS 平台上设置的是系统屏幕亮度。Android 平台上设置的本应用内的屏幕亮度
  • 默认值：当前屏幕亮度

示例代码

  1. var epub = api.require('epub');
  2. epub.setBrightness({
  3.     brightness: 50
  4. });

可用性

iOS系统

可提供的1.0.0及更高版本

resetWithProgress

根据进度跳转对应章节

resetWithProgress({params})

params

progress：

  • 类型：数字
  • 描述：进度值（0-100），可为小数

示例代码

  1. var epub = api.require('epub');
  2. epub.resetWithProgress({
  3.   progress:10.5
  4. });

可用性

iOS系统

可提供的1.0.0及更高版本

getAllbooks

获取全部本地书籍

getAllbooks(callback(ret))

callback(ret)

ret：

  • 类型：JSON对象
  • 描述：获取的书籍文件列表；
  • 内部字段：
  1. {
  2.     allBook:[{            
  3.         bookName:'',           //书籍名称
  4.         currentChapter:'',    //阅读到的章节
  5.         bookId:'',          //唯一标识符
  6.     }]
  7. }

示例代码

  1. var epub = api.require('epub');
  2. epub.getAllbooks(function(ret, err) {
  3.     if (ret) {
  4.         alert(JSON.stringify(ret));
  5.     } 
  6. });

可用性

iOS系统

可提供的1.0.0及更高版本

deleteBookWithBook

删除一本书籍

deleteBookWithBook({params})

params

bookId：

  • 类型：字符
  • 描述：书记唯一标识符

示例代码

  1. var epub = api.require('epub');
  2. epub.deleteBookWithBook({
  3.   bookId:'111'
  4. });

可用性

iOS系统

可提供的1.0.0及更高版本

setNightMode

设置夜间模式

setNightMode({params})

params

isNightMode：

  • 类型：布尔
  • 描述：是否开启夜间模式
  • 默认：true

示例代码

  1. var epub = api.require('epub');
  2. epub.setNightMode({
  3.    isNightMode:true
  4. });

可用性

iOS系统

可提供的1.0.0及更高版本

close

关闭阅读器

close()

示例代码

  1. var epub = api.require('epub');
  2. epub.close();

可用性

iOS系统

可提供的1.0.0及更高版本