让您的小组件更加智能

让您的小组件更加智能

了解如何让智能堆叠中的小组件更加智能。我们将向您展示如何将全新的小组件建议 API 与“智能轮换”结合使用，随时为人们带来更有价值的小组件体验。无论您是向系统提供及时的新信息，还是调教系统学习常见模式，采用这些 API 都可以帮助人们发现您的小组件，让您能够影响系统从 app 显示系统空间相关内容的方式。

资源
相关视频

WWDC21
- 贡献意图并提升您 App 的存在感
下载

♪重低音音乐声♪ ♪ 丹尼尔李：欢迎收看《添加智能到你的小组件》专题讲座我是丹尼尔我是Apple 主动智能团队的工程师这场专题讲座中我会示范你的小组件可以如何和系统合作为你的用户提供智能体验让你的小组件可以在用户需要的时刻出现小组件存在很多地方从iOS上的主屏幕到macOS上的通知中心小组件提供用户能够快速一瞥的信息在iPadOS 15推出后小组件也来到了iPad主屏幕上现在有比之前更多你的小组件能出现的地方我会先谈系统中有智能的小组件是什么意思然后我会示范可以如何为你的小组件启用智能方式是用可用API 捐赠相关信息我们先来谈小组件智能在iPhone和iPad上可以把多个小组件放在智能叠放中可以滚动查看不同小组件在同一个地方提供各种信息当用户编辑叠放除了能够添加移除或重新排序小组件用户也能查看并管理叠放的智能行为 iOS 14推出了智能轮换智能轮换让系统能在对的时间自动滚动到已经在叠放里的小组件为了知道要在什么时候轮换到某个小组件系统用小组件提供的相关性信号还有时间线条目进行判断它也可以通过学习用户行为的模式轮换到某个小组件这是通过每当用户查看和小组件相对应的信息时接收来自应用程序的捐赠有了智能轮换如果我把天气小组件提醒事项小组件和日历小组件放在叠放中天气小组件可能会叫系统在我早上醒来时提示它让我能查看一整天的天气早上9点30分日历小组件可能会告诉系统我10点有个会议所以我的叠放可能会轮换到日历到了下午我其中一项提醒的截止时间是下午3点所以小组件可能会叫叠放轮换到提醒事项傍晚时天气小组件可能会叫系统再次显示天气因为刚开始下雨所以我如果要出去吃晚餐的话我知道要带伞 iOS 15推出了新功能叫做小组件建议这是能让用户发现你的小组件并收到主动相关信息的全新方式对于启用小组件建议的智能叠放系统可以将新的小组件插入到原本没有该小组件的叠放只要你的应用程序明确做出捐赠系统就可以做到这件事和智能轮换相同系统也可以通过学习用户在应用程序中的行为模式做出小组件建议有了小组件建议如果我只放了天气小组件和提醒事项小组件在我的叠放中我在一天中还是会看到这些小组件的智能轮换但因为我10点有场会议而我的叠放中没有日历小组件日历应用程序可能会叫系统在9点30分主动将这个小组件插入我的叠放让我不会忘记开会不再需要这个小组件后系统会从我的叠放移除它我傍晚健身完后系统可能会显示健身小组件让我可以快速概览我今天圆满画圈的进度如何之后叠放会再次回到原始状态既然应用程序会在小组件有用时叫系统暂时插入小组件这也能帮助用户发现他们原本可能不知道存在的小组件现在来看如何采用智能旋转和小组件建议方式是用可用API 捐赠相关的信号到系统捐赠时你应该考虑你的小组件可以显示的所有可能信息并判断哪些类型相较之下比较适合作为建议选择如何对系统进行捐赠最终目标是提供时机恰当一瞥即知且对用户有明显价值的信息所以你应该考虑强调用户可能会比较有兴趣的情况例如天气小组件可能判断即将来临的大雨是较适合作为建议的情况相较之下若某个时点只有温度变化且变化幅度不大那就不适合为你的小组件采用智能旋转和小组件建议共有三种方式可用一你的应用程序可以捐赠一个INRelevantShortcut 告诉系统它应该在何时为你的其中一个小组件创建小组件建议二你的小组件可以通过TimelineEntryRelevance 提供相关性分数在小组件在叠放中时启用智能旋转三如果你的小组件可配置当你的应用程序用INInteraction 捐赠配置意图系统可以学习用户的行为模式以通过智能轮换和小组件建议推广你的小组件这些API 个个都能以强大的方式增强你的小组件的存在但它们的运作方式有些微不同所以让我们进一步讲解我们先谈为小组件建议捐赠INRelevantShortcut 无论你是否用意图配置你的小组件当你的应用程序得知有个可以向用户显示小组件的高度相关的情况捐赠一个INRelevantShortcut 让系统能主动将你的小组件插入到用户的叠放如果他们的主屏幕还没有你的小组件一个相关快捷方式可以指定它相关的期间或是让系统基于用户的行为模式判断何时插入小组件 INRelevantShortcut支持静态和用意图配置的小组件但两种配置类型的捐赠看起来会有些不同我们来看看如何采用这两种类型如果你的小组件支持 StaticConfiguration 你只需要创建一个新的 INRelevantShortcut 没有意图并将widgetKind属性设置为小组件的种类字符串这会告诉系统要建议你的应用程序的哪个小组件然后可选择将 relevanceProviders属性设置为INRelevanceProviders数组这会告诉系统在什么时候建议你的小组件我等一下会深入解释如果你的小组件支持 IntentConfiguration 用必要的参数创建用来配置的意图的实现然后通过将意图作为INShortcut 传递进去创建INRelevantShortcut 当然 widgetKind和 relevanceProviders属性的设置就跟静态小组件一样要捐赠一个相关快捷方式把它包含在相关快捷方式的数组中以设置在默认的 INRelevantShortcuttore中要更新捐赠快捷方式你可以将存储中的相关快捷方式数组取代成新的数组这代表你可以使先前捐赠的相关快捷方式失效方式是在新的数组中省略它捐赠一个包含意图的相关快捷方式也可以让意图在Siri表盘上浮现要告诉系统何时可以插入你的小组件设置一个INRelevanceProviders数组在你的相关快捷方式上这里有两个选项首先你可以用 INDateRelevanceProvider 为固定已知的相关期间提供开始和结束日期例如即将来临的事件或头条新闻你甚至可以用多个提供程序指定不只一个相关期间第二你也可以选择提供一个空的相关性提供程序数组以告诉系统你的小组件有新的东西可以显示系统会基于用户通常使用你的应用程序的时间选择一个时间提示小组件所有其他相关性提供程序皆支持 Siri表盘的INRelevantShortcut 但小组件建议并不支持现在我会用一个范例应用程序讲解采用可能会是什么样子我们打造了一个叫做卡片的应用程序让你查看所有信用卡的交易和余额它包含一个显示最近消费的小组件我们看看可以如何为最近消费小组件启用小组件建议方式是在我们的应用程序中捐赠INRelevantShortcut 我们想在用其中一张卡片消费后提示小组件因为小组件是用意图配置为了让小组件建议可用我们要先确定我们的意图在意图定义文件中支持捐赠这是ViewRecentPurchases意图的意图编辑器它会告诉我们的小组件要显示哪张信用卡还有用哪个商户类别筛选消费我们想确定 “意图符合Siri建议的资格”已勾选如果我们选择捐赠它们这能为我们的小组件启用主屏幕上的建议还有在iOS其他地方的建议但我们晚点谈INInteractions时会再提到然后我们需要创建一个参数组合里面包含形成意图的必要参数因为需要信用卡以及商户类别才能配置我们的小组件我们要用卡片和类别的参数创建一个支持组合现在我们可以在代码中创建意图在代码中我们的应用程序刚被通知用户刚刚消费了要进行捐赠我们先创建INRelevantShortcut的空数组以免我们想要捐赠多个快捷方式我们将用来配置最近消费小组件的意图初始化并设定任何我们可能需要的参数这里我们想要将意图上的卡片参数设置为用来进行最近消费的卡片的那个卡片对象并将类别设置为“所有” 让小组件显示那张卡片的所有消费然后我们用意图创建INShortcut 并用它创建一个INRelevantShortcut 我们将shortcutRole设置为信息shortcutRole 因为用户会在小组件中查看信息并设置widgetKind 我们提供一个 INDateRelevanceProvider 从现在开始并在30分钟后或者说1800秒后结束让系统可以在消费30分钟后移除它然后我们将这个快捷方式添加到 relevantShortcut的数组最后我们捐赠该快捷方式方式是在默认 INRelevantShortcutStore中设置relevantShortcut数组并在完成事件处理器中处理任何错误现在每次用户进行消费后系统可以提出小组件建议主动将小组件插入到智能叠放现在我们来谈 TimelineEntryRelevance 当你的小组件提供时间线给WidgetKit 你可以指定你的小组件的相关性通过在每个时间线条目中提供TimelineEntryRelevance 为条目下相关性的注解可表明小组件多值得在条目的时点进入智能旋转此旋转价值和小组件提供的时间线中的所有其他条目的价值是相对的所以你应该判断哪些条目可能对用户比较相关 TimelineEntryRelevance 是TimelineEntry上的可选结构属性条目的日期也是相关性结构包含一个分数和持续时间结构的浮动分数代表这个条目和其他条目相比相关性多高分数越高系统就越有可能旋转到那个小组件判断要返回哪些分数时记得正数分数表示有资格进入智能旋转的时间线条目若分数为零系统知道不应该旋转到那个小组件例如当小组件没有任何可显示的信息如果旋转到该小组件对用户来说不会是正面的体验记住任何所提供分数的显著性都是相对于小组件时间线的其他分数无论你决定相关性分数用哪种标准记得确定分数标准在返回的各时间线上都一致我们待会就会讲解一个例子相关性结构中的持续时间会指定相关性分数有效多久系统会用这个分数以及条目的日期判断将叠放轮换到小组件的有效时间范围在那段持续时间过去后系统会将分数当作零直到未来别的条目再次提供相关性你可以指定持续时间为零让分数持续有效直到下一个提供相关性的条目出现我们来看这个代码是什么样子这里是我们的 CardRecentPurchasesEntry结构它符合TimelineEntry协议因为协议要求一个可选相关性属性我们可以在结构中声明相关性属性现在当我们创建时间线条目我们可以在创建时间线时附加TimelineEntryRelevance实例到我们的条目现在让我们深入了解最近消费小组件的时间线可能长什么样子并且看可以为时间线相关性提供的分数范例这是一个范例时间线是最近消费小组件可能在一天中返回的时间线我们可能认为也许用户较关心金额较高的消费我们可以将消费的分数和花费金额成线性比例我们先将相关性持续时间保持为0 在8点15分既然没有消费可以显示我们会返回0的分数在9点41分 52美元60美分的消费代表分数会是52.6 以此类推绘制成图表后我们能看到比起其他分数这次疯狂购物的分数相对很高所以比起其他条目这个条目更可能让系统优先轮换到我们的小组件其他条目还是有正的分数所以系统还是可能在那些时候轮换到小组件只不过排序没那么高因为我们将持续时间设置为0 相关性分数会维持有效直到出现下一个有相关性更新的时间线条目我们也可以选择另一个打分机制假设我们在消费金额高于50美元时返回的分数是50 而低于50美元的消费分数是1 跟之前一样如果没有消费我们就返回0 对于我们的生鲜杂货消费我们返回50 而对于在浓汤小馆和电影院的消费我们返回1 有了分数图表我们可以看到分数在9点41分上升到50 并维持在那直到6点52分因为50是我们的时间线的最高可能分数系统最有可能在这段期间显示我们的小组件因为我们的小组件显示最近消费我们不想让系统旋转到我们的小组件时是显示很久以前的消费所以我们只让系统在消费后30分钟内旋转到我们的小组件为了做到这点我们可以用相关性结构上的持续时间属性我们为每个条目设置一个30分钟或1800秒的相关性持续时间通过将相关性持续时间设置为半小时我们叫系统在那半小时内将条目标示为有旋转的资格然后在那之后将它们标示为没有轮换的资格在这些例子中我们根据消费金额打分数但实际上时间线相关性分数可以是任何东西我们也可以用消费的信用卡打分或消费的地点消费时间或是完全不同的东西没有所谓正确的方式现在来谈捐赠INInteraction 在你的应用程序中你可以创建并捐赠用来配置你的小组件的意图通过INInteraction启用智能轮换和小组件建议应用程序捐赠INInteraction的时刻是每次用户查看和小组件显示的信息相对应的应用程序中的信息每笔捐赠都是一个数据点供系统的行为模型使用模型会学习用户通常是何时查看应用程序中的信息每当模型预测用户可能会再次执行交互时系统会为意图创建一个建议只要捐赠的意图和用来配置小组件的意图是同一个系统会自动从预测产出智能轮换以及小组件建议还有系统其他地方的建议为了开始在卡片项目中捐赠INInteraction 就像捐赠INRelevantShortcut 我们要确认我们的意图符合建议的资格并用配置小组件的必要参数创建一个支持组合这里也要记得最终要设计建议UI 用于当捐赠出现在系统的其他地方时在卡片应用程序中每当我们的用户查看某张卡片的所有最近消费我们可以捐赠小组件的意图让系统知道用户目前对我们的小组件显示的信息有兴趣首先我们将意图初始化我们将卡片参数设置为用户正在查看的卡片并将类别设置为"所有" 因为用户正在查看这张卡片的所有交易然后我们会用一个INInteraction 包住意图并调用捐赠方法现在系统会知道用户刚在我们的应用程序中查看过这张卡片的最近消费一阵子后系统可以学习用户通常何时会这样做并在最恰当的时机建议匹配的小组件你捐赠的INInteraction不只能启用智能轮换和小组件建议它们也让系统将你的意图以Siri建议形式显示在锁定屏幕聚焦和在Siri快捷方式建议小组件中就算你的小组件不采用意图也一样要了解更多关于捐赠INInteraction 可以为你的应用程序做什么并进一步利用设备内置智能一定要观看《Donate intents and expand your app's presence》所以 INRelevantShortcut TimelineEntryRelevance 和INInteraction这三种方式可以让你的小组件支持智能轮换和小组件建议由于系统中有其他捐赠还有表现考量捐赠并不保证你的小组件会出现但是通过条理清楚地采用这些API 你可以和系统合作尽可能提升你的小组件显示的可能性开发时有一点可能也会有帮助那就是通过开启WidgetKit开发者模式跳过系统关于浮现小组件的限制该模式就在设置应用程序中的开发者设置总结来说小组件建议是一种全新的方式让你的小组件能在你的用户需要它时主动出现即使用户原本可能根本不知道它的存在而对于已经添加到叠放中的小组件智能轮换让它们成为用户的一天中可靠又可依赖的一部分通过和系统合作和利用设备内置智能这些功能让你的小组件更容易被发现也更主动并协助营造智能主屏幕体验我们非常期待看到你会如何将智能添加到你的小组件谢谢收看祝你有美好的WWDC ♪

