AlarmManager.SetWindow メソッド

定義

名前空間:: Android.App

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

重要

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

オーバーロード

Name	説明
SetWindow(AlarmType, Int64, Int64, PendingIntent)	指定された時間内にアラームを配信するようにスケジュールします。
SetWindow(AlarmType, Int64, Int64, String, AlarmManager+IOnAlarmListener, Handler)	setWindow(int,long,long,PendingIntent) の直接コールバックバージョン。
SetWindow(AlarmType, Int64, Int64, String, IExecutor, AlarmManager+IOnAlarmListener)	setWindow(int,long,long,PendingIntent) の直接コールバックバージョン。

SetWindow(AlarmType, Int64, Int64, PendingIntent)

指定された時間内にアラームを配信するようにスケジュールします。

[Android.Runtime.Register("setWindow", "(IJJLandroid/app/PendingIntent;)V", "GetSetWindow_IJJLandroid_app_PendingIntent_Handler")]
public virtual void SetWindow(Android.App.AlarmType type, long windowStartMillis, long windowLengthMillis, Android.App.PendingIntent operation);

[<Android.Runtime.Register("setWindow", "(IJJLandroid/app/PendingIntent;)V", "GetSetWindow_IJJLandroid_app_PendingIntent_Handler")>]
abstract member SetWindow : Android.App.AlarmType * int64 * int64 * Android.App.PendingIntent -> unit
override this.SetWindow : Android.App.AlarmType * int64 * int64 * Android.App.PendingIntent -> unit

パラメーター

type: AlarmType

アラームの種類。

windowStartMillis: Int64

アラームを配信する最も早い時間 (ミリ秒単位) は、適切なクロックの単位で表されます (アラームの種類に応じて)。

windowLengthMillis: Int64

要求された配信期間の長さ (ミリ秒単位)。アラームは、 windowStartMillis後、ミリ秒後に配信されます。このパラメーターは 期間であり、 ウィンドウの末尾のタイムスタンプではないことに注意してください。

operation: PendingIntent

アラームがオフになったときに実行するアクション。通常は PendingIntent#getBroadcast IntentSender.getBroadcast()から取得されます。

属性: RegisterAttribute

注釈

指定された時間内にアラームを配信するようにスケジュールします。このメソッドは set(int,long,PendingIntent) に似ていますが、アプリケーションは OS によって配信を調整する度合いを正確に制御できます。この方法を使用すると、アプリケーションは、アラームの緩やかなタイムライン要件がある場合でも、配信バッチ処理から生じるバッテリの最適化を利用できます。注: API Build.VERSION_CODES以降。S、アプリは 10 分未満のウィンドウで渡すべきではありません。システムは、アラームが近い将来に起動することになっている場合は、小さなウィンドウを収容するために最善を尽くしますが、保証はなく、アプリは10分未満のウィンドウが10分に細長くされることを期待する必要があります。また、この方法を使用して、各アラームに対して要求されたウィンドウが交差しないようにすることで、複数のアラーム間で厳密な順序付け保証を実現することもできます。正確な配信が必要ない場合、アプリケーションでは標準の set(int,long,PendingIntent) メソッドを使用する必要があります。これにより、ウェイクアップとバッテリの使用を最小限に抑えるための最も柔軟な OS が提供されます。許容できるバリエーションがない正確に指定された時刻に配信する必要があるアラームの場合、アプリケーションは setExact(int,long,PendingIntent) を使用できます。

適用対象

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

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

[Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSetWindow_IJJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)]
public virtual void SetWindow(Android.App.AlarmType type, long windowStartMillis, long windowLengthMillis, string? tag, Android.App.AlarmManager.IOnAlarmListener listener, Android.OS.Handler? targetHandler);

[<Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSetWindow_IJJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)>]
abstract member SetWindow : Android.App.AlarmType * int64 * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit
override this.SetWindow : Android.App.AlarmType * int64 * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit

パラメーター

type: AlarmType

int: 値は次のいずれかです。RTC ELAPSED_REALTIME_WAKEUP ELAPSED_REALTIME RTC_WAKEUP

windowStartMillis: Int64

long

windowLengthMillis: Int64

long

tag: String

文字列: この値は null である可能性があります。

listener: AlarmManager.IOnAlarmListener

AlarmManager.OnAlarmListener: この値を null にすることはできません。

targetHandler: Handler

ハンドラー: この値は null である可能性があります。

属性: RegisterAttribute

注釈

