更新记录

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:支持 ×

原生插件通用使用流程:

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


静默获取最新的相册

代码示例

<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插件😉

隐私、权限声明

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

读取文件权限 android.permission.READ_EXTERNAL_STORAGE

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

没有任何采集

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

没有任何广告

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