图片选择器

安装

eeui plugin install https://github.com/aipaw/eeui-plugin-picture

卸载

eeui plugin uninstall https://github.com/aipaw/eeui-plugin-picture

引用

const picture = app.requireModule("eeui/picture");

启动相册拍照

picture.create 启动相册或启动拍照

/**
 * @param params    详细参数
 * @param callback  回调事件
 */
picture.create({params}, callback(result))

params 参数说明

以下参数不要被表面吓到，用不到的可以不写（简单使用基本不用）

属性名	类型	必须	描述	默认值
type	String	-	类型: gallery:启动相册并拍照 camera:单独启动拍照或视频	gallery
gallery	Number	-	内容：0全部、1图片、2视频、3音频	0
maxNum	Number	-	最大选择数量	9
minNum	Number	-	最小选择数量	0
selected	[{Object}]	-	已选图片，一般传入回调的result.lists数据	-
spanCount	Number	-	每行显示个数	4
mode	Number	-	模式：1单选、2多选	2
previewImage	Boolean	-	是否可预览图片	true
previewVideo	Boolean	-	是否可预览视频	true
previewAudio	Boolean	-	是否可预览音频	true
camera	Boolean	-	是否显示拍照按钮	true
format	String	-	拍照保存图片格式:.JPEG或.png	.JPEG
zoomAnim	Boolean	-	图片列表点击 缩放效果	true
multiplier	Float	-	Glide加载图片大小0~1之间  如设置overrideWidth、overrideHeight无效	0.5
crop	Boolean	-	是否启用裁剪	false
compress	Boolean	-	是否启用压缩	false
overrideWidth	Number	-	glide 加载宽，越小图片列表越流畅	100
overrideHeight	Number	-	glide 加载高，越小图片列表越流畅	100
ratioX	Number	-	裁剪比例	1
ratioY	Number	-	裁剪比例	1
cropControls	Boolean	-	是否显示uCrop工具栏	false
gif	Boolean	-	是否显示gif图片	false
freeCrop	Boolean	-	裁剪框是否可拖拽	false
circle	Boolean	-	是否圆形裁剪	false
cropFrame	Boolean	-	是否显示裁剪矩形边框 圆形裁剪时建议设为false	true
cropGrid	Boolean	-	是否显示裁剪矩形网格 圆形裁剪时建议设为false	true
clickSound	Boolean	-	是否开启点击声音	false
eggs	Boolean	-	预览图片时 是否增强左右滑动图片体验	false
quality	Number	-	裁剪压缩质量	90
compressSize	Number	-	小于compressSizekb的图片不压缩	100
sync	Boolean	-	同步true或异步false 压缩	true
cropWidth	Number	-	裁剪宽高比，设置如果大于图片本身宽高则无效	0
cropHeight	Number	-	裁剪宽高比，设置如果大于图片本身宽高则无效	0
rotate	Boolean	-	裁剪是否可旋转图片	true
scale	Boolean	-	裁剪是否可放大缩小图片	true
videoQuality	Number	-	视频录制质量: 0或1	0
videoMaxSecond	Number	-	显示多少秒以内的视频or音频也可适用	15
videoMinSecond	Number	-	显示多少秒以内的视频or音频也可适用	10
recordVideoSecond	Number	-	视频录制秒数	60

callback 回调result说明

{
    pageName: '页面名称',
    status: 'create',   //状态，详见：注①

    //status=success
    lists: [{
        path:'...',         //为原图path
        cutPath:'...',      //为裁剪后path，需判断isCut是否为true
        compressPath:'...', //为压缩后path，需判断compressed是否为true
        // 如果裁剪并压缩了，以取压缩路径为准，因为是先裁剪后压缩的

        isCut: true,                //是否裁剪
        isCompressed: true,         //是否压缩
        mimeType: "image/png",      //mime类型
    },
    ......
    ]
}

注①：

• create页面创建完毕

• destroy页面已销毁

• success成功返回

简单示例

//示例①：启动相册并拍照  
picture.create({
    gallery: 1
}, function(result) {
    //......
});

//示例②：单独启动拍照或视频 根据mimeType自动识别
picture.create({
    gallery: 1,
    type: 'camera'
}, function(result) {
    //......
});

压缩图片

picture.compressImage 压缩图片列表

/**
 * @param params    详细参数
 * @param callback  回调事件
 */
picture.compressImage({params}, callback(result))

params 参数说明

属性名	类型	必须	描述	默认值
compressSize	Number	-	小于compressSizekb的图片不压缩，1-100	90
lists	[{Object}]	-	已选图片，一般传入回调的result.lists数据	-

callback 回调result说明

{
    status: 'success',   //状态，详见：注②

    lists: [{
        path:'...',         //为原图path
        compressPath:'...', //为压缩后path，需判断compressed是否为true
        isCompressed: true,         //是否压缩
    },
    ......
    ]
}

注②：

• success压缩成功返回

• error压缩失败返回

压缩图片例子

picture.compressImage({
    compressSize: 90,
    lists: [
        {path: "图片1地址"},
        {path: "图片2地址"},
    ]
}, function(result) {
    //
})

预览图片

picture.picturePreview 预览图片

/**
 * @param position  焦点位置，从0开始
 * @param path      图片path组
 * @param callback  预览右上角删除选择事件，留空则关闭删除功能
 */
picture.picturePreview(position, [path], callback(result))

callback 回调result说明

{
    position: 1,        //删除所在的位置，从0开始
}

预览图片例子

picture.picturePreview(0, [
        {path: "图片1地址"},
        {path: "图片2地址"},
    ], function(result) {
    //
})

预览视频

picture.videoPreview预览视频

/**
 * @param path      视频地址
 */
picture.videoPreview(path)

缓存清除

picture.deleteCache 缓存清除，包括裁剪和压缩后的缓存，要在上传成功后调用，注意：需要系统sd卡权限。

picture.deleteCache()

预览效果