[Android] マルチタッチアプリケーションの作り方

How to code multi touch applications

LYNX3D SH-03Cでマルチタッチに反応するアプリケーションを作ってみました。Android2.1以上に対応します。
指でタッチした場所に円を表示します。5本の指まで反応します。
以下サンプルです。

アクティビティー(Main.java) package jp.fujiu.MultiTouch_test; import java.util.ArrayList; import android.app.Activity; import android.content.Context; import android.graphics.Canvas; import android.graphics.Color; import android.graphics.Paint; import android.os.Bundle; import android.os.Handler; import android.os.Message; import android.view.MotionEvent; import android.view.SurfaceHolder; import android.view.SurfaceView; import android.view.SurfaceHolder.Callback; public class Main extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); MultitouchSurface surface = new MultitouchSurface(getApplicationContext()); setContentView(surface); } private static final int[] colors = new int[]{ Color.RED, Color.GREEN, Color.BLUE, Color.YELLOW, Color.CYAN, Color.MAGENTA }; private class MultitouchSurface extends SurfaceView implements Callback { //円の情報を保持するクラス private class Circle{ int pointerId; int color; float x; float y; boolean isExists = true; } private ArrayList<Circle> circles = new ArrayList<Circle>(); private static final int BG_COLOR = Color.WHITE; private static final float FONT_SIZE = 20f; private Message msg; private SurfaceHolder holder; private Paint paint; private int pointCount = 0; private int upDownCounter = 0; private float circleInches; //円の大きさ（インチ） public MultitouchSurface(Context context) { super(context); getHolder().addCallback(this); } @Override public void surfaceCreated(SurfaceHolder holder) { this.holder = holder; paint = new Paint(); paint.setTextSize(FONT_SIZE); msg = new Message(); handler.sendMessage(msg); circleInches = getResources().getDisplayMetrics().density * 50f; } @Override public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) { } @Override public void surfaceDestroyed(SurfaceHolder holder) { getHolder().removeCallback(this); } @Override synchronized public boolean onTouchEvent(MotionEvent event) { int size; pointCount = event.getPointerCount(); switch (event.getAction()){ case MotionEvent.ACTION_DOWN: case MotionEvent.ACTION_POINTER_DOWN: case MotionEvent.ACTION_POINTER_2_DOWN: case MotionEvent.ACTION_POINTER_3_DOWN: case 0x305: case 0x405: //指を置いたときの処理 //PointerIdの重複のチェック size = circles.size(); for (int p = 0; p < pointCount; p++) { boolean isNotExists = true; for (int i=size-1; i>-1; i--){ if (circles.get(i).pointerId == event.getPointerId(p)){ isNotExists = false; break; } } //追加処理 if (isNotExists){ Circle circle = new Circle(); circle.pointerId = event.getPointerId(p); circle.x = event.getX(p); circle.y = event.getY(p); circle.color = colors[(circle.pointerId+colors.length) % colors.length]; circles.add(circle); } } upDownCounter++; break; case MotionEvent.ACTION_UP: case MotionEvent.ACTION_POINTER_UP: case MotionEvent.ACTION_POINTER_2_UP: case MotionEvent.ACTION_POINTER_3_UP: case 0x306: case 0x406: //指を離したときの処理 upDownCounter--; if (upDownCounter>0){ //無くなったPointerIdを探して削除する //存在フラグリセット size = circles.size(); for (int i=0; i<size; i++){ circles.get(i).isExists = false; } for (int p = 0; p < pointCount; p++) { //存在チェック size = circles.size(); for (int i=size-1; i>-1; i--){ if (circles.get(i).pointerId == event.getPointerId(p)){ circles.get(i).isExists = true;; //break; } } } //削除 for (int i=size-1; i>-1; i--){ if (circles.get(i).isExists == false){ circles.remove(i); } } } else { //upDownCounterがゼロなら全件削除 circles.removeAll(circles); } StringBuffer evStr = new StringBuffer(); evStr.append("getPointerId:"); for (int p = 0; p < pointCount; p++) { evStr.append(event.getPointerId(p) + ", "); } StringBuffer idStr = new StringBuffer(); idStr.append("id: "); for (int i=0; i<circles.size(); i++){ idStr.append(circles.get(i).pointerId + ", "); } break; case MotionEvent.ACTION_MOVE: //ドラッグ処理 for (int p = 0; p < pointCount; p++) { size = circles.size(); for (int i=0; i<size; i++){ if (circles.get(i).pointerId == event.getPointerId(p)){ circles.get(i).x = event.getX(p); circles.get(i).y = event.getY(p); break; } } } break; } return true; } //メインループ Handler handler = new Handler(){ @Override public void handleMessage(Message msg) { Canvas canvas = holder.lockCanvas(); if (canvas!=null){ //背景塗りつぶし canvas.drawColor(BG_COLOR); //円を描く int size = circles.size(); for (int i=size-1; i>-1; i--){ paint.setColor(circles.get(i).color); canvas.drawCircle(circles.get(i).x, circles.get(i).y, circleInches, paint); } holder.unlockCanvasAndPost(canvas); } sendEmptyMessageDelayed(msg.what, 10); } }; } }
マニフェスト(AndroidManifest.xml) <?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="jp.fujiu.MultiTouch_test" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="7" /> <application android:icon="@drawable/ic_launcher" android:label="MultiTouch test" > <activity android:label="MultiTouch test" android:name=".Main" android:configChanges="keyboardHidden|orientation"> <intent-filter > <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest>

それぞれの円は指の動きを追いかけます。
このアプリを作った時点では、マルチタッチは公式には3本指までしかサポートしていないようで4本以上の指を認識するには隠しパラメータを読み取る必要がありました。（onTouchEventイベントの 0x305 とか 0x036 とか）
実際にタッチしている指の数とAPIの値が一致しないので円が一つ多く表示されることがあります。

MotionEventクラスにはdeprecated（非推奨）にされた定数とメソッドがあるのでご注意ください。
詳細は http://developer.android.com/intl/ja/reference/packages.html をご覧ください。

以上、参考になれば幸いです。

[Application] Wi-Fi sync Screen v1.03公開

Androidアプリケーション Wi-Fi sync Screen v1.03 を公開しました。

"Wi-Fi sync Screen"はWi-Fiスリープを解除した端末のバッテリーを長持ちさせるアプリケーションです。
Android端末をWi-Fi接続すると再起動してしまうAirStationなどをお使いの方におすすめです。
詳細はこちら

v1.03での変更点
・安定性向上

ダウンロードはこちら
※ダウンロード前にエンドユーザーライセンス契約(EULA)を必ずお読みください。
Android Market

◆トラブルシューティング◆
Wi-Fi Sync Screenを設定してもAirstationが再起動する（Wi-Fiルーターが誤動作する）場合は、Android端末のWi-Fiのスリープを解除してください。

Recovered from crash の表示について
Android1.6では画面を開いたとき "Recovered from crash"と表示されることがあります。
リソース不足により動作できなくなったWi-Fi sync Screenを回復したことを意味します。
このメッセージが表示される場合は次の対策を推奨します。
・OSを可能な限り最新版にバージョンアップする
・使用していない常駐アプリケーションを停止する
この機能はv1.03で追加されました。

[Android] 新旧のAndroidで動作するServiceの作り方

How to able to run service applications on all OS versions

ServiceクラスのonStartメソッドはdeprecated（非推奨）に指定され、Android2.1以降では使うべきではないメソッドになってしまいました。
実際にAndroid2.1以降ではonStartメソッドが呼ばれないことがあります。
代替メソッドとしてonStartCommandメソッドが用意されましたが、Android1.6にはonStartCommandメソッドがありません。

1.6以降のどのAndroidでも同じように動作するサービスアプリケーションを作るには、onStartメソッドとonStartCommandメソッドの両方を実装します。
1.6以降のAndroidに対応させるので、プロジェクトのBuild TargetはAndroid1.6(API Level 4)とします。
以下はサンプルです。

サービスクラス(MyService.java)
package jp.fujiu.onStartCommand_test; import android.app.Service; import android.content.Intent; import android.os.IBinder; import android.widget.Toast; public class MyService extends Service { // (1) private static final int START_STICKY = 1; // (2) public int onStartCommand(Intent intent, int flags, int startId){ onStart(intent, startId); return START_STICKY; } /* * Android1.6以前はonStartが呼ばれる */ @Override public void onStart(Intent intent, int startId) { //ここからサービス開始後の処理 Toast.makeText(getApplicationContext(), "MyService has been started", Toast.LENGTH_LONG).show(); } @Override public IBinder onBind(Intent intent) { return null; } }

Activity(Main.java)
package jp.fujiu.onStartCommand_test; import android.app.Activity; import android.content.Intent; public class Main extends Activity { private Intent intent; @Override protected void onResume() { super.onResume(); //サービス起動 intent = new Intent(this, MyService.class); startService(intent); } @Override protected void onPause() { super.onPause(); //サービス停止 stopService(intent); } }

マニフェスト(AndroidManifest.xml)
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="jp.fujiu.onStartCommand_test" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="4" /> <application android:label="onStartCommand test" > <activity android:name=".Main" > <intent-filter > <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <service android:name=".MyService"> </service> </application> </manifest>

このプロジェクトを実行するとActivity（真っ黒の画面）が表示されている間だけMyServiceクラスが起動します。
実行するとAndroid1.6ではonStartメソッドが、Android2.1以降ではOnStartCommandメソッドが呼ばれます。

Build TargetにAndroid1.6をしていたい場合は、onStartCommandメソッドはオーバーライドせずに（@overrideアノテーションを書かずに）コーディングします。
Eclipseを使う場合、[ソース]-[メソッドのオーバーライド] メニューを開いてもonStartCommandメソッドは選べません。メソッド名や引数を間違えないようにAndroidリファレンスからコピーします。

onStartCommandメソッドを使う上で特に注意することがあります。
サービスはOSによってrestartされることがあるのですが、restartされたときに呼ばれるonStartCommandメソッドの引数 intent は null です。
（return START_STICKY; と指定した場合）
Android1.6とAndroid2.xとでは、restartされたときの引数の内容が異なります。

また、Android1.6では「No more background processes」によりrestartされてもonStartメソッドが実行されないことがあります。
Android1.6のサポートが難しくなってきました。

以上、参考になれば幸いです。

[Application] お天気ロイド v1.10公開

Androidアプリケーション お天気ロイド v1.10 を公開しました。

お天気ロイドは最新のWeather Hacks（気象データ配信サービス）をホーム画面に表示してくれるアプリケーションです。

v1.10での変更点
・安定性向上

ダウンロードはこちら
※ダウンロード前にエンドユーザーライセンス契約を必ずお読みください。
Android Market

操作方法
Android Walker様にて動画付きの操作方法が公開されました。

[Application] お天気ロイド v1.09公開

Androidアプリケーション お天気ロイド v1.09 を公開しました。

お天気ロイドは最新のWeather Hacks（気象データ配信サービス）をホーム画面に表示してくれるアプリケーションです。

v1.09での変更点
・Android2.xでの安定性向上

ダウンロードはこちら
※ダウンロード前にエンドユーザーライセンス契約を必ずお読みください。
Android Market

操作方法
Android Walker様にて動画付きの操作方法が公開されました。

[Android] OSをバージョンアップするとアプリが動かなくなる理由

The reason for being unable to run applications on recent OS

古いOSで動いていたアプリケーションが新しいOSで動かなくなる理由を調べてみました。
最近になってAndroidリファレンスを見たら、過去によく使われたメソッドや定数がdeprecated(非推奨)にされていました。

たとえばServiceクラスのonStartは現在deprecatedにされ、API Level 5(Android2.0)以降に実装されたonStartCommandが追加されています。

	1.6以前	2.0以降
onStart	動作する	非推奨
onStartCommand	実装されてない	動作する

Android1.6にも対応させるにはonStartを使いたいところです。
ところがAndroid2.2ではonStartメソッドが呼ばれないことがあるのです。
この挙動の違いが古いOSで動いていたアプリケーションが新しいOSで動かなくなる理由の一つです。

Serviceクラスの他、Intent・Context・Activity・SQLiteDatabase・MotionEventのように頻繁に使うクラスもdeprecatedが散見されます。
deprecatedのメソッドや定数を使ったアプリはOSのバージョンごとに動作が異なる可能性があります。
市販の書籍を参考にしている開発者は要注意です。書籍で紹介されている方法がdeprecatedの可能性があります。

VisualBasic5.0で作られたフリーウェアがWindows7で動いてる姿を見るとOSは互換性を維持することが当たり前に思えるのですが、Androidは違います。
度の端末でも動作するアプリケーションを作るには、アプリをメンテナンスし続ける必要がありそうです。

次回は1.6と2.xに両対応のアプリケーションのサンプルを公開する予定です。→公開しました

以上、参考になれば幸いです。

[Application] お天気ロイド v1.08公開

Androidアプリケーション お天気ロイド v1.08 を公開しました。

お天気ロイドは最新のWeather Hacks（気象データ配信サービス）をホーム画面に表示してくれるアプリケーションです。

v1.08での変更点
・Android2.xでの安定性向上

ダウンロードはこちら
※ダウンロード前にエンドユーザーライセンス契約を必ずお読みください。
Android Market

操作方法
Android Walker様にて動画付きの操作方法が公開されました。

[Application] Wi-Fi sync Screen v1.02公開

Androidアプリケーション Wi-Fi sync Screen v1.02 を公開しました。

"Wi-Fi sync Screen"はWi-Fiスリープを解除した端末のバッテリーを長持ちさせるアプリケーションです。
Android端末をWi-Fi接続すると再起動してしまうAirStationなどをお使いの方におすすめです。
詳細はこちら

v1.02での変更点
・Android2.xでの安定性向上

ダウンロードはこちら
※ダウンロード前にエンドユーザーライセンス契約(EULA)を必ずお読みください。
Android Market

◆トラブルシューティング◆
Wi-Fi Sync Screenを設定してもAirstationが再起動する（Wi-Fiルーターが誤動作する）場合は、Android端末のWi-Fiのスリープを解除してください。