图片选择器

安装

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`	-	小于`compressSize`kb的图片不压缩	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`	-	小于`compressSize`kb的图片不压缩，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()

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

图片选择器

安装

卸载

引用

启动相册拍照

Files

README.md

Latest commit

History

README.md

File metadata and controls

图片选择器

安装

卸载

引用

启动相册拍照