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