更新记录
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:未测试 | × |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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 等各类文档格式,支持静态集成和私有化部署,接入简单,满足您和用户在自己的客户端内安全、流畅地浏览文档的需求,保障数据隐私和浏览体验。
集成步骤
- 拷贝demo示例里的AndroidManifest.xml到项目根目录
- 在腾讯云平台-腾讯浏览服务https://console.cloud.tencent.com/tbs上获取license 大概在下图红色框内有个获取开通免费license的按钮
开通后在调用量包管理这里可以获取license
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页
});