滑轮控件研究四、VelocityTracker的简单研究

下面是Google对该类的描述：

[java]
view plaincopy

/**
* 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类去追踪一个移动事件的速率。

用法详解：

[java]
view plaincopy

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() + "");

在附上一个使用实例：

[java]
view plaincopy

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类可能使用的不是很多，只需要了解上面的即可。