一种支持多种弹幕样式的弹幕视图控件

XDanmuku V1.1版本

项目地址：hust201010701/XDanmuku 

  

更新内容 V1.1

1. 移动View线程数修改为1
2. 加入View缓存，并能自动调整缓存空间大小
3. 修改Entity绑定View的方式

使用方法

XDanmuku

一种支持多种弹幕样式的弹幕视图控件(点击可以查看添加库的方法)。

本项目是一个开源的弹幕控件库，能够支持多种样式弹幕，弹幕点击监听，弹幕分区域显示，自定义移动速度等功能，项目原理是通过自定义ViewGroup。可能是目前轻量级弹幕库中功能最强大的一款了。

效果

• 常规样式

• 点击事件

• 多种弹幕样式

• 分区域显示

• GIF效果图

使用

0. 添加依赖

1. 导入xdanmuku源码

你可以直接下载本项目xdanmuku模块，并导入项目目录，并添加依赖compile project(':xdanmuku')

2. Gradle

先把jitpack仓库添加到项目根 build.gradle（Project）文件中，

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

然后在你的项目中添加依赖

dependencies {
        compile 'com.github.hust201010701:XDanmuku:-SNAPSHOT'
}

其他添加依赖的方式，如maven等请自行到点我查看。

1. 添加控件

在布局xml中添加控件

<com.orzangleli.xdanmuku.DanmuContainerView
    android:id="@+id/danmuContainerView"
    android:layout_width="match_parent"
    android:layout_height="240dp"
    />

2. 添加自定义弹幕Entity（需要继承自Model）

类似于DanmuEntity.java

3. 继承XAdapter

类似于ListView的BaseAdapter的结构，具体参照 DanmuAdapter.java

4. 添加弹幕

DanmuEntity danmuEntity = new DanmuEntity();
danmuEntity.setContent(SEED[random.nextInt(5)]);
danmuEntity.setType(0);
danmuEntity.setTime("23:20:11");
danmuContainerView.addDanmu(danmuEntity);

5. 弹幕点击事件监听

//弹幕点击事件
danmuContainerView.setOnItemClickListener(new DanmuContainerView.OnItemClickListener() {
    @Override
    public void onItemClick(Model model) {
        DanmuEntity danmuEntity = (DanmuEntity) model;
        Toast.makeText(MainActivity.this, danmuEntity.content, Toast.LENGTH_SHORT).show();
    }
});

6. 设置弹幕移动速度

DanmuContainerView中预设了三种弹幕移动速度：

public final static int LOW_SPEED = 1;
public final static int NORMAL_SPEED = 4;
public final static int HIGH_SPEED = 8;

设置速度通过setSpeed方法：

danmuContainerView.setSpeed(DanmuContainerView.HIGH_SPEED);

同时你可以传递具体的int型速度(建议速度值在1-8之间，数值越大速度越快)：

danmuContainerView.setSpeed(5);

7. 弹幕显示区域

本人将弹幕控件按照竖向均分为3份，分别为GRAVITY_TOP,GRAVITY_CENTER,GRAVITY_BOTTOM。用户可以自由组合显示区域，默认情况下全区域（GRAVITY_FULL）显示。设置要显示的区域通过setGravity方法实现，参数可以使用 | 进行连接。

//只在上方和中间区域显示弹幕
danmuContainerView.setGravity(DanmuContainerView.GRAVITY_TOP | DanmuContainerView.GRAVITY_CENTER);

致谢

感谢以下用户的建议和反馈：

• tz-xiaomage
• kaient
• amszsthl
• gaochunchun
• narakai 提出使用SparseArray代替HashMap维护缓存池。

附录

有几篇开发本库时的记录和心得，欢迎大家阅读点赞：

• 可能是目前轻量级弹幕控件中功能最强大的一款
  • orzangleli's blog
  • 掘金
• 基于XDanmuku的Android性能优化实战
  • orzangleli's blog
  • 掘金