AlarmManager.SetInexactRepeating 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
安排一個重複警報,但觸發時間要求不精確;例如,鬧鐘每小時重複一次,但不一定在整點開始。
[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()。
- 屬性
備註
安排一個重複警報,但觸發時間要求不精確;例如,鬧鐘每小時重複一次,但不一定在整點開始。 這些警報比傳統上由 setRepeating(int, long, long, pendingIntent) 提供的嚴格重複警報更省電,因為系統能調整警報的傳遞時間,使它們同時觸發,避免過度喚醒裝置從睡眠中醒來。 你的鬧鐘第一次觸發不會在請求時間之前,但可能要等近一整段時間才會觸發。 此外,雖然重複警報的整體時間會依要求進行,但任兩次連續觸發警報的時間間隔可能會有所不同。 如果你的應用程式需要非常低抖動,建議使用帶有適當視窗的一次性警報器;參見 setWindow(int, long, long, PendingIntent) 與 setExact(int, long, PendingIntent)。 根據 API 19,所有重複警報皆不精確。 由於此方法自 API 3 起就已存在,您的應用程式可以安全呼叫,並確保在現有與舊版本 Android 上都能獲得類似的行為。 針對Build.VERSION_CODES的應用程式。如果 S 想讓觸發Intent.EXTRA_ALARM_COUNT時提供警報數量,就必須在用於設定這個警報的 PendingIntent 上設置旗標PendingIntent.FLAG_MUTABLE。
另請參閱:
Android 參考資料。android.app.AlarmManager.setInexactRepeating
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。