AlarmManager.Set メソッド

定義

名前空間:: Android.App

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

Name	説明
Set(AlarmType, Int64, String, AlarmManager+IOnAlarmListener, Handler)	set(int,long,PendingIntent) の直接コールバックバージョン。
Set(AlarmType, Int64, PendingIntent)	アラームをスケジュールします。

Set(AlarmType, Int64, String, AlarmManager+IOnAlarmListener, Handler)

set(int,long,PendingIntent) の直接コールバックバージョン。

[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

int: アラームの種類。値は次のいずれかです。RTC ELAPSED_REALTIME_WAKEUP ELAPSED_REALTIME RTC_WAKEUP

triggerAtMillis: Int64

long: 適切なクロックを使用してアラームをオフにする必要がある時間 (ミリ秒単位)。

tag: String

文字列: アラームを記述する文字列。ログ記録とバッテリ使用属性に使用されます。この値は null である可能性があります。

listener: AlarmManager.IOnAlarmListener

AlarmManager.OnAlarmListener: アラーム時間に達すると onAlarm() メソッドが呼び出される OnAlarmListener インスタンス。特定の OnAlarmListener インスタンスは、一度に 1 つのアラームでのみ使用できる PendingIntent と同様に、1 つの保留中のアラームのターゲットに限定できます。この値は null にすることはできません。

targetHandler: Handler

ハンドラー: リスナーの onAlarm() コールバックを実行するハンドラー。メインルーパーでそのコールバックを実行する場合は null。

属性: RegisterAttribute

注釈

set(int,long,PendingIntent) の直接コールバックバージョン。アラーム時刻に達したときに送信される PendingIntent を指定するのではなく、このバリアントは、その時点で呼び出される OnAlarmListener インスタンスを提供します。呼び出し元のプロセスで Activity、Service、ContentProvider などのコンポーネントが実行されなくなった場合は、リスナーベースのアラームが Android システムによって取り消される可能性があるため、現在のコンポーネントが完了した後にアラームを受信する必要がない場合にのみこれらの API を使用し、その場合はキャンセル (OnAlarmListener) を行ってください。たとえば、アクティビティからこれらの API を使用する場合は、アクティビティの終了時にそれぞれのアラームを取り消してください。その後もアラームを受信する必要がある場合は、PendingIntent ベースの API を使用します。 OnAlarmListener の onAlarm() メソッドは、指定されたターゲットハンドラーを介して呼び出されます。null が targetHandler パラメーターとして渡された場合は、アプリケーションのメインルーパーで呼び出されます。

android.app.AlarmManager.setの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象

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()から取得されます。

属性: RegisterAttribute

注釈

アラームをスケジュールします。注: タイミング操作 (ティック、タイムアウトなど) の場合、Handler を使用する方が簡単で効率的です。同じ IntentSender に対して既にアラームがスケジュールされている場合、その前のアラームは最初に取り消されます。指定されたトリガー時間が過去の場合、アラームはすぐにトリガーされます。 (Intent.filterEquals によって定義されている 2 つの意図の等価性を持つ) スケジュールされたこの意図のアラームが既にある場合は、削除され、この意図に置き換えられます。アラームは、Context.registerReceiver(BroadcastReceiver, IntentFilter) または AndroidManifest.xml ファイル内の <receiver> タグを介して登録したブロードキャストレシーバーに送信されるインテントブロードキャストです。アラームインテントは、このインテントブロードキャストに蓄積された過去のアラームイベントの数を示すIntent.EXTRA_ALARM_COUNTと呼ばれるタイプintのデータを追加して配信されます。電話がスリープ状態だったために配信されなくなった定期的なアラームは、配信時に 1 つ以上のカウントを持つ場合があります。注: API 19 以降では、このメソッドに渡されるトリガー時間は不正確として扱われます。アラームはこの時刻より前には配信されませんが、しばらくしてから遅延して配信される可能性があります。 OS では、システム全体でアラームを "バッチ処理" するためにこのポリシーを使用します。これにより、デバイスが "ウェイクアップ" する必要がある回数を最小限に抑え、バッテリの使用を最小限に抑えます。一般に、近い将来に予定されているアラームは、将来予定されている限り延期されません。新しいバッチ処理ポリシーでは、配信順序の保証は以前ほど強力ではありません。アプリケーションが複数のアラームを設定した場合、これらのアラームの実際の配信順序が、要求された配信時間の順序と一致しない可能性があります。アプリケーションに厳密な順序要件がある場合は、必要な動作を取得するために使用できる他の API があります。setWindow(int,long,long,PendingIntent) と setExact(int,long,PendingIntent) を参照してください。 targetSdkVersion が API 19 より前のアプリケーションでは、引き続き以前のアラーム動作が取得されます。スケジュールされたすべてのアラームは正確に扱われます。

適用対象