更新记录

2.0.3(2024-03-16)

修复与其他第三方插件冲突问题

2.0.1(2023-05-25)

兼容Android 9

2.0.0(2023-04-09)

增加视频获取方法getGalleryVideos

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:9.0 - 13.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原生插件配置”->”云端插件“列表中删除该插件重新选择


安卓静默获取相册图片、视频

  • 时间范围图片检索;
  • 创建时间正倒序;
  • 分页限制获取,返回总数;
  • 响应包含名称、创建时间、宽度、高度、大小、图片路径、图片总数、视频时长、当前页码

支持iOS、Android(推荐)

静默获取手机相册图片视频

iOS版独立插件

静默获取相册图片视频

uniapp使用示例 获取图片

var galleryModule = uni.requireNativePlugin("vutet-getGalleryImages-android");
galleryModule.getGalleryImages({
  // [是否正序],非必填,默认按创建时间倒序
  // asc: false,
  // [距现在时间范围], 非必填,单位秒,表示当前时间之前到现在xx秒(负数),场景:获取3天内照片
  // time: -3 * 24 * 60 * 60,
  // [每页条数],默认20条 每页获取的数量
  count: 20,
  // [页码], 非必填默认第一页
  page: 1
}, (ret) => {
  console.log(ret);
  // 无权限时返回 可由uniapp弹窗引导提醒前往应用设置开启相册授权
  // {"status": 401,"data": [],"msg": "暂无权限获取相册图片"}

  // {
  //   status: 200,
  //   data: [{
  //       "filename": "mmexport1678604059025",
  //       "path": "/storage/emulated/0/Pictures/WeiXin/mmexport1678604059025.jpg",
  //       "width": 1440,
  //       "height": 1805,
  //       "size": 287473,
  //       "size": 287473,
  //       "creationDate": "1678604059"
  //   }],
  //   total: 60,
  //   current: 1,
  //   msg: "获取图片成功"
  // }

  if (ret && ret.status === 200 && ret.data.length > 0) {
    uni.previewImage({
      urls: ret.data.map(({ path }) => path)
    });
  }
});

uniapp使用示例 获取视频

var galleryModule = uni.requireNativePlugin("vutet-getGalleryImages-android");
galleryModule.getGalleryVideos({
  // [是否正序],非必填,默认按创建时间倒序
  // asc: false,
  // [距现在时间范围], 非必填,单位秒,表示当前时间之前到现在xx秒(负数),场景:获取3天内视频
  // time: -3 * 24 * 60 * 60,
  // [每页条数],默认20条 每页获取的数量
  count: 20,
  // [页码], 非必填默认第一页
  page: 1
}, (ret) => {
  console.log(ret);
  // 无权限时返回 可由uniapp弹窗引导提醒前往应用设置开启相册授权
  // {"status": 401,"data": [],"msg": "暂无权限获取相册图片"}

  // {
  //   status: 200,
  //   data: [{
  //       "filename": "VID_20230403_180547",
  //       "path": "/storage/emulated/0/Movies/VID_20230403_180547.mp4",
  //       "width": 1280,
  //       "height": 720,
  //       "size": 13110012,
  //       "duration": 38000,
  //       "creationDate": "1680516357"
  //   }],
  //   total: 6,
  //   current: 1,
  //   msg: "获取视频成功"
  // }
});

无权限401 验证权限

var galleryModule = uni.requireNativePlugin("vutet-getGalleryImages-android");
galleryModule.checkPermission((res) => {
  // 未获得权限,会动态申请权限
  // { "status": 401, "msg": "未获得相册读取权限" }

  // 已获得权限
  // { "status": 200, "msg": "已获得相册读取权限" }
});

问题反馈

插件可能存在的问题: 1.Android低版本 2.已上传云服务备份的网络图片 3.QQ群 274472113

隐私、权限声明

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

android.permission.READ_EXTERNAL_STORAGE

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

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

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