AmazonスタイラスSDKを使用した開発の概要

    /**
     * 予測タッチエンジンを初期化します。
     * アプリ／プロセスでこの呼び出しを行うのは、事前に明示的に解除した場合を除き、一度だけにする必要があります。
     * 複数回呼び出すことによるメリットはなく、同じプロセスからの重複登録が原因で
     * 予測がアプリに配信されなくなる場合があります。
     * @param ctx アプリのコンテキスト。
     */
    public static void init(Context ctx);
    
    /**
     * 必ずこのメソッドを呼び出して、実行時にデバイスで予測タッチがサポートされているか
     * どうかを確認してください。サポートされていない場合、ほかのAPIは役に立たないため、
     * アプリから呼び出さないようにすることができます。
     * @param ctx アプリのコンテキスト。
     * @return このデバイスで機能がサポートされている場合はtrue、それ以外の場合はfalse。
     */
    public static boolean isFeatureRuntimeAvailable(Context ctx);
    
    /**
     * アプリが以前に予測タッチの登録を解除していて再登録が必要な場合に、予測タッチを
     * 手動で登録します。
     * @return 機能がサポートされていて、既に登録されているか登録に成功した場合はtrue、
     * それ以外の場合はfalse。
     */
    public static boolean registerPredictiveTouches();
    
    /**
     * アプリで予測が必要なくなった場合に、予測タッチを手動で登録解除します。
     * @return 機能がサポートされていて、現在登録されていないか登録解除に成功した場合は
     * true、それ以外の場合はfalse。
     */
    public static boolean deregisterPredictiveTouches();
    
    /**
     * アプリで予測が登録済みかどうかを確認します。
     * @return 登録済みの場合はtrue、それ以外の場合はfalse。
     */
    public static boolean isPredictiveTouchesRegistered();
    
    /**
     * アプリで予測が必要なビューを設定します。
     * @param view アプリで予測を使用するビュー。nullにすることはできません。
     */
    public static void setCurrentView(View v);
    
    /**
     * アルゴリズムからPredictiveTouchManagerに送られて格納された最新の予測を取得します。
     * 機能がサポートされていない場合、または予測がない場合はnullを返します。
     * @param t アプリが保持している最新のイベントタイムスタンプ。tより後の予測を取得します。
     * @return 予測が格納された{@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がサポートされていません");
    }
}

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がサポートされていません");
        }
    }
}

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: {
  
                // 現在の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); // 現在のストロークにポイントを追加
                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();
  
        // 最新の予測がある場合、それらをパスに追加します。
        if (mCurrentMoveTime != -1 /*有効な移動*/ && latestPred != null
                && latestPred.getNumberOfPredictions() != 0) {
            Log.i(TAG,
                    "描画開始 イベント時間：" + 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, "描画終了 イベント時間：" + mCurrentMoveTime + " currentTime " + SystemClock.uptimeMillis());
        }
        super.onDraw(canvas);
    }
}

import com.amazon.stylussupportsdk.predictedtouches.AmazonPredictiveTouch;
  
public class MainActivity extends Activity {
 
    // オプション：以下のようにすると、アプリがバックグラウンドに移行したときに予測を停止して予測タッチのメモリフットプリントを削減できます。
    @Override
    protected void onPause() {
        AmazonPredictiveTouch.deregisterPredictiveTouches();
        super.onPause();
    }
     
    // 以下は、プロセスの存続中に破棄される可能性のあるコンポーネント（アクティビティやビューなど）で必須です。
    @Override
    protected void onDestroy() {
        AmazonPredictiveTouch.deregisterPredictiveTouches();
        super.onDestroy();
    }
}