Amazon Stylus SDK入门

    /**
     *初始化Predictive Touch引擎。
     *一个应用/进程应该只调用一次，除非它们之前明确取消注册。
     *多次调用并没什么作用，并可能因为来自同一进程的重复注册而导致无法将
     *预测传递至应用。
     * @param上下文 - 应用的上下文。
     */
    public static void init(Context ctx);
    
    /**
     *务必调用此方法以了解设备在运行时
     *是否支持Predictive Touch。如果不支持，应用可以避免调用其他API，
     *因为这些API没有用处
     * @param上下文 - 应用的上下文。
     * @如果此设备支持功能，则返回true，否则返回false
     */
    public static boolean isFeatureRuntimeAvailable(Context ctx);
    
    /**
     *手动注册以获取Predictive Touch，以防应用过早注销
     *并需要重新注册
     * @如果支持功能并且我们已经注册或注册成功，则返回true，
     *否则返回false
     */
    public static boolean registerPredictiveTouches();
    
    /**
     * 在应用不需要预测的情况下手动取消注册Predictive Touch
     * @如果支持功能并且我们尚未注册或取消注册成功，则返回true，
     *否则返回false
     */
    public static boolean deregisterPredictiveTouches();
    
    /**
     *让应用检查是否已注册预测
     * @如果已注册则返回true，否则返回false
     */
    public static boolean isPredictiveTouchesRegistered();
    
    /**
     * 让应用设置需要预测的视图
     * @param视图 - 应用将在其中使用预测的视图应为非null
     */
    public static void setCurrentView(View v);
    
    /**
     *要获取存储在PredictiveTouchManager中的最新预测，可从算法接收
     *如果该功能不受支持，或者我们没有任何预测，此项将返回null
     * @param t - 应用具有的最新事件时间戳，用于获取t之后的预测
     * @返回包含预测的{@link AmazonPredictedEvents}对象，或者如果未收到任何预测，
     *则返回null。
     */
    public static AmazonPredictedEvents getLatestPredictions(long t);
}

import com.amazon.stylussupportsdk.predictedtouches.AmazonPredictiveTouch;
 
private boolean isPredictiveTouchesSupported() {
        /*示例实现*/
        return AmazonPredictiveTouch.isFeatureRuntimeAvailable(this) == true;
}
 
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    ..........
    ..........
    if (isPredictiveTouchesSupported()) {
        // PredictiveTouches应该可用。此处
        // 为初始化和注册预测的代码
    }
    else {
        // PredictiveTouches不可用。将其写入日志消息
        Log.w(TAG, "PredictiveTouches is not supported");
    }
}

import com.amazon.stylussupportsdk.predictedtouches.AmazonPredictiveTouch;
 
public class MainActivity extends Activity {
      
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        ..........
        ..........
        if (isPredictiveTouchesSupported()) {
            // PredictiveTouches应该可用。此处
            // 为初始化和注册预测的代码
            AmazonPredictiveTouch.init(MainActivity.this);
        }
        else {
            // PredictiveTouches不可用。将其写入日志消息
            Log.w(TAG, "PredictiveTouches is not supported");
        }
    }
}

import com.amazon.stylussupportsdk.predictedtouches.AmazonPredictiveTouch;
 
public class MainActivity extends Activity {
  
    @Override
    protected void onResume() {
        super.onResume();
        //假设在恢复时，用户将进行书写/绘图等操作，并且我们之前进行了取消注册，
        //因此需要注册预测。
        AmazonPredictiveTouch.registerPredictiveTouches();
        .............
        .............
    }
}

import com.amazon.stylussupportsdk.predictedtouches.AmazonPredictiveTouch;

public class TouchDisplayView extends View {

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        //现有代码
        final int action = event.getAction();
        switch (action & MotionEvent.ACTION_MASK) {
            case MotionEvent.ACTION_DOWN: {
                AmazonPredictiveTouch.setCurrentView(this);
                //现有代码
            }
        }
    }
}

