22

我一直在互联网上关注很多教程来学习如何设置并发症。按预期设置并发症我没有问题。

直到初始时间线条目过期。12 小时后,我不知道如何更新它以保持并发症的存在。我将在下面分享我拥有的所有内容,希望有人可以帮助我填写。

在这里,我为要在复杂功能上显示的数据创建变量。

struct data = {
var name: String
var startString: String
var startDate: NSDate
}

以下数组是此数据的容器。

var dataArray = [data]

这允许在手表锁定时显示复杂功能。

func getPrivacyBehaviorForComplication(complication: CLKComplication, withHandler handler: (CLKComplicationPrivacyBehavior) -> Void) {
    handler(.ShowOnLockScreen)
}

这允许在复杂功能上进行时间旅行。

func getSupportedTimeTravelDirectionsForComplication(complication: CLKComplication, withHandler handler: (CLKComplicationTimeTravelDirections) -> Void) {
    handler([.Forward])
}

在这里,我将时间线的开始时间设置为等于现在。

func getTimelineStartDateForComplication(complication: CLKComplication, withHandler handler: (NSDate?) -> Void) {
    handler(NSDate())
}

在这里,我将时间线的结束时间设置为从现在开始的 12 小时。

func getTimelineEndDateForComplication(complication: CLKComplication, withHandler handler: (NSDate?) -> Void) {
    handler(NSDate(timeIntervalSinceNow: (60 * 60 * 12)))
}

在这里,我创建了并发症的模板。这是为了在用户浏览手表上的所有并发症时看到我的并发症时向他们显示示例数据。

func getPlaceholderTemplateForComplication(complication: CLKComplication, withHandler handler: (CLKComplicationTemplate?) -> Void) {

    let headerTextProvider = CLKSimpleTextProvider(text: "Some Data")
    let body1TextProvider = CLKSimpleTextProvider(text: "Some Data Time")
    let template = CLKComplicationTemplateModularLargeStandardBody()
    template.headerTextProvider = headerTextProvider
    template.body1TextProvider = body1TextProvider

    handler(template)
}

这为并发症创建了第一个时间线条目。启用复杂功能后,将运行此代码并立即相应地填充复杂功能。

func getCurrentTimelineEntryForComplication(complication: CLKComplication, withHandler handler: (CLKComplicationTimelineEntry?) -> Void) {

    createData()

    if complication.family == .ModularLarge {

        if dataArray.count != 0 {

            let firstData = dataArray[0]
            let headerTextProvider = CLKSimpleTextProvider(text: firstData.name)
            let body1TextProvider = CLKSimpleTextProvider(text: firstData.startString)
            let template = CLKComplicationTemplateModularLargeStandardBody()
            template.headerTextProvider = headerTextProvider
            template.body1TextProvider = body1TextProvider
            let timelineEntry = CLKComplicationTimelineEntry(date: NSDate(), complicationTemplate: template)
            handler(timelineEntry)
        } else {
            let headerTextProvider = CLKSimpleTextProvider(text: "No Data")
            let body1TextProvider = CLKSimpleTextProvider(text: "Create some data")
            let template = CLKComplicationTemplateModularLargeStandardBody()
            template.headerTextProvider = headerTextProvider
            template.body1TextProvider = body1TextProvider

            let timelineEntry = CLKComplicationTimelineEntry(date: NSDate(), complicationTemplate: template)
            handler(timelineEntry)
        }

    } else {
        handler(nil)
    }

}

这是我为我目前拥有的所有数据创建时间线条目的地方。

func getTimelineEntriesForComplication(complication: CLKComplication, afterDate date: NSDate, limit: Int, withHandler handler: ([CLKComplicationTimelineEntry]?) -> Void) {

    createData()

    var entries = [CLKComplicationTimelineEntry]()

    for dataObject in dataArray {

        if entries.count < limit && data.startDate.timeIntervalSinceDate(date) > 0 {

            let headerTextProvider = CLKSimpleTextProvider(text: dataObject.name)
            let body1TextProvider = CLKSimpleTextProvider(text: dataObject.startString)
            let template = CLKComplicationTemplateModularLargeStandardBody()
            template.headerTextProvider = headerTextProvider
            template.body1TextProvider = body1TextProvider
            let timelineEntry = CLKComplicationTimelineEntry(date: NSDate(timeInterval: (-10*60), sinceDate: data.startDate), complicationTemplate: template)
            entries.append(timelineEntry)

        }

    }

    handler(entries)

}

这告诉手表何时更新并发症数据。

func getNextRequestedUpdateDateWithHandler(handler: (NSDate?) -> Void) {
    handler(NSDate(timeIntervalSinceNow: 60 * 60 * 6))
}

