大图浏览可以说是所有App必备功能,可见其重要性,所以有必要将其独立,便于维护和复用。本文代码基于SubsamplingScaleImageView开源库实现,增加单手拖拽返回,透明度变化等效果。
浏览效果
由于简书有图片大小限制,压缩后很模糊,
请移步github查看。
功能实现
-
超大图浏览
SubsamplingScaleImageView基于BitmapRegionDecoder实现,避免OOM情况下,轻松浏览超大图,支持各种手势操作。感兴趣的请查阅其源码。
-
浏览Activity背景透明
//manifest 设置Activity theme属性 android:theme="@style/photoviewer_theme" //对应style定义 <style name="photoviewer_theme" parent="Theme.AppCompat.NoActionBar"> <item name="android:windowBackground">@android:color/transparent</item> <item name="android:windowIsTranslucent">true</item> </style>
-
沉浸式效果
private void hideSystemUI() { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) { View decorView = getWindow().getDecorView(); decorView.setSystemUiVisibility( View.SYSTEM_UI_FLAG_LAYOUT_STABLE | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_FULLSCREEN // hide status bar | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY); } else { WindowManager.LayoutParams attrs = getWindow().getAttributes(); attrs.flags |= WindowManager.LayoutParams.FLAG_FULLSCREEN; getWindow().setAttributes(attrs); getWindow().addFlags( WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS); } //change navigationbar bg color if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION); getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS); getWindow().setNavigationBarColor(Color.TRANSPARENT); } }
-
自定义DragPhotoView拦截touch事件
setOnTouchListener(new View.OnTouchListener() { @Override public boolean onTouch(View v, MotionEvent event) { //如果正在动画,拦截不处理。 if (isAnimating()) { return true; } //判断图片是否为初始状态(第一次进入后显示的大小) if (isReady() && (firstDisplayScale == getScale())) { final int action = event.getAction(); switch (action & MotionEvent.ACTION_MASK) { case MotionEvent.ACTION_DOWN: if (DEBUG) { Log.d(TAG, "action_down = " + firstDisplayScale + ", getScale = " + getScale() + " isFirstEnterState = " + (firstDisplayScale == getScale())); } downX = event.getX(); downY = event.getY(); canDrag = true; break; case MotionEvent.ACTION_MOVE: if (canDrag) { final float dy = Math.abs(downY - event.getY()); if (firstDisplayScale == getScale() && dy > touchSlop) { isDragging = true; translateX = event.getX() - downX; translateY = event.getY() - downY; float percent = dy / maxTranslateY; if (percent > 1.0f) { percent = 1.0f; } bgAlpha = (int) (255 * (1 - percent)); bgAlpha = bgAlpha < minBgAlpha ? minBgAlpha : bgAlpha; //尽量将图片缩放比例设置小点 final float p = dy / getHeight(); bitmapScale = (1 - p); bitmapScale = bitmapScale < minBitmapScale ? minBitmapScale : bitmapScale; if(DEBUG) { Log.d(TAG, "action_move translateX = " + translateX + "; translateY = " + translateY + "; pointerCount = " + event.getPointerCount()); } invalidate(); } } break; case MotionEvent.ACTION_CANCEL: case MotionEvent.ACTION_UP: if(DEBUG) { Log.d(TAG, "action = " + action + "; pointerCount = " + event.getPointerCount()); } if (isDragging) { //最后一个手指离开屏幕时,检查y轴方向拖拽距离是否超过阀值,若超过则回调dismiss接口 if (Math.abs(translateY) >= maxTranslateY && dismissListener != null) { dismissListener.onDismiss(); }else{ //若为超过阀值,则指定动画回到初始位置。 restoreFirstEnterState(); } isDragging = false; } break; case MotionEvent.ACTION_POINTER_UP: case MotionEvent.ACTION_POINTER_DOWN: if(DEBUG){ Log.d(TAG, "action pointer down or up= " + action + "; pointerCount = " + event.getPointerCount()); } //防止拖拽过程中多点触摸导致事件错乱。 canDrag = isDragging; break; default: break; } } return isDragging; } }); @Override protected void onDraw(Canvas canvas) { //肯定touch move事件,不断更新以下几个变量的值来达到动画效果。 createPaint(); bgPaint.setAlpha(bgAlpha); canvas.drawRect(0, 0, getWidth(), getHeight(), bgPaint); canvas.translate(translateX, translateY); canvas.scale(bitmapScale, bitmapScale, getWidth() / 2, getHeight() / 2); super.onDraw(canvas); }
-
点击位置(进入和退出动画)
// TODO 非刚需,暂未实现。
兼容处理(18.03.03更新)
-
Image failed to decode using JPEG decoder
由于使用了SubsamplingScaleImageView库显示大图,内部使用的是系统BitmapRegionDecoder解码,其只支持JPG和PNG格式,而且在不同的设备和版本上表现有差异,一句话:不稳定,还出问题。
我的解决思路:监听SubsamplingScaleImageView解码错误回调,转为使用PhotoView显示图片。
源码地址
以上提及代码均在AndroidUiKit项目(安卓常用UI组件库。 总结、沉淀、封装优化;为避免重复造轮子,此项目会收集优秀的三方库,或直接引用,或修改源码;目标很明确:快速集成开发,提高效率。)
代码位置:uikit module中photoviewer包下
App图片处理库推荐
- 图片加载神器Glide
- Multi-media selector(本地图片视频选择器) AndroidUiKit项目中有推荐。
本文为原创内容,转载请说明出处,首发博客。