更新记录
1.3.1(2023-03-27)
1、更新包名
1.3.0(2023-02-27)
1、getImageFileList方法返回总数据count
2、getVideoFileList方法返回总数据count
1.2.1(2023-01-18)
更新uniapp离线sdk:2023年01月12日发布——HBuilderX(3.6.17.20230112)
查看更多平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:5.0 - 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原生插件配置”->”云端插件“列表中删除该插件重新选择
静默获取最新的相册
代码示例
<template>
<view>
//请使用 `https://ext.dcloud.net.cn/plugin?id=594` uniapp官方封装的权限判断插件进行业务逻辑
<button type="default" @click="checkAuth">是否有文件读取权限</button>
<button type="default" @click="getImageFileList">读取照片文件列表</button>
<button type="default" @click="getVideoFileList">读取视频文件列表</button>
</view>
</template>
<script>
...此处省略的部分代码
const FilesModule = uni.requireNativePlugin('lu-FilesModule');
//请使用 `https://ext.dcloud.net.cn/plugin?id=594` uniapp官方封装的权限判断插件进行业务逻辑
checkAuth() {
});
},
//读取照片列表
getImageFileList() {
let params = {
page: 1,
limit: 20
}
FilesModule.getImageFileList(params, (res) => {
//res格式 {code: 200, msg: "提示内容", "count": 1, list: [{path:"图片绝对路径", pkg: "图片的创作者包名", date: "创建时间(时间戳)"}, ...]} 开发者可自行打印
if (res.code === 200) {
console.log(res);
this.msg = JSON.stringify(res);
} else {
//获取文件列表错误
uni.showToast({
title: '错误:' + res.msg,
icon: 'none'
});
}
});
},
//读取视频文件列表
getVideoFileList() {
let params = {
page: 1,
limit: 20
}
FilesModule.getVideoFileList(params, (res) => {
//res格式 {code: 200, msg: "提示内容", "count": 1, list: [{path:"图片绝对路径", pkg: "图片的创作者包名", date: "创建时间(时间戳)"}, ...]} 开发者可自行打印
if (res.code === 200) {
console.log(res);
this.msg = JSON.stringify(res);
} else {
//获取文件列表错误
uni.showToast({
title: '错误:' + res.msg,
icon: 'none'
});
}
});
},
</script>
返回参数说明
方法名 | 返回值 | 说明 |
---|---|---|
检查权限 | 检查权限 | 请使用 https://ext.dcloud.net.cn/plugin?id=594 uniapp官方封装的权限判断插件进行业务逻辑 |
getImageFileList | object | {code: 200, msg: "提示内容", count: 1, list: [{path:"图片绝对路径", pkg: "图片的创作者包名(比如相机、qq保存的图片、微信保存的)", date: "创建时间(时间戳)"}, ...]} 判断code 是否为200 判断是否获取成功 如果code=400,没有data属性 |
getVideoFileList | object | {code: 200, msg: "提示内容",count: 1, list: [{path:"视频绝对路径", pkg: "视频的创作者包名", date: "创建时间(时间戳)"}, ...]} |
其他说明
插件只需要 “读文件权限”
getImageFileList、getVideoFileList方法参数说明如果code===200, 才会返回list属性
如果您的手机是安卓10及以上版本,getImageFileList/getVideoFileList方法会返回pkg字段,如果是以下版本不会返回该字段(因为这个特性是10版本才开始有的)
QQ交流群:263173204
备注uni插件😉