团队博客
今天经提议翻了一些有关PictureSelector的博客,试着做了些记录敲了些代码。
PS Api功能汇总:
PictureSelector.create(this) .openGallery()//相册 媒体类型 PictureMimeType.ofAll()、ofImage()、ofVideo()、ofAudio() //.openCamera()//单独使用相机 媒体类型 PictureMimeType.ofImage()、ofVideo() .theme()// xml样式配制 R.style.picture_default_style、picture_WeChat_style or 更多参考Demo .loadImageEngine()// 图片加载引擎 需要 implements ImageEngine接口 .selectionMode()//单选or多选 PictureConfig.SINGLE PictureConfig.MULTIPLE .isPageStrategy()//开启分页模式,默认开启另提供两个参数;pageSize每页总数;isFilterInvalidFile是否过滤损坏图片 .isSingleDirectReturn()//PictureConfig.SINGLE模式下是否直接返回 .isWeChatStyle()//开启R.style.picture_WeChat_style样式 .setPictureStyle()//动态自定义相册主题 .setPictureCropStyle()//动态自定义裁剪主题 .setPictureWindowAnimationStyle()//相册启动退出动画 .isCamera()//列表是否显示拍照按钮 .isZoomAnim()//图片选择缩放效果 .imageFormat()//拍照图片格式后缀,默认jpeg, PictureMimeType.PNG,Android Q使用PictureMimeType.PNG_Q .maxSelectNum()//最大选择数量,默认9张 .minSelectNum()// 最小选择数量 .maxVideoSelectNum()//视频最大选择数量 .minVideoSelectNum()//视频最小选择数量 .videoMaxSecond()// 查询多少秒以内的视频 .videoMinSecond()// 查询多少秒以内的视频 .imageSpanCount()//列表每行显示个数 .openClickSound()//是否开启点击声音 .selectionMedia()//是否传入已选图片 .recordVideoSecond()//录制视频秒数 默认60s .filterMinFileSize() // 过滤最小的文件 .filterMaxFileSize() // 过滤最大的文件 .queryMimeTypeConditions(PictureMimeType.ofJPEG()) // 只查询什么类型的文件 .previewEggs()//预览图片时是否增强左右滑动图片体验 .cropCompressQuality()// 注:已废弃 改用cutOutQuality() .isGif()//是否显示gif .previewImage()//是否预览图片 .previewVideo()//是否预览视频 .enablePreviewAudio()//是否预览音频 .enableCrop()//是否开启裁剪 .cropWH()// 裁剪宽高比,已废弃,改用. cropImageWideHigh()方法 .cropImageWideHigh()// 裁剪宽高比,设置如果大于图片本身宽高则无效 .withAspectRatio()//裁剪比例 .cutOutQuality()// 裁剪输出质量 默认100 .freeStyleCropEnabled()//裁剪框是否可拖拽 .circleDimmedLayer()// 是否开启圆形裁剪 .setCircleDimmedColor()//设置圆形裁剪背景色值 .setCircleDimmedBorderColor()//设置圆形裁剪边框色值 .setCircleStrokeWidth()//设置圆形裁剪边框粗细 .showCropFrame()// 是否显示裁剪矩形边框 圆形裁剪时建议设为false .showCropGrid()//是否显示裁剪矩形网格 圆形裁剪时建议设为false .rotateEnabled()//裁剪是否可旋转图片 .scaleEnabled()//裁剪是否可放大缩小图片 .isDragFrame()//是否可拖动裁剪框(固定) .hideBottomControls()//显示底部uCrop工具栏 .basicUCropConfig()//对外提供ucrop所有的配制项 .compress()//是否压缩 .compressFocusAlpha()//压缩后是否保持图片的透明通道 .minimumCompressSize()// 小于多少kb的图片不压缩 .videoQuality()//视频录制质量 0 or 1 .compressQuality()//图片压缩后输出质量 .synOrAsy()//开启同步or异步压缩 .queryMaxFileSize()//查询指定大小内的图片、视频、音频大小,单位M .compressSavePath()//自定义压缩图片保存地址,注意Q版本下的适配 .sizeMultiplier()//glide加载大小,已废弃 .glideOverride()//glide加载宽高,已废弃 .isMultipleSkipCrop()//多图裁剪是否支持跳过 .isMultipleRecyclerAnimation()// 多图裁剪底部列表显示动画效果 .querySpecifiedFormatSuffix()//只查询指定后缀的资源,PictureMimeType.ofJPEG() ... .isReturnEmpty()//未选择数据时按确定是否可以退出 .isAndroidQTransform()//Android Q版本下是否需要拷贝文件至应用沙盒内 .setRequestedOrientation()//屏幕旋转方向 ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED ... .isOriginalImageControl()//开启原图选项 .bindCustomPlayVideoCallback()//自定义视频播放拦截 .bindCustomCameraInterfaceListener()//自定义拍照回调接口 .bindCustomPreviewCallback()// 自定义图片预览回调接口 .cameraFileName()//自定义拍照文件名,如果是相册内拍照则内部会自动拼上当前时间戳防止重复 .renameCompressFile()//自定义压缩文件名,多张压缩情况下内部会自动拼上当前时间戳防止重复 .renameCropFileName()//自定义裁剪文件名,多张裁剪情况下内部会自动拼上当前时间戳防止重复 .setRecyclerAnimationMode()//列表动画效果,AnimationType.ALPHA_IN_ANIMATION、SLIDE_IN_BOTTOM_ANIMATION .isUseCustomCamera()// 开启自定义相机 .setButtonFeatures()// 自定义相机按钮状态,CustomCameraView.BUTTON_STATE_BOTH .setLanguage()//国际化语言 LanguageConfig.CHINESE、ENGLISH、JAPAN等 .isWithVideoImage()//图片和视频是否可以同选,只在ofAll模式下有效 .isMaxSelectEnabledMask()//选择条件达到阀时列表是否启用蒙层效果 .isAutomaticTitleRecyclerTop()//图片列表超过一屏连续点击顶部标题栏快速回滚至顶部 .loadCacheResourcesCallback()//获取ImageEngine缓存图片,参考Demo .setOutputCameraPath()// 自定义相机输出目录只针对Android Q以下版本,具体参考Demo .forResult();//结果回调分两种方式onActivityResult()和OnResultCallbackListener方式
函数:
PictureSelector.create(this) .openGallery(PictureMimeType.ofImage()) .loadImageEngine(GlideEngine.createGlideEngine()) // 请参考Demo GlideEngine.java .forResult(PictureConfig.CHOOSE_REQUEST); @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); if (resultCode == RESULT_OK) { switch (requestCode) { case PictureConfig.CHOOSE_REQUEST: // 结果回调 List<LocalMedia> selectList = PictureSelector.obtainMultipleResult(data); break; default: break; } }
PictureSelector.create(this) .openCamera(PictureMimeType.ofImage()) .loadImageEngine(GlideEngine.createGlideEngine()) // 请参考Demo GlideEngine.java .forResult(PictureConfig.REQUEST_CAMERA); @Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); if (resultCode == RESULT_OK) { switch (requestCode) { case PictureConfig.REQUEST_CAMERA: // 结果回调 List<LocalMedia> selectList = PictureSelector.obtainMultipleResult(data); break; default: break; } }
PictureSelector.create(this) .openGallery(PictureMimeType.ofAll()) .loadImageEngine(GlideEngine.createGlideEngine()) .forResult(new OnResultCallbackListener<LocalMedia>() { @Override public void onResult(List<LocalMedia> result) { // 结果回调 } @Override public void onCancel() { // 取消 } });
PictureSelector.create(this) .openCamera(PictureMimeType.ofImage()) .loadImageEngine(GlideEngine.createGlideEngine()) .forResult(new OnResultCallbackListener<LocalMedia>() { @Override public void onResult(List<LocalMedia> result) { // 结果回调 } @Override public void onCancel() { // 取消 } });
详细资料来源:https://github.com/LuckSiege/PictureSelector