更新记录

1.2.1（2023-10-13）

1. 支持 PDF、DOCX、PPTX 跳转到指定页面

1.2.0（2023-10-08）

1. 新增图片类型支持: jpg、jpeg、png、bmp、wbmp、gif
2. 新增音频类型支持: mp3
3. 新增视频类型:支持 mp4、avi、3gp
4. 新增支持打开在线文件
5. 新增关闭页面回调

1.1.0（2023-07-19）

1、支持定义显示文件名称 2、支持显示自定义水印

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

HL-FileReader（办公文档阅读插件）特点

最大特点：

• 稳定！稳定！稳定！不存在TBS那种加载内核失败的场景
• 稳定！稳定！稳定！不存在TBS那种加载内核失败的场景
• 稳定！稳定！稳定！不存在TBS那种加载内核失败的场景

PS:插件市场有其他插件支持离线文件阅读的，目前均盗版本项目！！！插件后续会采用安全鉴权，对于盗版后的插件后续他们将无法更新维护。

其他特点

1. 超强办公文档阅读插件、支持应用内打开常见文档
2. 不需要网络加载任何插件、内网环境依旧能打开文档
3. 稳定性高、集成简单、长期维护
4. 购买后其他文件需求，通用的免费开发

HL文件阅读插件,支持打开近50种类型文件。具体如下：

1. office文档: doc,dot,wps,wpt,docx,dotx,docm,dotm,rtf,xls,xlt,et,ett,xlsx,xltx,csv,xlsb,xlsm,ppt,pptx,dps,pot,pps,dpt,potx,ppsx,pptm,potm,ppsm,txt,properties,log,Log,ini,lua,conf,m,cpp,java,h,xml,html,htm...
2. 图片类型: jpg、jpeg、png、bmp、wbmp、gif
3. 音频类型: mp3
4. 视频类型: mp4、avi、3gp
5. 支持打开在线文件
6. 支持自定义文档水印
7. 支持自定义文件标题名称
8. 支持 PDF、DOCX、PPTX 跳转到指定页面

待支持类型（规划中，暂不支持）

1. 压缩文件: zip、7z、rar（暂未支持，有需要联系我）
2. iOS版本支持

扫码下载体验Demo

二维码更新时间：2023年10月8日

代码演示

< script >
    // 获取 module 
    var HL_FileReader = uni.requireNativePlugin("HL-FileReader");

   //测试文件地址：var filePath = storage/emulated/0/Android/data/com.harlan.reader.demo/files/docs/TestOfficeFile.doc
   //1、打开文件，不开启防止截屏
      HL_FileReader.openFile(filePath, {})
    //2、打开文件，开启防止截屏
      HL_FileReader.openFile(filePath, {
         'isDisableScreen': true
      })
    //3、打开文件，关闭后删除源文件
      HL_FileReader.openFile(filePath + fileName, {
         'isDisableScreen': false, //是否开启禁止截屏，默认false，非必传
         'isDeleteFile': true, //退出是否删除源文件，默认false，非必传
      })
    //4、打开在线文件
      HL_FileReader.openFile("https://img-cdn-aliyun.dcloud.net.cn/stream/plugin_screens/cfe866a0-b6b0-11ed-b9ec-cfa2bafb7d0c_1.jpg?image_process=quality,q_70&v=1689565798", {
         showName: '自定义显示文件名称.test',
         requestOnlineFileConfig: { //仅对打开在线文件生效
            downloadTitle: '下载文件', //下载文件对话框标题（非必选）
            downloadMsg: '请稍等...', //下载文件对话框内容（非必选）
            addRequestHeaders: { //添加下载请求头（非必选）
                'Token': 'i am Token',
                'user': 'usename'
               }
         }
      })
    //5、打开文件、全字段示例              
     HL_FileReader.openFile(filePath + fileName, {
         showName: '自定义显示文件名称.test', //自定义显示文件显示名称，非必传
         isDisableScreen: false, //是否开启禁止截屏，默认false，非必传
         isDeleteFile: true, //退出是否删除源文件，默认false，非必传
         watermark: {
             showText: 'HL文件阅读@测试水印\n2023年7月17日', //水印文档“\n”为换行（如果需要自定义水印、则必选）
             textSize: 12.0, //水印字体大小，单位为sp（非必选、默认12）
             textDegree: 30.0, //水印旋转角度，-90到90（非必选、默认30）
             textTransparent: 60.0, //水印透明度，0-100（非必选、默认40）
             textColor: '#b8b7b7', //水印文字颜色颜色值（非必选、默认#b8b7b7）
             spacingX: 30, //水印横向间隔（非必选、默认30dp）
             spacingY: 60, //水印竖向间隔（非必选、默认80dp）
         },
         requestOnlineFileConfig: { //仅对打开在线文件生效
             downloadTitle: '下载文件', //下载文件对话框标题（非必选）
             downloadMsg: '请稍等...', //下载文件对话框内容（非必选）
             isDownloadFrist: false, //是否首先下载文件，仅支持适配和音频格式表示边下边播放（非必选，默认false）
             addRequestHeaders: { //添加下载请求头（非必选）
                 'Token': 'i am Token',
                 'user': 'usename'
             }
         },result => {//打开文件回调（可选）
                    // this.textvalue = result;
        }, closeResult => {//关闭页面回调（可选）
            modal.toast({
                        message: "关闭页面："+closeResult,
                        duration: 1.5
                    });
      }) 
< /script>