nedev-cordova-plugin-imagepicker
v1.2.0
Published
Cordova ImagePicker Plugin
Downloads
2
Maintainers
Readme
cordova-plugin-ImagePicker
非常感谢南尘和 banchichen 提供的源码支持 多点star✨开源不容易,谢谢。扣扣群:273613165
一个支持多选,相册实现了拍照、预览、图片压缩等功能
功能
- 相册目录
- 多选图
- 相册内部拍照
- 预览选中的图片
- 图片压缩
安装要求
- Cordova Version >= 6.0.0
- Cordova-Android >= 6.0.0
- Cordova-iOS >= 4.0.0
安装
cordova plugin add https://github.com/giantss/cordova-plugin-ImagePicker.git
注意:Android 项目先不要直接 build ,见 android注意事项。
Android 视频演示
iOS 视频演示
效果图
| Android | iOS | |:---------------:|:------------:| | | |
使用方式
// 选图
ImagePicker.getPictures(function(result) {
alert(JSON.stringify(result));
}, function(err) {
alert(err);
}, {
maximumImagesCount : 9,
width : 1920,
height : 1440,
quality : 100
});
// 拍照
ImagePicker.takePhoto(function(result) {
alert(JSON.stringify(result));
}, function(err) {
alert(err);
}, {
width : 1920,
height : 1440,
quality : 50
});
返回结果如下:
// 如果是拍照,images 数组中只有一个对象
{
"images": [{
"path": "/data/user/0/com.pushsoft.im2/cache/ImagePicker/152783817455118.jpg",
"uri": "file:///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",
"uri": "file:///data/user/0/com.pushsoft.im2/cache/ImagePicker/152783817464525.jpg",
"width": 720,
"height": 1280,
"size": 109873
}],
"isOrigin": false // 是否原图
}
ionic 中使用本插件,需要声明: declare let ImagePicker:any
参数含义
| 配置参数 | 参数含义 | |:------------------:|:-------------------------:| | maximumImagesCount | 多选限制数量,默认为9 | | width | 设置输出图片的width,默认为自动 | | height | 设置输出图片的height,默认为自动 | | quality | 图片质量 默认80 | | enablePickOriginal | 允许选择原图 默认true |
注意:
- 参数都是可选的,不传则使用默认值;
- 如果 width > 0 且 height > 0:压缩的图可能比原图大或者压缩率不高(比如原图4MB,压缩后也有2MB),可以 quality 设置低一些,比如 50;
- 如果 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}
值为类似26.+
,27.+
,28.+
这种。如果你用的是 低版本 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
参考项目
多选图片项目
- jeasonlzy/ImagePicker (Android)
- banchichen/TZImagePickerController (iOS)
图片压缩库
- nanchen2251/CompressHelper (Android)
- Curzibn/Luban (Android)
- GuoZhiQiang/Luban_iOS (iOS)
更新说明
v1.1.9
- (iOS)增加
takePhoto
方法,直接进入拍照
v1.1.8
- (iOS)Luban 压缩逻辑 fix
v1.1.7
- 更新到最新的第三方图片选择库
- 增加 enablePickOriginal 配置项(允许选择原图,即是否显示原图勾选框)
- (iOS)支持 HEIC 图片格式
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 }