美文网首页
【造轮子】几行代码实现高亮显示按钮,完成App新手引导

【造轮子】几行代码实现高亮显示按钮,完成App新手引导

作者: 刀放下好好说话 | 来源:发表于2018-02-06 19:49 被阅读117次

    一、首先看下效果

    tour_view.gif

    二、分析

    发布一个新版本新功能上线之前总是有引导用户操作的覆盖层,常见的是某些按钮高亮,然后一个提示语或者一张漫画图片。
    之前遇到这种功能,一直是UI直接做一张全屏的图片,然后我放到ImageView里,功能能实现,但是经常遇到适配问题,或者图片太大OOM。
    今天试着搜索了一下看有没有优雅的方式,百度关键字TourView GuideView都能找到demo,但是看源码很乱,或者就是功能太多,我只要一个简单的高亮就行,试着造一个轮子。

    三、代码

    我们把每一个引导看成一个对象 TourModel,建立 model 的模型:

    public class TourModel {
        private Bitmap bitmap;
        private int type;
    
        private int bitmapLeft;
        private int bitmapTop;
    
        private int holeLeft;
        private int holeTop;
        private int holeRight;
        private int holeBottom;
    
        ...  忽略setter  getter  ...
    
        /**
         * 设置高亮洞的rect坐标
         * @param holeLeft 洞左
         * @param holeTop 洞上
         * @param holeRight 洞右
         * @param holeBottom 洞下
         */
        public void setHole(int holeLeft, int holeTop, int holeRight, int holeBottom) {
            this.holeLeft = holeLeft;
            this.holeTop = holeTop;
            this.holeRight = holeRight;
            this.holeBottom = holeBottom;
        }
    
        /**
         * 设置引导图片的位置
         * @param bitmapLeft 图片居左
         * @param bitmapTop 图片居上
         */
        public void setBitmapLocation(int bitmapLeft, int bitmapTop) {
            this.bitmapLeft = bitmapLeft;
            this.bitmapTop = bitmapTop;
        }
    }
    

    bitmap也就是展示的图片,这个地方有点局限,最好每次只展示一张图片,但是够用,我基本每一个引导只会要求展示一张图片;这个图片的居左和居上需要记录,绘制的时候能用到;然后是高亮区域的坐标,几乎就是点击的一个 view 的上下左右。

    再来看看自定义 View 做了哪些事:

        private void initView(Context context, AttributeSet attrs) {
            mContext = context;
            tourModels = new ArrayList<>();
            mPaint = new Paint();
            mPaint.setAntiAlias(true);
            mPaint.setStyle(Paint.Style.FILL);
            mPaint.setColor(Color.WHITE);
            blurMaskFilter = new BlurMaskFilter(blurWidth, BlurMaskFilter.Blur.OUTER);
            disableHardwareRendering(this);
        }
    
        /**
         * 禁止硬件加速
         * @param v
         */
        public static void disableHardwareRendering(View v) {
            if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.HONEYCOMB) {
                v.setLayerType(View.LAYER_TYPE_SOFTWARE, null);
            }
        }
    

    一些初始化,基操,然后关键是这个禁止硬件加速,这个是高亮区域周围的虚化,如果没有这句话,虚化不会显示,这个我在自定义涂鸦的时候搜到的,想不到这里用上了。
    再往下走:

        @Override
        protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
            width = MeasureSpec.getSize(widthMeasureSpec);
            height = MeasureSpec.getSize(heightMeasureSpec);
    
            setMeasuredDimension(width, height);
        }
    

    测量,这里没有要写的,基本都是全屏。
    往下,关键代码 onDraw() :

        @Override
        protected void onDraw(Canvas canvas) {
            super.onDraw(canvas);
            if (position != -1) {
                TourModel tourModel = tourModels.get(position);
    
                //画高亮区域
                mPaint.setMaskFilter(null);
                //离屏缓存
                int saved = canvas.saveLayer(null, null, Canvas.ALL_SAVE_FLAG);
                canvas.drawColor(Color.parseColor("#cc000000"));
                drawHole(canvas, tourModel);
                mPaint.setXfermode(new PorterDuffXfermode(PorterDuff.Mode.XOR));
                drawHole(canvas, tourModel);
                mPaint.setXfermode(null);
                //恢复画布
                canvas.restoreToCount(saved);
    
                //画引导的信息
                canvas.drawBitmap(tourModel.getBitmap(), tourModel.getBitmapLeft(), tourModel.getBitmapTop(), mPaint);
    
                //虚化
                if (blurWidth > 0) {
                    mPaint.setMaskFilter(blurMaskFilter);
                    drawHole(canvas, tourModel);
                }
            }
        }
    

    一个重要的方法 mPaint.setXfermode(),这个方法一共有16种模式,设置这个模式需要两张画布结合才会显示效果,所以这里用到一个我不知道的技术,叫离屏缓存,也就是新生成一张画布,然后在上面绘制内容,最后再恢复画布将内容绘制到view上来。
    我们这里用的是 XOR 模式,也就是两张画布重合的地方被舍弃,于是就有了镂空的圆形高亮的孔洞。
    恢复画布之后我们再在view上绘制我们的引导图片和虚化效果。
    绘制高亮区域 drawHole() 的代码:

        /**
         * 画高亮区域
         *
         * @param canvas
         * @param tourModel
         */
        private void drawHole(Canvas canvas, TourModel tourModel) {
            switch (tourModel.getType()) {
                case Type.TYPE_CIRCLE:
                    int holeWidth = tourModel.getHoleRight() - tourModel.getHoleLeft();
                    int holeHeight = tourModel.getHoleBottom() - tourModel.getHoleTop();
                    int radius = holeWidth > holeHeight ? holeWidth / 2 : holeHeight / 2;
                    canvas.drawCircle((tourModel.getHoleLeft() + tourModel.getHoleRight()) / 2, (tourModel.getHoleTop() + tourModel.getHoleBottom()) / 2, radius, mPaint);
                    break;
                case Type.TYPE_RECT:
                    canvas.drawRect(new RectF(tourModel.getHoleLeft(), tourModel.getHoleTop(), tourModel.getHoleRight(), tourModel.getHoleBottom()), mPaint);
                    break;
                case Type.TYPE_OVAL:
                default:
                    canvas.drawOval(new RectF(tourModel.getHoleLeft(), tourModel.getHoleTop(), tourModel.getHoleRight(), tourModel.getHoleBottom()), mPaint);
                    break;
            }
        }
    

    判断类型,三种,分别是圆形、矩形和椭圆,这里矩形没有加圆角,可以扩展。
    基本就这些,代码我已经做成库了,可以一键导入:

        compile 'com.rjp:TourView:1.0.0'
    

    用法如下,xml 里加入或者直接 addView 到 activity 的根布局:

        <com.rjp.aopdemo.tour.TourView
                android:id="@+id/tour_view"
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                />
    

    我这里为了方便直接加入xml了,然后在你点击某一个 view 的时候:

        TourModel tourModel = new TourModel();
        Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.mipmap.bg_float);
        tourModel.setBitmap(bitmap);
        tourModel.setBitmapLocation(v.getLeft(), v.getBottom() + 80);
        tourModel.setHole(v.getLeft() - 20, v.getTop() - 10, v.getRight() + 20, v.getBottom() + 10);
        tourModel.setType(TYPE_CIRCLE);
        tourView.add(tourModel);
        tourView.next();
    

    新建一个 model,设置 bitmap 以及 bitmap 的位置,设置高亮区域的坐标,设置高亮区域类型,然后 add 进 TourView,调用 next() 方法开始引导。

    非常方便,有用给个star。不算原创,看的几个demo做的总结。GitHub地址

    相关文章

      网友评论

          本文标题:【造轮子】几行代码实现高亮显示按钮,完成App新手引导

          本文链接:https://www.haomeiwen.com/subject/vxhnzxtx.html