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

定義

名前空間:: Android.App

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

重要

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

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

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

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

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

適用対象