Instance Method

requestedUpdateDidBegin()

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

Declaration

optional func requestedUpdateDidBegin()

Discussion

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 requestedUpdateBudgetExhausted() method to let you know that the requested update has begun. These methods are your opportunity to tell ClockKit whether or not you have new data to add to your timeline.

If you have new data for your timeline, your implementation of this method should call the reloadTimeline(for:) or extendTimeline(for:) method of the complication server. ClockKit does not ask your data source for new timeline entries unless you call one of those methods. If you do nothing or do not 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.

Deprecated
func requestedUpdateBudgetExhausted()

Indicates that your complication’s time budget is exhausted.

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

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

Deprecated