import com.amazon.stylussupportsdk.predictedtouches.AmazonPredictiveTouch;
  
public class TouchDisplayView extends View {
  
    private long mCurrentMoveTime = -1;
    private float mLatestX, mLatestY;
    private Path mCurrentStroke = new Path(); // Path to store stroke data
  
    @Override
    public boolean onTouchEvent(MotionEvent event) {
        ............
  
        //设置时间戳-1
        mCurrentMoveTime = -1;
  
        switch (event.getAction() & MotionEvent.ACTION_MASK) {
            .............
            case MotionEvent.ACTION_MOVE: {
  
                //获取当前移动事件的时间戳，以及X、Y值
                mCurrentMoveTime = event.getEventTime();
                mLatestX = event.getX();
                mLatestY = event.getY();
  
                for (i in 0 until event.historySize) {
                    //将历史点添加至当前笔画
                    mCurrentStroke.lineTo(event.getHistoricalX(0, i), event.getHistoricalY(0, i))
                }
                //此处为了举例，我们使用的是lineTo，请根据需要使用自定义绘制逻辑
                mCurrentStroke.lineTo(mLatestX,mLatestY); // add point to current stroke
                this.invalidate();
                break;
            }
            .............
        }
    }
}

import com.amazon.stylussupportsdk.predictedtouches.AmazonPredictiveTouch;
import com.amazon.stylussupportsdk.predictedtouches.AmazonPredictedEvents;
  
public class TouchDisplayView extends View {
      
    @Override
    protected void onDraw(Canvas canvas) {
  
        //获取与mCurrentMoveTime对应的最后预测
        AmazonPredictedEvents latestPred = AmazonPredictiveTouch.getLatestPredictions(mCurrentMoveTime);
  
        Path predicted = new Path();
  
        //如果最新预测可用，则将预测添加到Path
        if (mCurrentMoveTime != -1 /*valid move*/ && latestPred != null
                && latestPred.getNumberOfPredictions() != 0) {
            Log.i(TAG,
                    "DRAWSTART EVENTTIME: " + mCurrentMoveTime + " currentTime "
                    + SystemClock.uptimeMillis() + " latestPredTime "
                    + latestPred.getEventTimeAt(latestPred.getNumberOfPredictions() - 1));
  
            predicted.moveTo(mLatestX, mLatestY);
            for (int i = 0; i < latestPred.getNumberOfPredictions(); i++) {
                //此处为了举例，我们使用的是lineTo，请根据需要使用自定义绘制逻辑
                if (latestPred.getXAt(i) > -1.0f && latestPred.getYAt(i) > -1.0f)
                    predicted.lineTo(latestPred.getXAt(i), latestPred.getYAt(i));
            }
        }
  
        //首先清除画布，这样最后预测的点会被擦除，就不会有不需要的人为痕迹
        canvas.drawColor(Color.WHITE);
 
        //绘制实际点
        canvas.drawPath(mCurrentStroke, mPaint);
        //使用另一个Paint对象绘制包含预测的路径，以进行确认
        if (!predicted.isEmpty())
            canvas.drawPath(predicted, mPaintPred);
  
        if (mCurrentMoveTime != -1) {
            Log.i(TAG, "DRAWEND EVENTTIME: " + mCurrentMoveTime + " currentTime " + SystemClock.uptimeMillis());
        }
        super.onDraw(canvas);
    }
}

import com.amazon.stylussupportsdk.predictedtouches.AmazonPredictiveTouch;
  
public class MainActivity extends Activity {
 
    //可选：如果您想在应用处于后台时停止预测，以节省Predictive Touch内存占用量时，可以这样做。
    @Override
    protected void onPause() {
        AmazonPredictiveTouch.deregisterPredictiveTouches();
        super.onPause();
    }
     
    //对于那些在进程仍然存在时可能已终止的组件（如活动、视图等），这是必要操作
    @Override
    protected void onDestroy() {
        AmazonPredictiveTouch.deregisterPredictiveTouches();
        super.onDestroy();
    }
}