コメント
コメントの投稿
※名前とタイトルが入力されていないコメントでは他のコメントとの区別ができません。
入力されていないコメントには返信しませんのであらかじめご了承くださいませ。
AlarmManagerで指定した時間に実行する方法 | Xamarin.Android
- 2017/09/11
- 14:30
今回はAlarmManagerを使用して指定した時間にプログラムを実行する方法についてご紹介いたします。
以前の記事「Androidでスリープ中でもバックグラウンド処理を定期的に実行する方法」でもAlarmManagerを使用して繰り返し実行する方法をご紹介しておりますが、今回は繰り返しではなく、１度きりの実行についてのソースとなります。
前提条件
・Windows10 Pro 64Bit
・Visual Studio 2015 Community Update3
・Xamarin 4.3.0.795 (NuGet Xamarin.Forms 2.3.4.270)
１．パーミッション追加
AndroidManifest.xmlに以下のパーミッションを追加します。AndroidManifest.xml
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />
２．BroadcastReceiverを修正する
以前の記事のBroadcastReceiverを継承したクラスにPowerManager（画面ロックを解除する機能）とAlarmManagerによるリマインダー機能を追加します。BootReceiver.cs
[BroadcastReceiver]
[IntentFilter(new[] { Intent.ActionBootCompleted,
"android.intent.action.QUICKBOOT_POWERON",
"com.htc.intent.action.QUICKBOOT_POWERON",
"android.intent.action.PACKAGE_INSTALL",
"android.intent.action.PACKAGE_ADDED",
Intent.ActionMyPackageReplaced })]
public class BootReceiver : BroadcastReceiver
{
private static PowerManager.WakeLock _wakeLock = null;
public override void OnReceive(Context context, Intent intent)
{
//画面ロックの取得
PowerManager pm = (PowerManager)context.GetSystemService(Context.PowerService);
_wakeLock = pm.NewWakeLock(WakeLockFlags.Partial, "BootReceiver");
_wakeLock.Acquire();
//リマインダーをセット
this.SetReminder(context);
//サービスやアプリの起動
//以前の記事でご紹介済みなので割愛
}
//Android用のリマインダー
public void SetReminder(Context context)
{
Intent alarmIntent = new Intent(context, typeof(BootReceiver));
PendingIntent pendingIntent = PendingIntent.GetBroadcast(context, 0, alarmIntent, PendingIntentFlags.UpdateCurrent);
AlarmManager alarmManager = (AlarmManager)context.GetSystemService(Context.AlarmService);
//AlarmManagerで１時間後に実行を予約する
long fireTimeUtc = DateTimeOffset.UtcNow.AddMilliseconds(60 * 1000 * 60).ToUnixTimeMilliseconds(); //60s*1000ms*60minutes=1hour
if (Build.VERSION.SdkInt >= BuildVersionCodes.M)
{
alarmManager.SetExactAndAllowWhileIdle(AlarmType.RtcWakeup, fireTimeUtc, pendingIntent);
}
else if (Build.VERSION.SdkInt >= BuildVersionCodes.Kitkat)
{
alarmManager.SetExact(AlarmType.RtcWakeup, fireTimeUtc, pendingIntent);
}
else
{
alarmManager.Set(AlarmType.RtcWakeup, fireTimeUtc, pendingIntent);
}
//確実に指定時刻に実行したい場合は
//AlarmManager.AlarmClockInfo alarmClockInfo = new AlarmManager.AlarmClockInfo(fireTime, pendingIntent);
//alarmManager.SetAlarmClock(alarmClockInfo, pendingIntent);
}
public static void ReleaseWakeLock()
{
if (_wakeLock != null)
{
_wakeLock.Release();
}
}
}
Android.App.AlarmType:
| 項目 | 説明 |
|---|---|
| RtcWakeup （値0） | UTC時刻を指定する （スリープ状態のときは電源をONにしてくれる） |
| Rtc （値1） | UTC時刻を指定する |
| ElapsedRealtimeWakeup （値2） | 端末が起動してからの経過時間で指定する （スリープ状態のときは電源をONにしてくれる） |
| ElapsedRealtime （値3） | 端末が起動してからの経過時間で指定する |
※AlarmManagerは端末を再起動すると予約されているスケジュールは無効となってしましいますが、Intent.ActionBootCompletedにより再起動後に再度スケジューリングができます。
※端末のAndroidバージョンによりAlarmManagerのセットメソッドが異なるため、バージョンの分岐が必要です。
※Dozeモードの影響を受けずに確実に指定した時刻に正確に実行するためには、以前の記事「Dozeのホワイトリストにアプリを登録する方法」でご紹介しています内容を実装し、AlarmManagerのSetAlarmClockメソッドを利用します。ただし、SetAlarmClockメソッドにより、端末の画面上部に目覚まし時計のマークが表示されます。
※繰り返し実行する場合は、以前の記事「バックグラウンド処理を定期的に実行する方法」をご参考ください。
３．トラブルシューティング
AlarmManagerが正しく動作しない場合は以下を確認してください。（１）正しく予約されているかどうかを確認する方法はadbコマンドプロンプトから以下のコマンドを入力します。
adb shell dumpsys alarm
（２）AndroidManifest.xmlのminSdkVersionを確認してください。
ターゲットAndroidバージョンにより動作するかどうかも変化するようです。
最後までお読みいただきありがとうございます。
当ブログの内容をまとめた Xamarin逆引きメニュー は以下のURLからご覧になれます。
https://itblog.dynaspo.com/blog-entry-81.html
- 関連記事
-
- 画像データからピクセル毎のRGB配列を取得する方法 | Xamarin.Forms
- 写真や画像データをフォトアルバムに保存する方法 | Xamarin.iOS
- AlarmManagerで指定した時間に実行する方法 | Xamarin.Android
- Android6 Marshmallow以降のパーミッションについて | Xamarin.Forms
- Dozeのホワイトリストにアプリを登録する方法 | Xamarin.Android
