語言

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：此值不可能為空值。

operation
PendingIntent

PendingIntent：警報響起時要執行的動作;通常來自 IntentSender.getBroadcast（）。 這個值不可能為零值。

屬性
RegisterAttribute RequiresPermissionAttribute

備註

安排一個代表鬧鐘的鬧鐘，用來通知使用者鬧鐘響起。 預期當警報響起時，應用程式會進一步喚醒裝置，告訴使用者警報發生——例如開啟螢幕、播放聲音、震動等。因此，系統通常也會利用此處提供的資訊，在適當情況下告知使用者即將到來的警報。 由於此類警報的性質類似於 setExactAndAllowWhileIdle（int， long， PendingIntent），即使系統處於低功耗閒置（又稱休眠）模式，這些警報仍會被允許觸發。 系統也可能在偵測到此類警報時進行準備工作，以減少導致裝置完全喚醒時可能產生的背景工作——以避免早上同時設定大量裝置同時設定鬧鐘的情況， 他們都在那個時間醒來，突然被待完成的背景工作淹沒了整個頻道。 因此，這類警報器在電池使用上可能非常昂貴，且應僅用於其預期用途。

此方法類似 setExact（int， long， PendingIntent），但蘊含 RTC_WAKEUP。 注意：從Build.VERSION_CODES開始。S，針對 SDK 等級 31 或以上的應用程式，需要申請 SCHEDULE_EXACT_ALARM 權限才能使用此 API。 使用者和系統可以透過設定中的特殊應用程式存取畫面撤銷此權限。 注意：精確警報應僅用於面向使用者的功能。 更多細節請參見精確警報權限。 透過此 API 排程的鬧鐘，即使應用程式在背景，仍可啟動前景服務。 需要Manifest.permission.SCHEDULE_EXACT_ALARM

另請參閱：

Android 參考資料。android.app.AlarmManager.setAlarmClock

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於