引导界面导航效果

动态数据配置

智能轮播控制

• 当数据量≥1页时，可设置无限循环自动轮播。
• 支持手指按下暂停轮播，随后释放后自动恢复轮播。

高度可定制化

• 指示器可定义位置（top、bottom、left、right、center_horizontal等）。
• 广告文案与指示器位置可自定义，支持图片或数字指示器。

多页面并发滚动

事件监听

网络数据加载优化

Fresco 图片加载

自定义布局

添加 Gradle 依赖

implementation 'com.android.support:support-v4:latestVersion'implementation 'cn.bingoogolapple:bga-banner:latestVersion@aar'

注意：latestVersion为最新版本号，请根据项目需求自行替换。

布局文件中添加 BGABanner

配置数据源

• 方式一：通过 Adapter 配置数据源

  适用于网络图片及无限轮播场景，代码示例如下：

  mContentBanner.setAdapter(new BGABanner.Adapter
        
         () {    @Override    public void fillBannerItem(BGABanner banner, ImageView itemView, String model, int position) {        Glide.with(MainActivity.this)            .load(model)            .placeholder(R.drawable.holder)            .error(R.drawable.holder)            .centerCrop()            .dontAnimate()            .into(itemView);    }});mContentBanner.setData(Arrays.asList("路径1", "路径2", "路径3"), Arrays.asList("文案1", "文案2", "文案3"));
        

• 方式二：自定义页面视图集合

  适用于需要自定义布局的引导页面：

  List
        
          views = new ArrayList<>();views.add(View.inflate(context, R.layout.layout_guide_one, null));views.add(View.inflate(context, R.layout.layout_guide_two, null));views.add(View.inflate(context, R.layout.layout_guide_three, null));mContentBanner.setData(views);
        

• 方式三：通过图片资源 ID 配置数据源

  适用于纯图片展示场景：

  BGALocalImageSize localImageSize = new BGALocalImageSize(720, 1280, 320, 640);mContentBanner.setData(localImageSize, ImageView.ScaleType.CENTER_CROP, R.drawable.uoko_guide_background_1, R.drawable.uoko_guide_background_2, R.drawable.uoko_guide_background_3);

监听单击事件

mContentBanner.setDelegate(new BGABanner.Delegate
    
     () {    @Override    public void onBannerItemClick(BGABanner banner, ImageView itemView, String model, int position) {        Toast.makeText(banner.getContext(), "点击了" + position, Toast.LENGTH_SHORT).show();    }});
    

配置引导按钮

mContentBanner.setEnterSkipViewIdAndDelegate(R.id.btn_guide_enter, R.id.tv_guide_skip, new BGABanner.GuideDelegate() {    @Override    public void onClickEnterOrSkip() {        startActivity(new Intent(GuideActivity.this, MainActivity.class));        finish();    }});

指示点容器背景颜色

指示点背景图像

指示点布局参数

• 左右内间距：banner_pointContainerLeftRightPadding。
• 上下外间距：banner_pointTopBottomMargin。
• 左右外间距：banner_pointLeftRightMargin。

指示器位置设置

自动轮播设置

• 是否启用自动轮播：banner_pointAutoPlayAble。
• 轮播间隔时间：banner_pointAutoPlayInterval，默认值策略可自行调整。
• 页面切换动画效果：banner_transitionEffect，支持多种动画效果。

文案样式设置

• 提示文案颜色：banner_tipTextColor。
• 提示文案大小：banner_tipTextSize。

占位图设置

• 设置加载中占位图：banner_placeholderDrawable。

指示器类型

• 是否是数字指示器：banner_isNumberIndicator。
• 数字指示器颜色：banner_numberIndicatorTextColor。
• 数字指示器大小：banner_numberIndicatorTextSize。
• 数字指示器背景：banner_numberIndicatorBackground。

一页展示设置

• 是否显示指示器：banner_isNeedShowIndicatorOnOnlyOnePage，默认值为 false。

UI容量设置

• 内容底部间距：banner_contentBottomMargin。
• 宽高比例：banner_aspectRatio，可根据需求自定义。