FlyBanner

一个自带指示器的图片轮播控件，可以指定指示器的样式和位置以及轮播图的其他一些属性。

###默认样式

###修改后的样式

#使用

##引入

dependencies {
    compile 'com.fang:flybanner:v1.0.0'
}

在布局文件中添加

 <com.fang.flybanner.FlyBanner
       android:id="@+id/flyBanner"
       android:layout_width="match_parent"
       android:layout_height="160dp"
       app:delayTime="6"
       app:intervalTime="6"
       app:stopWhenTouch="true"
       app:leftScroll="true"
       />

其中app开头的是自定义样式，可以采用这种方式，也可以采用在代码中设置的方式,在Android Studio中自定义属性采用下面的命名空间， 当然app这个名字是可以修改的，大家看自己的喜好

xmlns:app="http://schemas.android.com/apk/res-auto"

##代码中使用

1.首先我们要写一个实体类继承BannerItem这个类

/**
 * 轮播图实体类
 */
public class FlyItem extends BannerItem{
    //图片url地址
    public String imageUrl;
    //图片描述
    public String imageDesc;
    public FlyItem(String imageUrl, String imageDesc){
        super(imageUrl,imageDesc);//这句必须写，否则无法轮播图正常工作
    }
}

2.将获得的数据添加到集合中

  private List<FlyItem> mList = new ArrayList<>();
//添加数据
   mList.add(new FlyItem(Constant.IMAGE_URL_ONE,"第一幅画"));
        mList.add(new FlyItem(Constant.IMAGE_URL_TWO,"第二幅画"));
        mList.add(new FlyItem(Constant.IMAGE_URL_THREE,"第三幅画"));
        mList.add(new FlyItem(Constant.IMAGE_URL_FOUR,"第四幅画"));

3.设置属性并开启轮播(注意：setSource这个方法必须放在最后一个属性)

  FlyBanner flyBanner = (FlyBanner) findViewById(R.id.flyBanner);
        flyBanner.setDelayTime(2)//延迟时间
                .setIntervalTime(3)//轮播图间隔
                .setLeftScroll(true)//起始时是否可以左滑
                .setStopWhenTouch(true).//触摸时是否停止轮播
                setMargins(100,0,50).//设置指示器的间距
                setIndicator(R.drawable.rb_selector,30, 0,FlyBanner.RIGTH)//设置指示器的样式和位置
                .setSource(mList)//图片的数据集合
                        .startScroll();//开启轮播

##点击监听

 flyBanner.setOnBannerItemClickListener(new FlyBanner.onBannerItemClickListener() {
            @Override
            public void onItemClick(int position) {
                Toast.makeText(MainActivity.this, "第"+position+"个", Toast.LENGTH_SHORT).show();
            }
        });

##部分方法介绍

 /**
     * 设置指示器距离四周的距离
     * @param leftMarging 左边距
     * @param rightMarging 右边距
     * @param bottomMarging 下边距
     */
    public FlyBanner setMargins(float leftMarging,float rightMarging,float bottomMarging){
       .....
    }

 /**
     * 设置指示器的样式
     * @param drawableId 指示器资源
     * @param radius 指示器半径
     * @param spacing 指示器之间的间距
     * @param gravity 指示器位置
     * @return
     */
    public FlyBanner setIndicator(int drawableId,int radius,int spacing,int gravity){
      ......
    }

##关于指示器的样式定义

这里我们规定指示器的样式只能用选择器来实现，使用时，使用下面的文件来定义选择器样式

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
<!--选中样式-->
    <item android:state_checked="true" android:drawable="@drawable/iv_selected"/>
    <!--未选中样式-->
    <item android:state_checked="false" android:drawable="@drawable/iv_unselected"/>
</selector>

只需要定义不同的样式文件，然后添加到这个选择器里就可以。例如其中选中指示器的样式代码如下

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="oval">
    <!--选中为蓝色-->
    <solid android:color="@android:color/holo_blue_light"/>
</shape>

最后给大家四张图片的地址，方便测试

/**
 * 网络图片地址
 */
public class Constant {
    public static final String IMAGE_URL_ONE = "https://ss0.baidu.com/94o3dSag_xI4khGko9WTAnF6hhy/image/h%3D200/sign=bd08307d4b166d222777129476220945/b3b7d0a20cf431ad231cf48f4336acaf2fdd98be.jpg";
    public static final String IMAGE_URL_TWO = "https://ss3.baidu.com/-fo3dSag_xI4khGko9WTAnF6hhy/image/h%3D200/sign=5cce3876b87eca800d053ee7a1229712/8cb1cb1349540923338bfd2b9a58d109b2de4981.jpg";
    public static final String IMAGE_URL_THREE = "https://ss2.baidu.com/-vo3dSag_xI4khGko9WTAnF6hhy/image/h%3D200/sign=e648595ff01986185e47e8847aed2e69/0b46f21fbe096b63a377826e04338744ebf8aca6.jpg";
    public static final String IMAGE_URL_FOUR = "https://ss0.bdstatic.com/70cFuHSh_Q1YnxGkpoWK1HF6hhy/it/u=502130030,3916954728&fm=111&gp=0.jpg";
}

##使用过程中，如果有什么好的建议或者任何问题，可以向我提出，我会尽快解决