setWindow(int,long,long,PendingIntent) の直接コールバックバージョン。アラーム時刻に達したときに送信される PendingIntent を指定するのではなく、このバリアントは、その時点で呼び出される OnAlarmListener インスタンスを提供します。呼び出し元のプロセスで Activity、Service、ContentProvider などのコンポーネントが実行されなくなった場合は、リスナーベースのアラームが Android システムによって取り消される可能性があるため、現在のコンポーネントが完了した後にアラームを受信する必要がない場合にのみこれらの API を使用し、その場合はキャンセル (OnAlarmListener) を行ってください。たとえば、アクティビティからこれらの API を使用する場合は、アクティビティの終了時にそれぞれのアラームを取り消してください。その後もアラームを受信する必要がある場合は、PendingIntent ベースの API を使用します。 OnAlarmListener onAlarm() メソッドは、指定されたターゲットハンドラーを介して呼び出されます。null が targetHandler パラメーターとして渡された場合は、アプリケーションのメインルーパーで呼び出されます。注: API Build.VERSION_CODES以降。S、アプリは 10 分未満のウィンドウで渡すべきではありません。システムは、アラームが近い将来に起動することになっている場合は、小さなウィンドウを収容するために最善を尽くしますが、保証はなく、アプリは10分未満のウィンドウが10分に細長くされることを期待する必要があります。

適用対象

SetWindow(AlarmType, Int64, Int64, String, IExecutor, AlarmManager+IOnAlarmListener)

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

[Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Ljava/util/concurrent/Executor;Landroid/app/AlarmManager$OnAlarmListener;)V", "GetSetWindow_IJJLjava_lang_String_Ljava_util_concurrent_Executor_Landroid_app_AlarmManager_OnAlarmListener_Handler", ApiSince=34)]
public virtual void SetWindow(Android.App.AlarmType type, long windowStartMillis, long windowLengthMillis, string? tag, Java.Util.Concurrent.IExecutor executor, Android.App.AlarmManager.IOnAlarmListener listener);

[<Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Ljava/util/concurrent/Executor;Landroid/app/AlarmManager$OnAlarmListener;)V", "GetSetWindow_IJJLjava_lang_String_Ljava_util_concurrent_Executor_Landroid_app_AlarmManager_OnAlarmListener_Handler", ApiSince=34)>]
abstract member SetWindow : Android.App.AlarmType * int64 * int64 * string * Java.Util.Concurrent.IExecutor * Android.App.AlarmManager.IOnAlarmListener -> unit
override this.SetWindow : Android.App.AlarmType * int64 * int64 * string * Java.Util.Concurrent.IExecutor * Android.App.AlarmManager.IOnAlarmListener -> unit

パラメーター

type: AlarmType

int: 値は次のいずれかです。RTC ELAPSED_REALTIME_WAKEUP ELAPSED_REALTIME RTC_WAKEUP

windowStartMillis: Int64

long

windowLengthMillis: Int64

long

tag: String

文字列: この値は null である可能性があります。

executor: IExecutor

Executor: この値を null にすることはできません。

listener: AlarmManager.IOnAlarmListener

AlarmManager.OnAlarmListener: この値を null にすることはできません。

属性: RegisterAttribute

注釈

setWindow(int,long,long,PendingIntent) の直接コールバックバージョン。アラーム時刻に達したときに送信される PendingIntent を指定するのではなく、このバリアントは、その時点で呼び出される OnAlarmListener インスタンスを提供します。呼び出し元のプロセスで Activity、Service、ContentProvider などのコンポーネントが実行されなくなった場合は、リスナーベースのアラームが Android システムによって取り消される可能性があるため、現在のコンポーネントが完了した後にアラームを受信する必要がない場合にのみこれらの API を使用し、その場合はキャンセル (OnAlarmListener) を行ってください。たとえば、アクティビティからこれらの API を使用する場合は、アクティビティの終了時にそれぞれのアラームを取り消してください。その後もアラームを受信する必要がある場合は、PendingIntent ベースの API を使用します。 OnAlarmListener onAlarm() メソッドは、指定されたターゲット Executor を介して呼び出されます。注: API Build.VERSION_CODES以降。S、アプリは 10 分未満のウィンドウで渡すべきではありません。システムは、アラームが近い将来に起動することになっている場合は、小さなウィンドウを収容するために最善を尽くしますが、保証はなく、アプリは10分未満のウィンドウが10分に細長くされることを期待する必要があります。

適用対象