AlarmManager.SetExact メソッド

定義

名前空間:: Android.App

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

重要

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

オーバーロード

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

SetExact(AlarmType, Int64, PendingIntent)

アラームが指定された時刻に正確に配信されるようにスケジュールします。

[Android.Runtime.Register("setExact", "(IJLandroid/app/PendingIntent;)V", "GetSetExact_IJLandroid_app_PendingIntent_Handler")]
[Android.Runtime.RequiresPermission("android.permission.SCHEDULE_EXACT_ALARM")]
public virtual void SetExact(Android.App.AlarmType type, long triggerAtMillis, Android.App.PendingIntent operation);

[<Android.Runtime.Register("setExact", "(IJLandroid/app/PendingIntent;)V", "GetSetExact_IJLandroid_app_PendingIntent_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.SCHEDULE_EXACT_ALARM")>]
abstract member SetExact : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit
override this.SetExact : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit

パラメーター

type: AlarmType

アラームの種類。

triggerAtMillis: Int64

(アラームの種類に応じて) 適切なクロックを使用して、アラームをオフにする時間 (ミリ秒単位)。

operation: PendingIntent

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

属性: RegisterAttribute RequiresPermissionAttribute

注釈

アラームが指定された時刻に正確に配信されるようにスケジュールします。このメソッドは set(int,long,PendingIntent) に似ていますが、OS で配信時間を調整することはできません。アラームは、要求されたトリガー時間に可能な限りほぼ配信されます。注: 正確な時刻配信に対して強い需要があるアラーム (要求された時刻にアラームクロックが鳴るなど) のみを正確にスケジュールする必要があります。アプリケーションでは、バッテリの使用を最小限に抑える OS の機能が低下するため、正確なアラームを不必要に使用しないことを強くお勧めします。注: Build.VERSION_CODES以降。S、SDK レベル 31 以上を対象とするアプリは、アプリがバッテリ制限から除外されない限り、この API を使用するためのSCHEDULE_EXACT_ALARMアクセス許可を要求する必要があります。ユーザーとシステムは、[設定] の特別なアプリアクセス画面を使用して、このアクセス許可を取り消すことができます。注: 正確なアラームは、ユーザー向けの機能にのみ使用してください。詳細については、「正確なアラームのアクセス許可」を参照してください。

適用対象

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

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

[Android.Runtime.Register("setExact", "(IJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSetExact_IJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)]
public virtual void SetExact(Android.App.AlarmType type, long triggerAtMillis, string? tag, Android.App.AlarmManager.IOnAlarmListener listener, Android.OS.Handler? targetHandler);

[<Android.Runtime.Register("setExact", "(IJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSetExact_IJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)>]
abstract member SetExact : Android.App.AlarmType * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit
override this.SetExact : 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: この値を null にすることはできません。

targetHandler: Handler

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

属性: RegisterAttribute

注釈

setExact(int,long,PendingIntent) の直接コールバックバージョン。アラーム時刻に達したときに送信される PendingIntent を指定するのではなく、このバリアントは、その時点で呼び出される OnAlarmListener インスタンスを提供します。呼び出し元のプロセスで Activity、Service、ContentProvider などのコンポーネントが実行されなくなった場合は、リスナーベースのアラームが Android システムによって取り消される可能性があるため、現在のコンポーネントが完了した後にアラームを受信する必要がない場合にのみこれらの API を使用し、その場合はキャンセル (OnAlarmListener) を行ってください。たとえば、アクティビティからこれらの API を使用する場合は、アクティビティの終了時にそれぞれのアラームを取り消してください。その後もアラームを受信する必要がある場合は、PendingIntent ベースの API を使用します。 OnAlarmListener の onAlarm() メソッドは、指定されたターゲットハンドラーを介して呼び出されます。null が targetHandler パラメーターとして渡された場合は、アプリケーションのメインルーパーで呼び出されます。以前の Android バージョンでは、Build.VERSION_CODES。S と Build.VERSION_CODES。TIRAMISU:SDK レベル 31 以上を対象とするアプリは、この API を使用するためのSCHEDULE_EXACT_ALARMアクセス許可を保持する必要がありました。ただし、アプリがバッテリ制限から除外されていない限りです。注: Android バージョンのBuild.VERSION_CODES以降。UPSIDE_DOWN_CAKE、呼び出し元アプリのライフサイクルが切れると、システムはこの API を介して設定されたアラームを明示的に削除します。

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

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

適用対象