更新记录
0.1.0(2021-01-22) 下载此版本
支持动、静态文档转换 文件无损还原 超低门槛点播 文件加载速度快
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:8.0 - 11.0 | armeabi-v7a:支持,arm64-v8a:支持,x86:未测试 | 适用版本区间:9 - 14 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在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原生插件配置”->”云端插件“列表中删除该插件重新选择
ZegoExpressUniAppSDK
即构文件共享服务(ZegoDocs),提供文件处理相关功能。可将常见文件格式转码为向量、PNG、PDF、HTML5 页面等便于跨平台点播的目标格式,常用于在线教育课件共享、视频会议材料共享、网盘文档预览、邮箱附件预览等场景
了解更多解决方案:https://www.zego.im
使用方法
申请 ZEGO AppID
登录 ZEGO 官网 注册账号,根据自身实际业务需求选择场景,获取 AppID 与 AppSign,用于初始化 SDK。
创建uniapp项目
使用uniapp官方IDE HBuilder,创建uni-app类型的项目
获取「ZegoDocsView」uniapp SDK,并引入工程
在uniaapp市场获取本插件,并将插件引入工程
下载「js封装层」代码,并引入工程
下载地址
http://zego-public.oss-cn-shanghai.aliyuncs.com/edu/docsview/zego-doc-uniapp.zip
将以上「js封装层」引入到uniapp项目中
基础使用
初始化 SDK
import ZegoDocsViewManager from '../../zego-doc-uniapp/ZegoDocsViewManager';
ZegoDocsViewManager.getInstance().init(this.config, (ret) => {
if (ret == 0) {
//初始化文件成功
this.showMyDocsView = true;
} else {
//初始化文件失败
}
});
上传文件
//注意需要通过其他插件获取文件的路径 参考: https://ext.dcloud.net.cn/search?q=%E6%96%87%E4%BB%B6%E9%80%89%E6%8B%A9
var filaPath = "filePath";
ZegoDocsViewManager.getInstance().uploadFile(filaPath,1,(result) => {
//state(1:上传中 2:格式转换成功)
var state = result['state'];
//errorCode(0:成功 其他:错误)
var errorCode = result['errorCode'];
if (result['errorCode'] == 0) {
if (result['state'] == 2) {
this.appendInfo('成功');
//获取上传成功后的文件 fileID
var uploadedFileID = result['info']['upload_fileid'];
this.loadFile(uploadedFileID);
} else {
//上传进度(百分比)
var upload_percent = result['info']['upload_percent'];
}
} else {
//上传失败
}
});
加载文件并展示
<zego-docs-view ref='mydocsview' style="width:750rpx;height:750rpx"></zego-docs-view>
// fileID 可通过 uploadFile 接口上传文件后获取得到
var fileID = "";
this.$refs.mydocsview.loadFile(fileID,"",(result) => {
if (result['errorCode'] == 0) {
//加载文件成功');
}
});
跳转到某一页的某一步
var targetPage = 2;
var targetStep = 1;
// 跳到第${targetPage}页,第${targetStep}步
this.$refs.mydocsview.flip(targetPage,targetStep,(result) => {
if (result['isScrollSuccess'] == true) {
//跳转成功;
}
});
下一步
针对于动态 PPT 类型的文件(PPT中带有动画内容),我们提供上下步的功能
当用户用手指点击文件区域时,产生的效果相当于调用了一次 nextStep
接口跳到下一步
this.$refs.mydocsview.nextStep((result) => {
if (result['isScrollSuccess'] == true) {
this.appendInfo('下一步成功');
}
});
更多功能
1、参考 Demo
2、参考ZegoExpressEngine 原生 Android 版使用文档 https://doc-zh.zego.im/zh/4399.html
Demo 使用
Demo 下载地址
- 将Demo导入HBuilderX,修改manifest.json下的AppID(uniapp的AppID)
- 修改Demo下./KeyCenter.js 内的AppID、AppSign (从ZEGO官网获取的)
- 导入「ZegoDocsView」uniapp SDK
- 使用uniapp本地打包/云打包,制定自定义基座
- 运行