Skip to content

Yuphee/RewardLayout

Repository files navigation

GitHub license GitHub stars GitHub stars GitHub last commit

RewardLayout

仿斗鱼送礼物效果
本项目旨在提供实现参考,交流学习。

关于我,欢迎关注
有问题及时issue pr 或 email
如果对你有点帮助的话,点个star哦~

Screenshots

效果展示:

image image

Getting started

Add it in your root build.gradle at the end of repositories:

allprojects {
   repositories {
       ...
       maven { url "https://jitpack.io" }
   }
}

Add the dependency

   dependencies {
      implementation 'com.github.Yuphee:RewardLayout:1.0.6.4'
   }

Apk

Demo体验

Statement

1.关于直播间布局
可以采用Activity+LiveFragment+ContainnerDialogFragment(Viewpager(EmptyFragment+LayerFragment));不一定要用DialogFragment,如果想上下滑流畅还是得用普通的Fragment
如果需要上下滑动切换直播间,可以套上verticalviewpager,可以参考我的另一个关于兼容上下左右滑动的Viewpager项目Bidirectio也可以是其它的VerticalViewpager,直播页单独在LiveFragment实现,HorizontalViewpager覆盖在LiveFragment之上,HorizontalViewpager中包含2个Fragment,一个是空的透明页,用于左右滑动实现沉浸式效果,另一个则是遮罩层,包含用户列表,头像,评论,礼物布局等一些悬浮在直播TextureView之上的布局

2.关于RewardLayout
可自定义礼物item布局,动画,最大条数,每种礼物持续时间,继承BaseGiftBean实现自定义的SendGiftBean,并实现相应接口方法,可轻松实现自定义的效果;最大礼物数可在xml上指定或者代码直接定义,其它参数可以在自定义SendGiftBean中指定,具体接入请参考demo

3.实践
本库用在项目《椰趣》中,可以自行到各大应用市场下载体验

Fast review

Activity

   // 可以由服务器返回json解析得到
   bean1 = new SendGiftBean(1,1,"林喵喵","糖果",R.mipmap.tg,2700);
   bean2 = new SendGiftBean(2,2,"马甲","666",R.mipmap.good,3000);
   bean3 = new SendGiftBean(3,3,"小梦梦","小香蕉",R.mipmap.banana,2500);
   bean4 = new SendGiftBean(4,4,"大枫哥","鱼丸",R.mipmap.yw,2000);
   bean5 = new SendGiftBean(4,1,"大枫哥","糖果",R.mipmap.tg,2700);
   rewardLayout.setGiftAdapter(new RewardLayout.GiftAdapter<SendGiftBean>() {
           @Override
           public View onInit(View view, SendGiftBean bean) {
               //参考demo
               return view
           }

           @Override
           public View onUpdate(View view, SendGiftBean oSendGiftBean t) {
               //参考demo
               o返回的数据对象为Rewardlayout内部存储过的该礼物的数据对象t返回的对象为每次put进去的新对象
               return view;
           }

           @Override
           public void addAnim(final View view) {
               //参考demo
           }

           @Override
           public AnimationSet outAnim() {
               return AnimUtils.getOutAnimation(MainActivity.this);
           }

           //判断礼物唯一性
           @Override
           public boolean checkUnique(SendGiftBean o, SendGiftBean t) {
               return o.getTheGiftId() == t.getTheGiftId() && o.getTheUserId() == t.getTheUserId();
           }
           
           //礼物展示结束,可能由于送礼者过多,轨道被替换导致结束
            @Override
           public void onKickEnd(SendGiftBean bean) {
               Log.e("zyf", "onKickEnd:" + bean.getTheGiftId() + "," + bean.getGiftName() + "," + bean.getUserName() + "," +   bean.getTheGiftCount());
           }

           //礼物连击结束,即被系统自动清理时回调
           @Override
           public void onComboEnd(SendGiftBean bean) {
               Log.e("zyf","onComboEnd:"+bean.getTheGiftId()+","+bean.getGiftName()+","+bean.getUserName()+","+bean.getTheGiftCount());
           }

           @Override
           public SendGiftBean generateBean(SendGiftBean bean) {
               try {
                   return (SendGiftBean) bean.clone();
               } catch (CloneNotSupportedException e) {
                   e.printStackTrace();
               }
               return null;
           }
       });
       
   @Override
   protected void onPause() {
       super.onPause();
       if(rewardLayout != null) {
           rewardLayout.onPause();
       }
   }

   @Override
   protected void onResume() {
       super.onResume();
       if(rewardLayout != null) {
           rewardLayout.onResume();
       }
   }

   @Override
   protected void onDestroy() {
       super.onDestroy();
       if(rewardLayout != null) {
           rewardLayout.onDestroy();
       }
   }
   
  Just call ->
  rewardLayout.put(bean1);
  //手动刷新礼物过期时间,防止被礼物回收线程回收,可用于其它需要增加礼物停留时间的需求。
  rewardLayout.updateRefreshTime(bean1,2000);

XML

<com.zhangyf.reward.view.RewardLayout
       android:id="@+id/llgiftcontent"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:layout_marginTop="100dp"
       android:animateLayoutChanges="true"
       app:max_gift="3"
       app:gift_item_layout="@layout/gift_animation_item"
       android:orientation="vertical" />

Todo

支持更多礼物替换规则(如贵重礼物展示优先,总价值礼物展示优先,最近最新优先,组合策略等)
 

Fixed

v1.0 已改进不同礼物消失机制,采用postHandler及removeCallbacks去更新和执行删除时机,可以通过config自定义每种礼物不同的持续时间,同时已优化不同人对同种礼物的区分

v1.1 修复快速送礼物重复问题,调整postDelay为ScheduledExecutorService去定时清除到期礼物,调整数据结构,用户自定义数据对象需继承BaseGiftBean并实现相应接口,取消GiftConfig配置

v1.2 增加礼物LinkedBlockingQueue队列,支持高并发礼物赠送,程序模拟礼物赠送确保礼物都能够被展现,修复部分bug

v1.3 生成lib库,gradle直接集成

v1.4 必须继承BaseGiftBean改为实现GiftIdentify接口,修复内存泄漏,礼物唯一条件判断由用户实现

v1.5 解决相同礼物单次赠送数目变化问题,修复其它问题

v1.5.1 降低礼物库的最低sdk版本至19

v1.5.2 修复内存泄漏

v1.5.4 增加送礼轨道被踢回调及系统判定结束连击回调

v1.5.8 增加手动刷新礼物过期时间

v1.6.0 minsdk降为14,修改某些代码

v1.6.1 修改礼物更新回调,返回新添加进去的礼物对象,tag更新内部完成,如需要更新原已展示对象的数据需自行手动更新

v1.6.2 修复礼物轨道概率不消失问题 见 issue#6

v1.6.3 修复轨道礼物消失时赠送同一种礼物,礼物轨道不显示问题

Thanks

感谢许同学提供的切图

赞赏

如果对大佬有用的话,赏杯下午茶吧。
imageimage

赞赏鸣谢


大不六