下面开始进入主题。
1、首先我们来看看如何使用,控件的使用很简单,可以在xml中配置使用:
<org.loader.liteplayer.ui.LrcView
xmlns:lrc="http://schemas.android.com/apk/res/org.loader.liteplayer"
android:id="@+id/play_first_lrc_2"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="5dp"
android:layout_marginBottom="5dp"
lrc:textSize="18sp"
lrc:normalTextColor="@android:color/white"
lrc:currentTextColor="@color/main"
lrc:dividerHeight="20dp"
lrc:rows="9" />
这里我们来看看几个以lrc为命名空间的配置项。
textSize不用多说,肯定是文本的大小了;normalTextColor是普通文本的颜色,因为歌词分为普通的行和当前高亮行,那currentTextColor肯定是高亮行的颜色了;dividerHeight是行间距;rows是显示多少行歌词,在该配置文件中是显示9行的歌词。配置好了,我们需要在activity或者fragment中来使用它。
...
mLrcViewOnSecondPage = (LrcView) lrcView.findViewById(R.id.play_first_lrc_2);
...
mLrcViewOnSecondPage.setLrcPath(lrcPath);
...
@Override
public void onPublish(int progress) {
if(mLrcViewOnSecondPage.hasLrc()) mLrcViewOnSecondPage.changeCurrent(progress);
}
第一行代码去获取该控件,接着调用setLrcPath将歌词文件加载到内存中,在onPushlish方法中不断调用changeCurrent来更新歌词,那changeCurrent的参数哪来的呢?这个是音乐播放回调的进度,到这里,可能会有大神出疑问了, 这样做是不是会不断的更新歌词控件?就算当前没有切换歌词也回去更新? 这里先给出回答:当然不是了,我们在changeCurrent方法中做了判断,所以这里尽管调用,放心调用!
那接下来,我们开始进入今天的主题:LrcView。
在进入代码之前,先来看看我的设计思路吧:
当我们传进一个lrc文件的path,首先按照行去read文件,并且利用正则解析出时间和歌词分别存放。设置完歌词后,我们通过不断调用changeCurrent()方法来切换歌词,那么changeCurrent又负责了什么工作呢? 在changeCurrent中首先判断下一行开始的时间是不是大于当前传进来的时间,如果是,直接返回,否则,遍历所有的时间,找到大于当前时间的上一行的key, 再次通过key找到歌词,咔咔咔, 显示出来就ok了。
look code:
public class LrcView extends View {
private static final int SCROLL_TIME = 500;
private static final String DEFAULT_TEXT = "暂无歌词";
private List<String> mLrcs = new ArrayList<String>(); // 存放歌词
private List<Long> mTimes = new ArrayList<Long>(); // 存放时间
private long mNextTime = 0l; // 保存下一句开始的时间
private int mViewWidth; // view的宽度
private int mLrcHeight; // lrc界面的高度
private int mRows; // 多少行
private int mCurrentLine = 0; // 当前行
private int mOffsetY; // y上的偏移
private int mMaxScroll; // 最大滑动距离=一行歌词高度+歌词间距
private float mTextSize; // 字体
private float mDividerHeight; // 行间距
private Rect mTextBounds;
private Paint mNormalPaint; // 常规的字体
private Paint mCurrentPaint; // 当前歌词的大小
private Bitmap mBackground;
private Scroller mScroller;
public LrcView(Context context, AttributeSet attrs) {
this(context, attrs, 0);
}
public LrcView(Context context, AttributeSet attrs, int defStyleAttr) {
super(context, attrs, defStyleAttr);
mScroller = new Scroller(context, new LinearInterpolator());
inflateAttributes(attrs);
}
...
}
这么多变量!到底是干嘛用的!只是为了装B吗? NO NO NO, 我们定义它,肯定是需要啦,一个个的来解释一下吧吧。
常量SCROLL_TIME定义了当歌词切换时滑动的时间,这里是500ms。
常量DEFAULT_TEXT定义的是当没有歌词的时候显示的默认文本。
两个ArrayList,mLrcs保存的是一行行的歌词,mTimes保存的是歌词对应的时间。
mNextTime表示的是下一行开始的时间。
其他的一些变量,可以看看代码里的注释,这里就不一一贴出来了。
再来看看构造方法,除了初始化Scroller外,我们调用了inflateAttributes(),那我们跟进inflateAttributes():
// 初始化操作
private void inflateAttributes(AttributeSet attrs) {
// <begin>
// 解析自定义属性
TypedArray ta = getContext().obtainStyledAttributes(attrs, R.styleable.Lrc);
mTextSize = ta.getDimension(R.styleable.Lrc_textSize, 50.0f);
mRows = ta.getInteger(R.styleable.Lrc_rows, 5);
mDividerHeight = ta.getDimension(R.styleable.Lrc_dividerHeight, 0.0f);
int normalTextColor = ta.getColor(R.styleable.Lrc_normalTextColor, 0xffffffff);
int currentTextColor = ta.getColor(R.styleable.Lrc_currentTextColor, 0xff00ffde);
ta.recycle();
// </end>
// 计算lrc面板的高度
mLrcHeight = (int) (mTextSize + mDividerHeight) * mRows + 5;
mNormalPaint = new Paint();
mCurrentPaint = new Paint();
// 初始化paint
mNormalPaint.setTextSize(mTextSize);
mNormalPaint.setColor(normalTextColor);
mNormalPaint.setAntiAlias(true);
mCurrentPaint.setTextSize(mTextSize);
mCurrentPaint.setColor(currentTextColor);
mCurrentPaint.setAntiAlias(true);
mTextBounds = new Rect();
mCurrentPaint.getTextBounds(DEFAULT_TEXT, 0, DEFAULT_TEXT.length(), mTextBounds);
mMaxScroll = (int) (mTextBounds.height() + mDividerHeight);
}
5~12行,解析出属性值,没有什么好说的,无非就是获取用户配置的颜色啦,字体大小啦,多少行啦。
16行,通过获取到的属性,计算出Lrc能显示下需要多少高度。
然后接下来的一系列动作就是初始化两个Paint,并获取Scroller最大滚动的距离,为什么要计算这个呢? 因为我们需要知道歌词每次要滚动多大距离。(废话!)
初始化完了,就是测量了,我们的测量也是很简单的。
@Override
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
super.onMeasure(widthMeasureSpec, heightMeasureSpec);
// 重新设置view的高度
int measuredHeightSpec = MeasureSpec.makeMeasureSpec(mLrcHeight, MeasureSpec.AT_MOST);
super.onMeasure(widthMeasureSpec, measuredHeightSpec);
}
@Override
protected void onSizeChanged(int w, int h, int oldw, int oldh) {
super.onSizeChanged(w, h, oldw, oldh);
// 获取view宽度
mViewWidth = getMeasuredWidth();
}
测量,我们只是重新定义了高度,然后在onSizeChanged中获取了该view的宽度。
按照,进度呢,我们接下来应该看draw了,但是现在我们先不去看onDraw,而是去看看setLrcPath这个方法。
// 外部提供方法
// 设置lrc的路径
public void setLrcPath(String path) {
reset();
File file = new File(path);
if (!file.exists()) {
postInvalidate();
return;
}
BufferedReader reader = null;
try {
reader = new BufferedReader(new InputStreamReader(new FileInputStream(file)));
String line = "";
String[] arr;
while (null != (line = reader.readLine())) {
arr = parseLine(line);
if (arr == null) continue;
// 如果解析出来只有一个
if (arr.length == 1) {
String last = mLrcs.remove(mLrcs.size() - 1);
mLrcs.add(last + arr[0]);
continue;
}
mTimes.add(Long.parseLong(arr[0]));
mLrcs.add(arr[1]);
}
} catch (Exception e) {
e.printStackTrace();
} finally {
if(reader != null) {
try {
reader.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}
虽然长了点,但是都是基本的java io,按行去读取文件,然后正则匹配。
需要注意的是22~26行,这里需要说明一下,我们只是匹配了形如:
[05:20.59] 我从天上来
这样的歌词。继续看看parseLine()方法吧。用正则去匹配歌词。
// 解析每行
private String[] parseLine(String line) {
Matcher matcher = Pattern.compile("\\[\\d.+\\].+").matcher(line);
// 如果形如:[xxx]后面啥也没有的,则return空
if (!matcher.matches()) {
System.out.println("throws " + line);
return null;
}
line = line.replaceAll("\\[", "");
String[] result = line.split("\\]");
result[0] = String.valueOf(parseTime(result[0]));
return result;
}
只是简单的正则,没看懂的可以脑补正则了,这里我们只匹配[开头是数字的],如果不是数字,例如:[title:可惜没如果],这样的我们直接抛弃掉。在这个方法中,我们保存了每一行歌词,但是时间还需要调用parseTime()方法来处理一下。继续跟进parseTime()。
// 解析时间
private Long parseTime(String time) {
// 03:02.12
String[] min = time.split(":");
String[] sec = min[1].split("\\.");
long minInt = Long.parseLong(min[0].replaceAll("\\D+", "")
.replaceAll("\r", "").replaceAll("\n", "").trim());
long secInt = Long.parseLong(sec[0].replaceAll("\\D+", "")
.replaceAll("\r", "").replaceAll("\n", "").trim());
long milInt = Long.parseLong(sec[1].replaceAll("\\D+", "")
.replaceAll("\r", "").replaceAll("\n", "").trim());
return minInt * 60 * 1000 + secInt * 1000 + milInt * 10;
}
也是很简单的,通过分割形如“03:02.12”的时间,并且在最后以毫秒的形式返回。
到目前为止,所有的歌词和歌词对应的时间已经保存起来了,接下来,就是要调用changeCurrent()方法来切换歌词了。
// 外部提供方法
// 传入当前播放时间
public synchronized void changeCurrent(long time) {
// 如果当前时间小于下一句开始的时间
// 直接return
if (mNextTime > time) {
return;
}
// 每次进来都遍历存放的时间
for (int i = 0; i < mTimes.size(); i++) {
// 发现这个时间大于传进来的时间
// 那么现在就应该显示这个时间前面的对应的那一行
// 每次都重新显示,是不是要判断:现在正在显示就不刷新了
if (mTimes.get(i) > time) {
mNextTime = mTimes.get(i);
mScroller.abortAnimation();
mScroller.startScroll(i, 0, 0, mMaxScroll, SCROLL_TIME);
// mNextTime = mTimes.get(i);
// mCurrentLine = i <= 1 ? 0 : i - 1;
postInvalidate();
return;
}
}
}
6~8行判断一下现在传进来的时间是不是大于下一行的时间,如果不是,直接返回,避免过度重绘。
接下来,去遍历所有的时间,如果发现该时间大于传进来的时间,那么证明现在要显示上一行了,保存这个时间,并开始一个Scroller。startScroll方法的参数我们是这样设置的。x值在scroll中没有用,所以我们用来保存当前key,并且让他的变化度为0,y的值是从0到mMaxScroll.
接着来看看computeScroll()中怎么处理的。
@Override
public void computeScroll() {
if(mScroller.computeScrollOffset()) {
mOffsetY = mScroller.getCurrY();
if(mScroller.isFinished()) {
int cur = mScroller.getCurrX();
mCurrentLine = cur <= 1 ? 0 : cur - 1;
mOffsetY = 0;
}
postInvalidate();
}
}
y的变化值我们作为滑动的偏移量,而x呢 当然就是当前行了。
接下来,我们就要开始进入onDraw方法了。
@Override
protected void onDraw(Canvas canvas) {
// float centerY = (getMeasuredHeight() + mTextBounds.height() - mDividerHeight) / 2;
float centerY = (getMeasuredHeight() + mTextBounds.height()) / 2;
if (mLrcs.isEmpty() || mTimes.isEmpty()) {
canvas.drawText(DEFAULT_TEXT,
(mViewWidth - mCurrentPaint.measureText(DEFAULT_TEXT)) / 2,
centerY, mCurrentPaint);
return;
}
String currentLrc = mLrcs.get(mCurrentLine);
float currentX = (mViewWidth - mCurrentPaint.measureText(currentLrc)) / 2;
// 画当前行
canvas.drawText(currentLrc, currentX, centerY - mOffsetY, mCurrentPaint);
float offsetY = mTextBounds.height() + mDividerHeight;
int firstLine = mCurrentLine - mRows / 2;
firstLine = firstLine <= 0 ? 0 : firstLine;
int lastLine = mCurrentLine + mRows / 2 + 2;
lastLine = lastLine >= mLrcs.size() - 1 ? mLrcs.size() - 1 : lastLine;
// 画当前行上面的
for (int i = mCurrentLine - 1,j=1; i >= firstLine; i--,j++) {
String lrc = mLrcs.get(i);
float x = (mViewWidth - mNormalPaint.measureText(lrc)) / 2;
canvas.drawText(lrc, x, centerY - j * offsetY - mOffsetY, mNormalPaint);
}
// 画当前行下面的
for (int i = mCurrentLine + 1,j=1; i <= lastLine; i++,j++) {
String lrc = mLrcs.get(i);
float x = (mViewWidth - mNormalPaint.measureText(lrc)) / 2;
canvas.drawText(lrc, x, centerY + j * offsetY - mOffsetY, mNormalPaint);
}
}
首先第4行,我们计算出了该view的中间位置,因为我们的歌词是从中间往两边画的。
5~10行,如果歌词为空,则显示默认的文本”暂无歌词“
12~15行是去绘制当前正在歌唱的行,drawText的第三个参数,我们减去了mOffetY,效果就是一个滑动的过程。
绘制完当前行,我们就需要绘制出当前行上面的和下面的。
17行,是每一行占领的高度。
18、19行,获取的是当前需要显示的第一行(并不是歌词的第一行)。
20、21行,获取需要显示的最后一行。
24~28行,去绘制当前行上面的的需要显示的歌词,需要注意的drawText的第三个参数,我们是通过中间那行的绘制位置去偏移的。
31~35行是去绘制当前行下面的,原理和绘制上面的一样。
这样,一个带有平滑滚动效果的歌词控件就完成了。
最后我们来看看最终的效果:
最后,是关于代码的问题,有人说我的博客没有demo下载,这个以后会注意哈, 这次的代码,等我这个月月底毕业答辩完了,会把音乐播放器一块开源了。