9:14 - Donate INRelevantShortcuts for Widget Suggestions

// Donate INRelevantShortcut for Widget Suggestions in app
// User has just made a purchase

var relevantShortcuts: [INRelevantShortcut] = []

let intent = ViewRecentPurchasesIntent()
intent.card = Card(identifier: card.identifier)
intent.category = .all

if let shortcut = INShortcut(intent: intent) {
    let relevantShortcut = INRelevantShortcut(shortcut: shortcut)
    relevantShortcut.shortcutRole = .information
    relevantShortcut.widgetKind = “CardRecentPurchasesWidget”

    let dateProvider = INDateRelevanceProvider(start: Date(), 
                                               end: Date(timeIntervalSinceNow: 1800))
    relevantShortcut.relevanceProviders = [dateProvider]

    relevantShortcuts.append(relevantShortcut)
}

INRelevantShortcutStore.default.setRelevantShortcuts(relevantShortcuts) { (error) in
    if let error = error {
        print("Failed to set relevant shortcuts. \(error))")
    } else {
        print("Relevant shortcuts set.")
    }
}

12:35 - Adopting TimelineEntryRelevance for Smart Rotate

// Appending TimelineEntryRelevance to a TimelineEntry in widget extension for Smart Rotate

struct CardRecentPurchasesEntry: TimelineEntry {
    let date: Date
    let relevance: TimelineEntryRelevance?
    let card: IntentCard?
    let category: PurchaseCategory
}

let relevance = TimelineEntryRelevance(score: 16.29, duration: 1800)
let entry = CardRecentPurchasesEntry(date: Date(), relevance: relevance, card: card,
                                     category: category)

17:01 - Donate INIntents through INInteraction for Widget Suggestions and Smart Rotations

// Donate INIntent in a card's purchases list in the app

.onAppear {
    let intent = ViewRecentPurchasesIntent()
    intent.card = Card(identifier: card.id.uuidString, displayString: card.name)
    intent.category = .all

    let interaction = INInteraction(intent: intent, response: nil)
    interaction.donate { error in
        if let error = error {
            print(error.localizedDescription)
        }
    }
}

正在查找特定内容？在上方输入一个主题，就能直接跳转到相应的精彩内容。

提交你查询的内容时出现错误。请检查互联网连接，然后再试一次。

资源

相关视频

WWDC21