Language

AlarmManager.SetAlarmClock(AlarmManager+AlarmClockInfo, PendingIntent) メソッド

定義

名前空間:
Android.App
アセンブリ:
Mono.Android.dll

アラーム クロックを表すアラームをスケジュールします。アラームは、オフになったときにユーザーに通知するために使用されます。

[Android.Runtime.Register("setAlarmClock", "(Landroid/app/AlarmManager$AlarmClockInfo;Landroid/app/PendingIntent;)V", "GetSetAlarmClock_Landroid_app_AlarmManager_AlarmClockInfo_Landroid_app_PendingIntent_Handler")]
[Android.Runtime.RequiresPermission("android.permission.SCHEDULE_EXACT_ALARM")]
public virtual void SetAlarmClock(Android.App.AlarmManager.AlarmClockInfo info, Android.App.PendingIntent operation);
[<Android.Runtime.Register("setAlarmClock", "(Landroid/app/AlarmManager$AlarmClockInfo;Landroid/app/PendingIntent;)V", "GetSetAlarmClock_Landroid_app_AlarmManager_AlarmClockInfo_Landroid_app_PendingIntent_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.SCHEDULE_EXACT_ALARM")>]
abstract member SetAlarmClock : Android.App.AlarmManager.AlarmClockInfo * Android.App.PendingIntent -> unit
override this.SetAlarmClock : Android.App.AlarmManager.AlarmClockInfo * Android.App.PendingIntent -> unit

パラメーター

info
AlarmManager.AlarmClockInfo

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

operation
PendingIntent

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

属性
RegisterAttribute RequiresPermissionAttribute

注釈

アラーム クロックを表すアラームをスケジュールします。アラームは、オフになったときにユーザーに通知するために使用されます。 期待は、このアラームがトリガーされると、アプリケーションがさらにアラームについてユーザーに知らせるためにデバイスを目覚めさせ、画面をオンにしたり、音を再生したり、振動したりすることです。そのため、システムは通常、ここで提供される情報を使用して、必要に応じて、この今後のアラームについてユーザーに通知します。 setExactAndAllowWhileIdle(int, long, PendingIntent) と同様に、この種類のアラームの性質により、システムが低電力アイドル (つまり、doze) モードの場合でも、これらのアラームをトリガーできます。 システムは、このようなアラームが発生する場合に準備作業を行う場合もあります。これにより、デバイスが完全にスリープ解除された場合に発生する可能性のあるバックグラウンド作業の量を減らすことができます。これは、午前にアラームが同時に設定されている多数のデバイスなどの状況を回避するためです。 すべてのその時点で目を覚まし、突然保留中のバックグラウンド作業でネットワークを浸水。 そのため、これらの種類のアラームは、バッテリ使用時に非常に高価になる可能性があり、その目的にのみ使用する必要があります。

このメソッドは setExact(int,long,PendingIntent) に似ていますが、RTC_WAKEUP意味します。 注: Build.VERSION_CODES以降。S、SDK レベル 31 以上を対象とするアプリでは、この API を使用するためのSCHEDULE_EXACT_ALARMアクセス許可を要求する必要があります。 ユーザーとシステムは、[設定] の特別なアプリ アクセス画面を使用して、このアクセス許可を取り消すことができます。 注: 正確なアラームは、ユーザー向けの機能にのみ使用してください。 詳細については、「正確なアラームのアクセス許可」を参照してください。 この API を介してスケジュールされたアラームは、アプリがバックグラウンドにある場合でもフォアグラウンド サービスを開始できます。 Manifest.permission.SCHEDULE_EXACT_ALARMが必要

関連項目も参照:

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

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

適用対象