这是我遇到问题的地方。

如何创建新数据并重新加载时间线?什么是流量?我不是要延长时间线,而是要完全取代它。我完全不知所措。在这一点上,Apple 的文档非常模糊。我知道我需要实现以下方法,但我不知道如何。有人可以帮我填写此代码吗?

func requestedUpdateDidBegin() {
    createData() //I assume createData() goes here? If so, how do I populate the new timeline entries based on the results?
}

func requestedUpdateBudgetExhausted() {
    //This can't possibly be the case as I haven't gotten it to work once.
}

func reloadTimelineForComplication(complication: CLKComplication!) {
      //This method appears to do nothing.
}

更新:

多亏了 El Tea,我才开始工作。我需要将 CLKComplicationServer 的实例添加到 requestedUpdateDidBegin 并将 reloadTimeline 方法放入其中。

这是更新的代码:

func requestedUpdateDidBegin() {
    print("Complication update is starting")

    createData()

    let server=CLKComplicationServer.sharedInstance()

    for comp in (server.activeComplications) {
        server.reloadTimelineForComplication(comp)
        print("Timeline has been reloaded!")
    }

}

func requestedUpdateBudgetExhausted() {
    print("Budget exhausted")
}
4

2 回答 2

27

在时间间隔内完成的复杂功能刷新流程遵循以下顺序:

  • iOS 调用您的函数requestedUpdateDidBegin()requestedUpdateBudgetExhausted()(如果您的预算用尽,您所做的任何事情都不会导致更新,直到您获得更多执行时间。)
  • 在你的内心深处,requestedUpdateDidBegin() 必须打电话reloadTimelineForComplication()extendTimelineForComplication()指定你想要重新加载哪些并发症或添加数据。如果你不这样做,什么都不会发生!
  • 根据您是否调用reloadextend,iOS 会调用 和 中的一个或getCurrentTimelineEntryForComplication()两个getTimelineEntriesForComplication()
  • 无论您是否更新了您的复杂功能,iOS 都会调用getNextRequestedUpdateDateWithHandler()以找出您下次想要重复上述步骤的时间。

注意:最后两个步骤不一定要按此顺序进行。

该过程以这种方式工作,因此 iOS 不会要求您重复重新生成相同的数据。它让您有机会requestedUpdateDidBegin()决定您的并发症是否需要更新。如果没有,您的代码应该只是返回。(这会减少您的复杂功能的执行时间,并有助于避免 iOS 因使用了每日预算而切断您的应用程序的进一步更新)。但是如果你确实有新数据,你需要通过调用reloadTimelineForComplication()extendTimelineForComplication()

据我所知,除了您没有请求重新加载或在内部扩展之外,您在那里编写的所有内容看起来都不错requestedUpdateDidBegin()。您的复杂功能可能会在多个位置显示在表盘上,并且不同的模板可能具有不同的显示行为,因此您必须使所有这些都无效。这是我的代码的样子:

func requestedUpdateDidBegin() {

    //Not shown: decide if you actually need to update your complication.
    //If you do, execute the following code:

    let server=CLKComplicationServer.sharedInstance()

    for comp in (server.activeComplications) {
        server.reloadTimelineForComplication(comp)
    }
}

请注意,除了时间间隔之外,还有其他方法可以启动刷新,包括推送警报、在手表应用程序运行时执行重新加载,或者使用带有 WCSession 的 Watch Connectivity 框架让您的手机应用程序发送更新数据以立即通过transferCurrentComplicationUserInfo(). 有关更多信息,请参阅 Apple 文档中的更新您的并发症数据

我在模拟器测试更新间隔短至十分钟方面取得了成功。由于执行时间预算,您可能不应该在实际手表上频繁更新,但这将使您无需等待 12 小时即可测试您的代码。

于 2015-10-07T13:51:16.707 回答
17

El Tea 的回答详细介绍了如何更新 watchOS 2 的并发症。

在 watchOS 3 中,让您的复杂功能保持最新的推荐方法是使用后台刷新应用程序任务。您可以使用一系列后台任务来安排处理您的应用程序扩展在后台被唤醒以:

这更实用且更节能,因为它不使用任何复杂功能的日常执行预算来获取数据或更新模型。

它还避免了不建议的方法带来的任何复杂性,这些方法试图异步获取复杂数据源中的数据,而这些数据源只是为了立即响应请求。

我在另一个答案中提供了更多信息,以及指向 WWDC 视频和示例代码的链接。

总结一下watchOS 3的变化

使用计划的后台任务而不是getNextRequestedUpdateDateWithHandler().

在应用程序任务中重新加载或扩展您的时间线,而不是在requestedUpdateDidBegin().

于 2016-06-16T19:14:24.880 回答