Instance Method


Indicates that your complication’s time budget is exhausted.


optional func requestedUpdateBudgetExhausted()


When the date returned by the getNextRequestedUpdateDate(handler:) method of your data source passes, ClockKit begins a scheduled update of your complication. At the start of that update, it calls this method or the requestedUpdateDidBegin() method to let you know that the requested update has begun. These methods are your opportunity to tell ClockKit whether or not you’ve new data to add to your timeline. When this method is called, it’s your last opportunity to update your timeline until its budget is replenished.

If you’ve new data for your timeline, your implementation of this method should call the reloadTimeline(for:) or extendTimeline(for:) method of the complication server. ClockKit doesn’t ask your data source for new timeline entries unless you call one of those methods. If you do nothing or don’t implement this method, ClockKit calls only the getNextRequestedUpdateDate(handler:) of your data source to fetch a new update time.

See Also

Deprecated Methods

func getNextRequestedUpdateDate(handler: (Date?) -> Void)

Gets the next time at which to update your complication.

func requestedUpdateDidBegin()

Indicates that a requested update has begun so that you’ve an opportunity to extend or reload your timeline.

func getPlaceholderTemplate(for: CLKComplication, withHandler: (CLKComplicationTemplate?) -> Void)

Gets a static template to display in the selection screen for your complication.