AlarmManager.SetInexactRepeating メソッド

定義

名前空間:: Android.App

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

重要

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

トリガー時間要件が不正確な繰り返しアラームをスケジュールします。たとえば、アラームは 1 時間ごとに繰り返されますが、必ずしも 1 時間の先頭に表示されるとは限りません。

[Android.Runtime.Register("setInexactRepeating", "(IJJLandroid/app/PendingIntent;)V", "GetSetInexactRepeating_IJJLandroid_app_PendingIntent_Handler")]
public virtual void SetInexactRepeating(Android.App.AlarmType type, long triggerAtMillis, long intervalMillis, Android.App.PendingIntent operation);

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

パラメーター

type: AlarmType

アラームの種類。

triggerAtMillis: Int64

(アラームの種類に応じて) 適切なクロックを使用して、アラームを最初にオフにする時間 (ミリ秒単位)。これは不正確です:この時間の前にアラームは起動しませんが、アラームの最初の呼び出しの前に、ほぼ全体のアラーム間隔の遅延が発生する可能性があります。

intervalMillis: Int64

アラームの後続の繰り返し間のミリ秒単位の間隔。 API 19 より前では、これがINTERVAL_FIFTEEN_MINUTES、INTERVAL_HALF_HOUR、INTERVAL_HOUR、INTERVAL_HALF_DAY、またはINTERVAL_DAYのいずれかである場合、アラームは他のアラームと位相整合され、ウェイクアップの数が減ります。それ以外の場合は、アプリケーションが #setRepeatingを呼び出したかのようにアラームが設定されます。 API 19 の時点では、すべての繰り返しアラームは不正確になり、指定された繰り返し間隔に関係なく、他のアラームとのバッチ処理の対象となります。

operation: PendingIntent

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

属性: RegisterAttribute

注釈

トリガー時間要件が不正確な繰り返しアラームをスケジュールします。たとえば、アラームは 1 時間ごとに繰り返されますが、必ずしも 1 時間の先頭に表示されるとは限りません。これらのアラームは、setRepeating(int, long, long, PendingIntent) によって従来提供されていた厳格な繰り返しよりも電力効率が高くなります。これは、システムがアラームの配信時間を調整して同時に起動できるため、必要以上にスリープからデバイスを目覚めさせないようにします。アラームの最初のトリガーは、要求された時刻の前には表示されませんが、その後のほぼ完全な間隔では発生しない可能性があります。さらに、繰り返しアラームの全体的な期間は要求されたとおりになりますが、アラームの連続する 2 回の発射の間の時間は異なる場合があります。アプリケーションで非常に低いジッターが必要な場合は、代わりに適切なウィンドウでワンショットアラームを使用します。setWindow(int,long,long,PendingIntent) と setExact(int,long,PendingIntent) を参照してください。 API 19 の時点では、すべての繰り返しアラームは不正確です。このメソッドは API 3 以降で使用できるため、アプリケーションで安全に呼び出し、現在のバージョンと古いバージョンの Android の両方で同様の動作が得られます。 Build.VERSION_CODESを対象とするアプリ。S は、このアラームの設定に使用されている PendingIntent にフラグ PendingIntent.FLAG_MUTABLEを設定する必要があります(アラーム数にキー Intent.EXTRA_ALARM_COUNTを指定する必要がある場合)。

適用対象