Apple Watch 的复杂功能数据更新流程是怎样的?
What is the flow for updating complication data for Apple Watch?
我一直在关注互联网上的大量教程,以学习如何设置复杂功能。我可以毫无问题地按预期设置复杂功能。
直到初始时间线条目到期。 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's docs 在这一点上非常含糊。我知道我需要实现以下方法,但我不知道如何实现。有人可以帮我填写这个代码吗?
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")
}
在某个时间间隔 完成的复杂功能刷新的流程遵循以下顺序:
- iOS 调用您的函数
requestedUpdateDidBegin()
或 requestedUpdateBudgetExhausted()
(如果您的预算用尽,您将不会执行任何操作,直到您获得更多执行时间。)
- 在
requestedUpdateDidBegin()
你 必须调用 reloadTimelineForComplication()
或 extendTimelineForComplication()
来指定你想要重新加载或拥有数据的并发症添加到。如果你不这样做,什么也不会发生!
- 根据您调用的是
reload
还是 extend
,iOS 会调用 getCurrentTimelineEntryForComplication()
和 getTimelineEntriesForComplication()
中的一个或两个
- 无论您是否更新了复杂功能,iOS 都会调用
getNextRequestedUpdateDateWithHandler()
来了解您下次希望何时重复上述步骤。
注意:最后两个步骤不一定要按此顺序进行。
该过程以这种方式工作,因此 iOS 不会要求您重复重新生成相同的数据。它让您有机会在 requestedUpdateDidBegin()
中决定您的并发症是否需要更新。如果没有,您的代码应该只是 return。 (这会减少复杂功能的执行时间,并有助于避免 iOS 因用完每日预算而中断您的应用程序的进一步更新)。但是如果你确实有新数据,你需要通过调用 reloadTimelineForComplication()
或 extendTimelineForComplication()
来告诉 iOS
据我所知,除了您没有请求重新加载或在 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 的手表连接框架让您的 phone 应用程序发送更新通过 transferCurrentComplicationUserInfo()
立即显示数据。 See Updating Your Complication Data 在 Apple 的文档中获取更多信息。
我已经在短至十分钟的模拟器测试更新间隔中取得了成功。由于执行时间预算,您可能不应该在真实手表上频繁更新,但这将使您无需等待 12 小时即可测试您的代码。
详细介绍了如何更新 watchOS 2 的复杂功能。
在 watchOS 3 中,让您的复杂功能保持最新的推荐方法包括使用 background refresh app tasks. You can use a series of background tasks to schedule and handle 您的应用程序扩展在后台被唤醒到:
获取新数据
- 使用WKWatchConnectivityRefreshBackgroundTask从phone获取数据,或者
- 使用WKURLSessionRefreshBackgroundTask从服务器下载数据
- 数据到达后更新您的模型,
- 更新您的并发症(通过重新加载或延长时间线)以显示模型中可用的新数据,最后
- 更新应用程序的停靠栏快照以显示停靠栏上的数据
这更实用也更节能,因为它不会使用您的复杂功能的任何日常执行预算来获取数据或更新模型。
它还避免了不明智的方法带来的任何复杂性,这些方法试图在复杂的数据源中异步获取数据,而这种数据源本来只是为了立即响应请求。
我提供了更多信息,以及指向 WWDC 视频和示例代码的链接,。
总结 watchOS 3 的变化
使用计划的后台任务而不是 getNextRequestedUpdateDateWithHandler()
。
在应用任务中重新加载或延长时间线,而不是在 requestedUpdateDidBegin()
内。
我一直在关注互联网上的大量教程,以学习如何设置复杂功能。我可以毫无问题地按预期设置复杂功能。
直到初始时间线条目到期。 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's docs 在这一点上非常含糊。我知道我需要实现以下方法,但我不知道如何实现。有人可以帮我填写这个代码吗?
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")
}
在某个时间间隔 完成的复杂功能刷新的流程遵循以下顺序:
- iOS 调用您的函数
requestedUpdateDidBegin()
或requestedUpdateBudgetExhausted()
(如果您的预算用尽,您将不会执行任何操作,直到您获得更多执行时间。) - 在
requestedUpdateDidBegin()
你 必须调用reloadTimelineForComplication()
或extendTimelineForComplication()
来指定你想要重新加载或拥有数据的并发症添加到。如果你不这样做,什么也不会发生! - 根据您调用的是
reload
还是extend
,iOS 会调用getCurrentTimelineEntryForComplication()
和getTimelineEntriesForComplication()
中的一个或两个
- 无论您是否更新了复杂功能,iOS 都会调用
getNextRequestedUpdateDateWithHandler()
来了解您下次希望何时重复上述步骤。
注意:最后两个步骤不一定要按此顺序进行。
该过程以这种方式工作,因此 iOS 不会要求您重复重新生成相同的数据。它让您有机会在 requestedUpdateDidBegin()
中决定您的并发症是否需要更新。如果没有,您的代码应该只是 return。 (这会减少复杂功能的执行时间,并有助于避免 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 的手表连接框架让您的 phone 应用程序发送更新通过 transferCurrentComplicationUserInfo()
立即显示数据。 See Updating Your Complication Data 在 Apple 的文档中获取更多信息。
我已经在短至十分钟的模拟器测试更新间隔中取得了成功。由于执行时间预算,您可能不应该在真实手表上频繁更新,但这将使您无需等待 12 小时即可测试您的代码。
在 watchOS 3 中,让您的复杂功能保持最新的推荐方法包括使用 background refresh app tasks. You can use a series of background tasks to schedule and handle 您的应用程序扩展在后台被唤醒到:
获取新数据
- 使用WKWatchConnectivityRefreshBackgroundTask从phone获取数据,或者
- 使用WKURLSessionRefreshBackgroundTask从服务器下载数据
- 数据到达后更新您的模型,
- 更新您的并发症(通过重新加载或延长时间线)以显示模型中可用的新数据,最后
- 更新应用程序的停靠栏快照以显示停靠栏上的数据
这更实用也更节能,因为它不会使用您的复杂功能的任何日常执行预算来获取数据或更新模型。
它还避免了不明智的方法带来的任何复杂性,这些方法试图在复杂的数据源中异步获取数据,而这种数据源本来只是为了立即响应请求。
我提供了更多信息,以及指向 WWDC 视频和示例代码的链接,
总结 watchOS 3 的变化
使用计划的后台任务而不是 getNextRequestedUpdateDateWithHandler()
。
在应用任务中重新加载或延长时间线,而不是在 requestedUpdateDidBegin()
内。