Android VelocityTracker

public final class

VelocityTracker

extends   Object

java.lang.Object
↳	android.view.VelocityTracker

Class Overview

---

Helper for tracking the velocity of touch events, for implementing flinging and other such gestures. Use 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 addMovement(MotionEvent). When you want to determine the velocity call computeCurrentVelocity(int) and then call getXVelocity(int) and getYVelocity(int) to retrieve the velocity for each pointer id.

VelocityTracker从字面意思理解那就是速度追踪器了，在滑动效果的开发中通常都是要使用该类计算出当前手势的初始速度(不知道我这么理解是否正确，对应的方法是velocityTracker.computeCurrentVelocity(1000, mMaximumVelocity))并通过getXVelocity或getYVelocity方法得到对应的速度值initialVelocity，并将获得的速度值传递给Scroller类的fling(int startX, int startY, int velocityX, int velocityY, int minX, int maxX, int minY, int maxY) 方法进行控件滚动时各种位置坐标数值的计算,API中对fling 方法的解释是基于一个fling手势开始滑动动作,滑动的距离将由所获得的初始速度initialVelocity来决定。

测试例子：

public class MainActivity extends Activity {

	 private TextView mInfo;  
	  
	    private VelocityTracker mVelocityTracker;  
	    private int mMaxVelocity;  
	  
	    private int mPointerId;  
	  
	    @Override  
	    protected void onCreate(Bundle savedInstanceState) {  
	        super.onCreate(savedInstanceState);  
	  
	        mInfo = new TextView(this);  
	        mInfo.setLines(4);  
	        mInfo.setLayoutParams(new LayoutParams(LayoutParams.FILL_PARENT, LayoutParams.FILL_PARENT));  
	        mInfo.setTextColor(Color.BLACK);  
	  
	        setContentView(mInfo);  
	  
	        mMaxVelocity = ViewConfiguration.get(this).getScaledMaximumFlingVelocity();
	    }  
	  
	    @Override  
	    public boolean onTouchEvent(MotionEvent event) {  
	        final int action = event.getAction();  
	        acquireVelocityTracker(event);  
	        final VelocityTracker verTracker = mVelocityTracker;  
	        switch (action) {  
	            case MotionEvent.ACTION_DOWN:  
	                //求第一个触点的id， 此时可能有多个触点，但至少一个  
	                mPointerId = event.getPointerId(0);  
	                break;  
	  
	            case MotionEvent.ACTION_MOVE:  
	                //求伪瞬时速度  
	                verTracker.computeCurrentVelocity(1000, mMaxVelocity);  
	                final float velocityX = verTracker.getXVelocity(mPointerId);  
	                final float velocityY = verTracker.getYVelocity(mPointerId);  
	                recodeInfo(velocityX, velocityY);  
	                break;  
	  
	            case MotionEvent.ACTION_UP:  
	                releaseVelocityTracker();  
	                break;  
	  
	            case MotionEvent.ACTION_CANCEL:  
	                releaseVelocityTracker();  
	                break;  
	  
	            default:  
	                break;  
	        }  
	        return super.onTouchEvent(event);  
	    }  
	  
	    /**  
	     *  
	     * @param event 向VelocityTracker添加MotionEvent  
	     *  
	     * @see android.view.VelocityTracker#obtain()  
	     * @see android.view.VelocityTracker#addMovement(MotionEvent)  
	     */  
	    private void acquireVelocityTracker(final MotionEvent event) {  
	        if(null == mVelocityTracker) {  
	            mVelocityTracker = VelocityTracker.obtain();  
	        }  
	        mVelocityTracker.addMovement(event);  
	    }  
	  
	    /**  
	     * 释放VelocityTracker  
	     *  
	     * @see android.view.VelocityTracker#clear()  
	     * @see android.view.VelocityTracker#recycle()  
	     */  
	    private void releaseVelocityTracker() {  
	        if(null != mVelocityTracker) {  
	            mVelocityTracker.clear();  
	            mVelocityTracker.recycle();  
	            mVelocityTracker = null;  
	        }  
	    }  
	  
	    private static final String sFormatStr = "velocityX=%f\nvelocityY=%f";  
	  
	    /**  
	     * 记录当前速度  
	     *  
	     * @param velocityX x轴速度  
	     * @param velocityY y轴速度  
	     */  
	    private void recodeInfo(final float velocityX, final float velocityY) {  
	        final String info = String.format(sFormatStr, velocityX, velocityY);  
	        mInfo.setText(info);  
	    }  

}