引导控件的目的是引导用户使用应用的新功能,增强应用的用户体验。引导控件包括首次安装引导,开机引导以及引导朦层。
SimpleGuideBanner
简单的首次安装引导页,支持切换的动画自定义。
常用方法
- 设置数据源: T setSource(List list)
- 设置指示器选中动画:T setSelectAnimClass(Class selectAnimClass)
- 设置页面切换动画: T setTransformerClass(Class transformerClass)
- 设置点击跳转的监听:setOnJumpClickL(OnJumpClickL onJumpClickL)
【注】可继承使用BaseGuideActivity快速实现首次安装引导页的效果
。同理,也可继承使用BaseSplashActivity快速实现开机引导的效果
。
GuideCaseView
引导朦层组件,支持列表聚焦、控件聚焦、自定义聚焦、文字提示、图片提示、自定义布局提示、自定义聚焦动画、聚焦队列等。
- 演示效果
- 使用案例
new GuideCaseView.Builder(getActivity())
.picture(R.drawable.img_guidecaseview_gain_speed_gesture)
.build()
.show();
new GuideCaseView.Builder(getActivity())
.focusOn(view)
.focusCircleRadiusFactor(1.5)
.title("一个巨大的圆形聚焦")
.focusBorderColor(Color.GREEN)
.titleStyle(0, Gravity.BOTTOM | Gravity.CENTER)
.fitWindowsAuto()
.build()
.show();
new GuideCaseView.Builder(getActivity())
.title("坐标聚焦")
.focusRectAtPosition(600, 120, 800, 140)
.roundRectRadius(60)
.build()
.show();
常用方法
- 设置标题文字:title(String title)
- 设置图片资源:picture(int pictureResId)
- 设置聚焦边框的颜色:focusBorderColor(int focusBorderColor)
- 设置聚焦边框的粗细:focusBorderSize(int focusBorderSize)
- 设置聚焦的控件:focusOn(View view)
- 设置引导朦层的背景颜色:backgroundColor(int backgroundColor)
- 设置自定义引导朦层布局:customView(int layoutResource, OnViewInflateListener listener)
- 设置进入动画:enterAnimation(Animation enterAnimation)
- 设置退出动画:exitAnimation(Animation exitAnimation)
- 设置聚焦的形状,默认是圆形:focusShape(FocusShape focusShape)
- 自定义聚焦的矩形区域:focusRectAtPosition(int positionX, int positionY, int positionWidth, int positionHeight)
- 自定义聚焦的环形区域:focusCircleAtPosition(int positionX, int positionY, int radius)
- 设置引导朦层消失的监听:dismissListener(DismissListener dismissListener)【注】使用GuideCaseQueue,将需要展示的GuideCaseView加入进去,可实现引导朦层点执行效果
。