Androidで外部のタイマーアプリを起動するコード例【ACTION_SET_TIMER】

Androidアプリから、指定時間後にタイマーとか設定したい場合・・・

やり方は大きく分けて２つあります。

全て自前で実装する
外部アプリを起動する

１つめの方法もアリだけど、すごく手間と時間がかかって非現実です。
（あと自前で実装するとバグとか不具合の温床にもなりやすい）

そこでアプリから外部のタイマーを呼び出す方法を紹介！

やっぱり自分で実装するより、他アプリの力を借りる方が楽です。

このページの目次

外部タイマーアプリを呼び出す基本手順
- １．まずパーミッションを追加
- ２．タイマー起動用のIntentを発行
タイマー設定完了後に結果を受け取るには・・・
タイマー呼び出しの手順まとめ

外部タイマーアプリを呼び出す基本手順

その手順とコード例は次の通り

１．まずパーミッションを追加

AndroidManifest.xml を開き、以下のパーミッションを追加

<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />

1	<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />

これがないと外部タイマーアプリを起動できません。

なので追加するのを忘れずに

２．タイマー起動用のIntentを発行

そうしたら指定時間後にタイマーを起動させるコードを書きます。

ポイントは ACTION_SET_TIME を指定すること

これを Intent#setAction に指定することで、タイマーアプリが存在していれば、指定秒とか指定分後に自動でアラーム起動とかができます。

ここでは１０秒後にタイマーアプリを起動する処理を書いてみました。

▼ こんな感じのコードを書けばOK（ Activity#onCreate内）

Intent alarmIntent = new Intent(AlarmClock.ACTION_SET_TIMER);
String extraMsg = getString( R.string.label_finished_meditation);
alarmIntent.putExtra( AlarmClock.EXTRA_MESSAGE, extraMsg );
alarmIntent.putExtra( AlarmClock.EXTRA_LENGTH, secssForAlerm );
alarmIntent.putExtra( AlarmClock.EXTRA_SKIP_UI, true );
try {
    startActivity( alarmIntent );
} catch ( ActivityNotFoundException e ) {
    /// タイマー起動に失敗しないときの処理
    /// あるいはタイマーアプリがない時の処理
}

Intent alarmIntent = new Intent(AlarmClock.ACTION_SET_TIMER);

String extraMsg = getString( R.string.label_finished_meditation);

alarmIntent.putExtra( AlarmClock.EXTRA_MESSAGE, extraMsg );

alarmIntent.putExtra( AlarmClock.EXTRA_LENGTH, secssForAlerm );

alarmIntent.putExtra( AlarmClock.EXTRA_SKIP_UI, true );

try {

startActivity( alarmIntent );

} catch ( ActivityNotFoundException e ) {

/// タイマー起動に失敗しないときの処理

/// あるいはタイマーアプリがない時の処理

}

ここで大事なポイントは次の３つ

EXTRA_MESSAGE
タイマーアプリ側で表示したいテキスト。これを設定しておかないと、ユーザーが「え？なんでタイマー鳴ってんの？ (#^.^#) 」と混乱してしまう。
EXTRA_LENGTH
タイマーが時間切れになるまでの時間。単位は "秒" でこれ以外の単位は使えない
EXTRA_SKIP_UI
もしこの値が true ならタイマーのUIを非表示、もし false ならタイマーアプリが即起動する。基本的には true に設定しておくのがいいかも

ちなみに ACTION_SET_TIMER に渡せるパラメーターはこの３つだけです。

あとタイマーの時間設定は秒数指定のみってことも気を付けないとダメですね。

これで指定秒数が経過したあとにアラームが起動するはず

▼ 自分のAndroid端末だとこんなアプリが起動した

普通にアラームが起動するのではなく、上画像のように「タイマー終了だよ」みたいなメッセージまで表示できるので気が利いてます。

ただし！特殊な端末によってはタイマーアプリがない場合もあります。

なので外部アプリが存在しない場合の処理も忘れずに・・・（ ActivityNotFoundException の例外処理）

タイマー設定完了後に結果を受け取るには・・・

ただし、今紹介した方法だとタイマー設定したらActivity側では検知不可能

アプリ側で設定結果を受け取ることができません。

なので、ついでに Activity側でタイマー設定の結果を受け取る方法も紹介します。

その手順とかコード例は次の通り

１．まずActiivty内で適当なリクエストコードを定数宣言

public static final int REQ_CODE_ALARM = 1;

1	public static final int REQ_CODE_ALARM = 1;

２．タイマーIntent を startActivityFroResult から起動

Intent alarmIntent = new Intent(AlarmClock.ACTION_SET_TIMER);
String extraMsg = getString( R.string.label_finished_meditation);
alarmIntent.putExtra( AlarmClock.EXTRA_MESSAGE, extraMsg );
alarmIntent.putExtra( AlarmClock.EXTRA_LENGTH, secssForAlerm );
alarmIntent.putExtra( AlarmClock.EXTRA_SKIP_UI, true );
try {
    startActivityForResult( alarmIntent, REQ_CODE_ALARM );
} catch ( ActivityNotFoundException e ) { 
    /// タイマー起動に失敗しないときの処理 
    /// あるいはタイマーアプリがない時の処理
}