AlarmManager.SetAndAllowWhileIdle(AlarmType, Int64, PendingIntent) メソッド

定義

名前空間:

Android.App

アセンブリ:

Mono.Android.dll

同様 #set(int, long, PendingIntent)に、ただし、システムが低電力アイドル状態 (a.

[Android.Runtime.Register("setAndAllowWhileIdle", "(IJLandroid/app/PendingIntent;)V", "GetSetAndAllowWhileIdle_IJLandroid_app_PendingIntent_Handler", ApiSince=23)]
public virtual void SetAndAllowWhileIdle (Android.App.AlarmType type, long triggerAtMillis, Android.App.PendingIntent operation);

[<Android.Runtime.Register("setAndAllowWhileIdle", "(IJLandroid/app/PendingIntent;)V", "GetSetAndAllowWhileIdle_IJLandroid_app_PendingIntent_Handler", ApiSince=23)>]
abstract member SetAndAllowWhileIdle : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit
override this.SetAndAllowWhileIdle : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit

パラメーター

type

AlarmType

アラームの種類。

triggerAtMillis

Int64

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

operation

PendingIntent

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

属性

RegisterAttribute

注釈

同様 #set(int, long, PendingIntent)に、ただし、システムが低電力アイドル (doze) モードの場合でも、このアラームの実行が許可されます。 この種類のアラームは、アイドル状態の間にアラームが実際にオフになる必要がある状況では b>のみ</b> を使用する必要があります<。これは、ユーザーが認識できるように音を鳴らすカレンダー通知の場合です。 アラームがディスパッチされると、アプリはシステムの一時的な電源除外リストにも約 10 秒間追加され、アプリケーションが作業を完了するためのウェイク ロックをさらに取得できるようになります。</p>

これらのアラームは、アイドル時のデバイスの電力使用量に大きな影響を与える可能性があるため (そのため、アプリのスケジュール設定に対してバッテリの重大な責任が生じる)、注意して使用する必要があります。 不正使用を減らすために、特定のアプリケーションでこれらのアラームがオフになる頻度には制限があります。 通常のシステム操作では、これらのアラームは約毎分以上ディスパッチされません(その時点で、保留中のすべてのアラームがディスパッチされます)。低電力アイドル モードの場合、この期間は 15 分など、大幅に長くなる可能性があります。

他のアラームとは異なり、システムは、同じアプリからのアラームであっても、他のアラームと順不同に発生するように、このタイプのアラームを自由に再スケジュールすることができます。 これは、デバイスがアイドル状態の場合に明らかに発生します (このアラームはアイドル中にオフになる可能性があるため、アプリの他のアラームが後で保持される場合)、アイドル状態でない場合でも発生する可能性があります。

アプリのターゲット SDK のバージョンに関係なく、この呼び出しでは常にアラームのバッチ処理が許可されます。

の Java ドキュメントandroid.app.AlarmManager.setAndAllowWhileIdle(int, long, android.app.PendingIntent)

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。