更新记录

1.0.0(2023-03-09)

腾讯浏览服务(Tencent Browsing Service,TBS)的文档浏览引擎提供稳定、安全、高兼容性的本地文档浏览服务,接入后可在客户端内直接打开浏览 word、excel、ppt、pdf、txt 及 dwg、chm 等各类文档格式,支持静态集成和私有化部署,接入简单,满足您和用户在自己的客户端内安全、流畅地浏览文档的需求,保障数据隐私和浏览体验。


平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 12.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 ×

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


前言

腾讯浏览服务

腾讯浏览服务(Tencent Browsing Service,TBS)的文档浏览引擎提供稳定、安全、高兼容性的本地文档浏览服务,接入后可在客户端内直接打开浏览 word、excel、ppt、pdf、txt 及 dwg、chm 等各类文档格式,支持静态集成和私有化部署,接入简单,满足您和用户在自己的客户端内安全、流畅地浏览文档的需求,保障数据隐私和浏览体验。

集成步骤

  1. 拷贝demo示例里的AndroidManifest.xml到项目根目录
  2. 在腾讯云平台-腾讯浏览服务https://console.cloud.tencent.com/tbs上获取license 大概在下图红色框内有个获取开通免费license的按钮

image.png 开通后在调用量包管理这里可以获取license image.png


var tbsFileSDK = uni.requireNativePlugin("wrs-tbsFileSDK");

方法

  • LicenseKey 初始化接口

tbsFileSDK.setLicenseKey({
                license: "oT8D3FpQJr3mY+nWhahC7x2ATgPY06UobTJUROqHtnXe1S1W/7nAEys08+nL3j3S"
            });
  • SDK 初始化接口

异步初始化


            tbsFileSDK.initEngineAsync((resp) => {
                console.log("initEngineAsync:" + JSON.stringify(resp));
                var actionType = resp.actionType;
                if(actionType == 7002) {
                    var args = resp.args;
                    if(args == 0) {
                        console.log("初始化成功");
                    } else {
                        console.log("初始化失败");
                    }
                }
            });

同步初始化


tbsFileSDK.initEngine();
  • 支持格式判断接口

var params = {};
params.fileExt = "docx";
tbsFileSDK.canOpenFileExt(params, (resp)=>{
    var canOpen = resp.canOpen;
});
  • 打开文档接口

var params = {};
params.filePath = "/saf/asdf/test.docx", // 文件路径
params.fileExt = "docx"; // 文件后缀名
params.tempPath = "/saf/asdf"; // 文件临时目录路径(文件打开过程中缓存目录,包括记录上次文档打开位置等,打开文档结束后不会自动删除,如有需要可自行删除)**
// params.file_reader_enable_long_press_menu = true; // 开启长按菜单复制功能、支持 PDF、DOCX、XLSX 和 TXT
// params.file_reader_is_ppt_page_mode_default = true; // 设置 PPT 打开为翻页模式
// params.file_reader_top_bar_bg_color = "#ffffff"; // 设置顶 bar 的颜色
// params.file_reader_top_bar_hight = 50; // 设置顶 bar 的高度
tbsFileSDK.openFileReader(params, (resp)=>{

});
  • 关闭文档接口

tbsFileSDK.closeFileReader();
  • 页面跳转接口

滑动模式(默认模式)


tbsFileSDK.gotoPosition({
    progress: 3 // 跳转到第4页
});

翻页模式(仅 PPT/PPTX 支持)


tbsFileSDK.gotoPosition({
    page: 3 // 跳转到第4页
});

如果觉得可以就点个👍吧,欢迎粉丝收藏,土豪打赏,您的关注就是我们创作的动力!

隐私、权限声明

1. 本插件需要申请的系统权限列表:

<uses-permission android:name="android.permission.INTERNET"></uses-permission> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件使用的 腾讯浏览服务 SDK会采集数据,详情可参考:https://console.cloud.tencent.com/tbs

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问