下面是Google对该类的描述:
/**
* Helper for tracking the velocity of touch events, for implementing
* flinging and other such gestures. Use {@link #obtain} to retrieve a
* new instance of the class when you are going to begin tracking, put
* the motion events you receive into it with {@link #addMovement(MotionEvent)},
* and when you want to determine the velocity call
* {@link #computeCurrentVelocity(int)} and then {@link #getXVelocity()}
* and {@link #getXVelocity()}.
*/
简单翻译下:
帮助你追踪一个touch事件(flinging事件和其他手势事件)的速率。当你要跟踪一个touch事件的时候,使用obtain()方法得到这个类的实例,然后 用addMovement(MotionEvent)函数将你接受到的motion event加入到VelocityTracker类实例中。当你使用到速率时,使用computeCurrentVelocity(int)初始化速率的单位,并获得当前的事件的速率,然后使用getXVelocity() 或getXVelocity()获得横向和竖向的速率。
从上面的介绍中,我们就可以很简单的明白,如何去使用VelocityTracker类去追踪一个移动事件的速率。
用法详解:
1、 //首先获得VelocityTracker的实例
/**
* obtain()的方法介绍
* Retrieve a new VelocityTracker object to watch the velocity of a motion.
* Be sure to call recycle() when done. You should generally only maintain
* an active object while tracking a movement, so that the VelocityTracker
* can be re-used elsewhere.
* 翻译:
* 得到一个速率追踪者对象去检测一个事件的速率。确认在完成的时候调用recycle()方法。
* 一般情况下,你只要维持一个活动的速率追踪者对象去追踪一个事件,那么,这个速率追踪者
* 可以在别的地方重复使用。
*/
VelocityTracker mVelocityTracker = null;
if (mVelocityTracker == null) {
mVelocityTracker = VelocityTracker.obtain();
}
2、 //假设有一个事件event,将事件加入到VelocityTracker类实例中
/**
* addMovement (MotionEvent event)方法介绍
* Add a user's movement to the tracker. You should call this for the initial
* ACTION_DOWN, the following ACTION_MOVE events that you receive,
* and the final ACTION_UP. You can, however, call this for whichever events
* you desire.
* 翻译:向速率追踪者中加入一个用户的移动事件,你应该最先在ACTION_DOWN调用这个方法,
* 然后在你接受的ACTION_MOVE,最后是ACTION_UP。你可以为任何一个你愿意的事件调用该方法
*/
mVelocityTracker.addMovement(event);
3、//判断当事件MotionEvent.ACTION_UP的时候,调用下面的方法
/**
* public void computeCurrentVelocity (int units, float maxVelocity)方法介绍:
* Compute the current velocity based on the points that have been
* collected. Only call this when you actually want to retrieve velocity
* information, as it is relatively expensive. You can then retrieve the
* velocity with {@link #getXVelocity()} and {@link #getYVelocity()}.
*
* @param units
* The units you would like the velocity in. A value of 1
* provides pixels per millisecond, 1000 provides pixels per
* second, etc.
* @param maxVelocity
* The maximum velocity that can be computed by this method. This
* value must be declared in the same unit as the units
* parameter. This value must be positive.
* 翻译:基于你所收集到的点计算当前的速率。 当你确定要获得速率信息的时候,在调用该方法,
* 因为使用它需要消耗很大的性能。然后,你可以通过getXVelocity()和getYVelocity()获得横向和竖向的速率。
*
* 参数:units 你想要指定的得到的速度单位,如果值为1,代表1毫秒运动了多少像素。如果值为1000,代表
* 1秒内运动了多少像素。
*
* 参数:maxVelocity 该方法所能得到的最大速度,这个速度必须和你指定的units使用同样的单位,而且
* 必须是整数。(也就是,你指定一个速度的最大值,如果计算超过这个最大值,就使用这个最大值,否则,使用计算的的结果)
*
* public void computeCurrentVelocity (int units)方法介绍
* 这个方法与上面的方法没什么差别,就是在maxVelocity上,他会自动使用Float.MAX_VALUE常量
*/
mVelocityTracker.computeCurrentVelocity(1000, mMaximumFlingVelocity);
4、//然后调用getXVelocity ()、getXVelocity (int id)、getYVelocity ()、getYVelocity (int id)得到速率
/**
* 调用这几个方法之前,必须确定你之前调用了computeCurrentVelocity方法。
* 参数 id 代表返回指定触点的速率
*/
Log.i("test", mVelocityTracker.getXVelocity() + "");
Log.i("test", mVelocityTracker.getYVelocity() + "");
在附上一个使用实例:
public class GestureTestActivity extends Activity {
private GestureDetector gestureDetector;
private VelocityTracker mVelocityTracker = null;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
gestureDetector = new GestureDetector(this, new GestureListener());
gestureDetector.setIsLongpressEnabled(false);
}
@Override
public boolean onTouchEvent(MotionEvent event) {
int action = event.getAction();
if (mVelocityTracker == null) {
mVelocityTracker = VelocityTracker.obtain();
}
mVelocityTracker.addMovement(event);
switch (action) {
case MotionEvent.ACTION_DOWN:
Log.i("test", "ACTION_DOWN");
break;
case MotionEvent.ACTION_MOVE:// 移动的时候
Log.i("test", "ACTION_MOVE");
break;
case MotionEvent.ACTION_UP:
mVelocityTracker.computeCurrentVelocity(1000);
Log.i("test", "ACTION_UP");
Log.i("11111", mVelocityTracker.getXVelocity(0) + "");
Log.i("11111", mVelocityTracker.getYVelocity(0) + "");
break;
}
return gestureDetector.onTouchEvent(event);
}
// 继承于SimpleOnGestureListener,实现所有事件监听方法
private class GestureListener extends SimpleOnGestureListener {
@Override
public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
Log.i("test", "onFling -----------------------");
Log.i("2222", velocityX + "");
Log.i("2222", velocityY + "");
return super.onFling(e1, e2, velocityX, velocityY);
}
}
@Override
protected void onDestroy() {
super.onDestroy();
//释放
mVelocityTracker.recycle();
mVelocityTracker=null;
}
}
VelocityTracker的用法已经介绍完了,在我们的实际应用中,VelocityTracker类可能使用的不是很多,只需要了解上面的即可。