cordova-plugin-photo-selection

v1.1.7

Published

3 years ago

Cordova photoSelection Plugin

Downloads

0High
0Medium
0Low

chenyutoxiaoling

cordova cordova-ios cordova-android

Use Skills of English Version EnglishVersionDocument

非常感谢南尘和 banchichen 提供的源码支持

本插件 fork 与 giantss

原作者的cordova交流群：273613165

一个支持多选，相册实现了拍照、预览、图片压缩等功能

功能

选择图片
拍照
预览选中的图片
图片压缩

安装要求

Cordova Version >= 6.0.0
Cordova-Android >= 6.0.0
Cordova-iOS >= 4.0.0

安装

cordova plugin add cordova-plugin-photo-selection

或者

  cordova plugin add https://github.com/waliu/cordova-plugin-photo-selection

注意：Android build ，见 android注意事项。

Android 视频演示

点击查看视频(优酷)

iOS 视频演示

点击查看视频(优酷)

效果图

| Android | iOS | |:---------------:|:------------:| | | |

使用方式

一个粗糙的 cordova demo

ImagePicker.getPictures(function(result) {
    alert(JSON.stringify(result));
}, function(err) {
    alert(err);
}, {
    maximumImagesCount : 9,
    width : 1920,
    height : 1440,
    quality : 100
});

返回结果如下

{
    "images": [{
        "path": "/data/user/0/com.pushsoft.im2/cache/ImagePicker/152783817455118.jpg",
        "width": 720,
        "height": 1280,
        "size": 104871 // 文件体积(单位：字节)
    }, {
        "path": "/data/user/0/com.pushsoft.im2/cache/ImagePicker/152783817464525.jpg",
        "width": 720,
        "height": 1280,
        "size": 109873
    }],
    "isOrigin": false // 是否原图
}

ionic2、ionic3 中使用本插件：

  (<any>window).ImagePicker.getPictures((result) => {
      alert(JSON.stringify(result));
    }, (err) => {
      alert(err);
    }, {
      maximumImagesCount: 9,
      width: 1920,
      height: 1440,
      quality: 100
    });

参数含义

注意：

参数都是可选的，不传则使用默认值；
如果 width > 0 且 height > 0：Android 下压缩的图可能比原图大或者压缩率不高（比如原图4MB，压缩后也有2MB），可以 quality 设置低一些，比如 50；iOS 下会忽略 quality 参数；
如果 width < 0 或 height < 0：那么插件返回压缩图，压缩逻辑接近于微信，自动选取合适的分辨率和压缩品质，推荐使用这种方式。压缩库使用的是 Luban 和 Luban-iOS。如果遇到压缩不清晰等问题，请到他们的项目上提 issues；
运行时，选图界面上有“原图”单选按钮，选上之后，返回的图片是未压缩的原图

android注意事项

先移除安装过的旧版插件

如果 build 报下面的错

error: resource android:attr/dialogCornerRadius not found
error: resource android:attr/fontVariationSettings not found
error: resource android:attr/ttcIndex not found

请使用 cordova-android-support-gradle-release 这个插件统一项目中的 Android Support 库版本：

$ cordova plugin add cordova-android-support-gradle-release  --variable ANDROID_SUPPORT_VERSION={required version}

其中{required version} 值为类似 25.+，26.+，27.+ 这种。

如果你用的是低版本 Cordova 和 Gradle，会报错不支持implementation Cordova 7.1.0 及以下版本（对应[email protected]及以下版本），请将 cordova-plugin-ImagePicker\src\android\imagepicker.gradle 里面的 implementation 修改为 compile，因为低版本的 Cordova-Android 使用的是低版本的 Gradle, 不支持 implementation。
如果还是 build 不成功
```
$ cordova platform rm android
```
或
```
$ cordova platform rm ios
```
移除旧的平台，然后重新 add

参考项目

多选图片项目

nanchen2251/ImagePicker (Android)
- jeasonlzy/ImagePicker
banchichen/TZImagePickerController (iOS)

图片压缩库

更新说明

v1.1.6

(Android)移除 picasso 引用和相关实现逻辑代码

v1.1.5

(iOS)取消选图支持回调函数

v1.1.4

返回值增加图片宽高和文件体积
(iOS)修复ios压缩某些图片模糊的问题

v1.1.3

(Android)修复低版本 Cordova-Android 和 Gradle 的情况下, build 出现 diamond 运算符异常的问题
(Android)增加 takePhoto 方法，直接进入拍照
(Android)增加失败回调，取消选图时会触发该回调

v1.1.2

(Android)修复部分手机图片预览页返回时，图片墙的小图全没了

v1.1.1

(Android)适配 Cordova@8、Cordova-Android@7
(Android)provider_paths.xml 改名，FileProvider 改名，不会与其他插件冲突，也不需要手动复制到 cordova/platform/android/res/xml/ 下
(Android)去除 styles.xml，改成在代码中设置样式，避免与其它插件也有这个同名的文件导致冲突
(Android)Glide 图片库更新到最新，支持 Gif，性能大幅提升，应该没有图片墙显示不出预览图的问题了
(Android)图片墙底栏上增加“原图”单选按钮
(iOS)修正 iOS 勾选原图是，返回的图不是原图，以及压缩图比原图大的问题
maximumImagesCount、width、height 等参数可选传递
如果 width < 0 且 height < 0，则自动选取合适的分辨率和压缩比进行压缩，接近于微信的压缩逻辑
修改成功回调的返回参数，原来返回图片路径数组 ['xxx', 'yyy']，现在是 { images: ['xxx', 'yyy'], isOrigin: true/false }

License

The MIT License (MIT)