AlarmManager.Set メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
Set(AlarmType, Int64, String, AlarmManager+IOnAlarmListener, Handler) | |
Set(AlarmType, Int64, PendingIntent) |
アラームをスケジュールします。 |
Set(AlarmType, Int64, String, AlarmManager+IOnAlarmListener, Handler)
[Android.Runtime.Register("set", "(IJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSet_IJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)]
public virtual void Set (Android.App.AlarmType type, long triggerAtMillis, string? tag, Android.App.AlarmManager.IOnAlarmListener listener, Android.OS.Handler? targetHandler);
[<Android.Runtime.Register("set", "(IJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSet_IJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)>]
abstract member Set : Android.App.AlarmType * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit
override this.Set : Android.App.AlarmType * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit
パラメーター
- type
- AlarmType
- triggerAtMillis
- Int64
- tag
- String
- listener
- AlarmManager.IOnAlarmListener
- targetHandler
- Handler
- 属性
注釈
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
Set(AlarmType, Int64, PendingIntent)
アラームをスケジュールします。
[Android.Runtime.Register("set", "(IJLandroid/app/PendingIntent;)V", "GetSet_IJLandroid_app_PendingIntent_Handler")]
public virtual void Set (Android.App.AlarmType type, long triggerAtMillis, Android.App.PendingIntent operation);
[<Android.Runtime.Register("set", "(IJLandroid/app/PendingIntent;)V", "GetSet_IJLandroid_app_PendingIntent_Handler")>]
abstract member Set : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit
override this.Set : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit
パラメーター
- type
- AlarmType
アラームの種類。
- triggerAtMillis
- Int64
(アラームの種類に応じて) 適切なクロックを使用して、アラームが消える時間 (ミリ秒単位)。
- operation
- PendingIntent
アラームがオフになったときに実行するアクション。通常は から PendingIntent#getBroadcast
IntentSender.getBroadcast()
取得されます。
- 属性
注釈
アラームをスケジュールします。 <b>注: タイミング操作 (ティック、タイムアウトなど) の場合は、 を使用 android.os.Handler
する方が簡単で効率的です。</b> 同じ IntentSender に対して既にアラームがスケジュールされている場合、その前のアラームは最初に取り消されます。
指定されたトリガー時間が過去の場合、アラームはすぐにトリガーされます。 (によって Intent#filterEquals
定義されている 2 つの意図の等価性を持つ) スケジュールされたこの意図のアラームが既にある場合は、削除され、この 1 つに置き換えられます。
アラームは、< で登録した android.content.Context#registerReceiver
ブロードキャスト レシーバーに送信されるインテント ブロードキャストです。レシーバー>タグを AndroidManifest.xml ファイルに含めます。
アラームインテントは、このインテントブロードキャストに蓄積された過去のアラームイベントの数を示す int 型 Intent#EXTRA_ALARM_COUNT Intent.EXTRA_ALARM_COUNT
の追加データと共に配信されます。 電話が眠っていたために配信不能になった定期的なアラームは、配信時にカウントが 1 より大きい場合があります。
<div class="note">
<b>注:</b> API 19 以降、このメソッドに渡されるトリガー時間は、実際には扱われません。アラームはこの時刻より前には配信されませんが、遅延してしばらくしてから配信される可能性があります。 OS では、システム全体でアラームを "バッチ" するためにこのポリシーを使用し、デバイスが "ウェイクアップ" する必要がある回数を最小限に抑え、バッテリーの使用を最小限に抑えます。 一般に、近い将来に予定されているアラームは、将来予定されている限り延期されません。
新しいバッチ処理ポリシーでは、配信順序の保証は以前ほど強力ではありません。 アプリケーションが複数のアラームを設定した場合、これらのアラームの<>実際</em 配信順序が、em 要求</em>> 配信時間の<>順序と一致しない可能性があります。 アプリケーションの順序要件が強い場合は、必要な動作を取得するために使用できる他の API があります。と を#setExact(int, long, PendingIntent)
参照してください#setWindow(int, long, long, PendingIntent)
。
targetSdkVersion
API 19 より前の アプリケーションでは、以前のアラーム動作が引き続き取得されます。スケジュールされたすべてのアラームは正確に扱われます。 </部>
の Java ドキュメント android.app.AlarmManager.set(int, long, android.app.PendingIntent)
。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
こちらもご覧ください
- Handler
- <xref:Android.App.AlarmManager.SetExact(Android.App.AlarmType%2c+System.Int64%2c+System.Int64)>
- <xref:Android.App.AlarmManager.SetRepeating(Android.App.AlarmType%2c+System.Int64%2c+System.Int64%2c+System.Int64)>
- <xref:Android.App.AlarmManager.SetWindow(Android.App.AlarmType%2c+System.Int64%2c+System.Int64%2c+System.Int64)>
- Cancel(PendingIntent)
- SendBroadcast(Intent)
- <xref:Android.Content.Context.RegisterReceiver(Android.Content.BroadcastReceiver%2c+Android.Content.IntentFilter)>
- FilterEquals(Intent)