“专注”过滤器简介

探索如何基于当前由其他人启用的“专注”对 App 行为进行自定义。我们将向您介绍如何使用 App 意图来定义您 App 的“专注”过滤器，在系统中针对更改执行操作，并且以不同的方式呈现您的 App 视图。我们还将讨论您可以如何过滤通知和更新角标计数。为能更好地理解此讲座，我们建议您先观看 WWDC22 的“深入了解 App 意图”。

资源

相关视频

WWDC22

下载

♪ 柔和乐器演奏的嘻哈音乐 ♪ ♪ 大家好我是 iOS 系统体验团队的工程师 Teja 本次讲座我们会来看看专注模式过滤器我们在 iOS 15 macOS Monterey 和 watchOS 8 中引入了专注模式用户可以通过设置系统在一段时间内的行为来帮助自己专注于当下最重要的事要启用专注模式只需进入控制中心选择默认或是自定义的专注模式即可当专注模式启用时用户可以自定义通知行为比如在工作模式下您也许会只允许来自同事的通知或者只允许来自某些与工作相关的特定 App 的通知每种专注模式的系统行为都可以在设置中调整 iOS 16 和 macOS Ventura 引入了专注模式过滤器来增强专注模式首先我会为您介绍专注模式过滤器以及它的行为模式其次要如何在您的 App 中定义专注模式过滤器然后我也介绍专注模式的过滤器要怎么实现最后您的 App 可以怎样把额外的上下文返回给系统专注模式过滤器可以让用户根据当前启用的专注模式自定 App 的行为模式一些系统 App 已经适配了专注模式过滤器可以用做范例日历 App 允许用户根据启用的专注模式设定默认显示的日历通常状态下我的日历是这样的如您所见在这里个人和工作上的日程是混在一起的我可以给日历设置一个专注模式过滤器让它在个人模式下只显示我的个人日程设置好专注模式过滤器后我的日历就变成了这样日历 App 会显示这是经过专注模式过滤的还提供了开关这个过滤器的选项现在我终于不会在个人时间被这些工作日程打扰了 Mail App 的收件箱可以根据过滤器在专注模式下只显示相关的邮箱还可以过滤 Mail 通知使其只突出显示相关的通知也就是说我可以让 Mail 在工作模式下只推送工作相关的邮件通知这样个人邮件通知就不会打扰到我为您的 App 加入专注模式过滤器的好处有很多也许您的 App 管理着多个账户一个账户会需要关联一个专注模式有大量数据的 App 也许需要为了专注模式过滤内容如果您想帮助用户在专注状态下免受打扰您可以通过减少标记 App 提醒以及通知的数量来突出专注模式下最重要的信息在外观上也许您的 App 可以根据启用的专注模式展示特定的主题或布局从本质上讲只要您的 App 可以根据不同情况展示不同内容您就可以利用专注模式过滤器改善用户体验我来说明一下专注模式过滤器的运作方式您的 App 定义了用户可以根据专注模式自定哪些内容这会通过 AppIntent 实现系统会暴露出可根据专注模式设置的部分您的 AppIntent 定义的属性可通过 UI 设置它会在专注模式设置中作为过滤器显示出来用户可以进入专注模式设置设置过滤器来设定您的 App 的运作方式现在让我来讲解如何把专注模式过滤器加入您的代码库中定义专注模式过滤器分为几步首先是启用 SetFocusFilterIntent 这会向系统表明您的 App 愿意根据专注模式提供自定设置第二步是定义 App 的参数即用户可以在您的 App 中调节哪些设置最后一步是设置显示内容这样您的过滤器才会在系统设置中显示正确的内容用户才能明白自己设置了什么用代码举例首先您需要 import AppIntents 定义一个实施了 SetFocusFilterIntent 的 struct 这就是您的专注模式过滤器设置标题和描述让用户知道您的专注模式有什么效果过滤器在设置中以网格状展示在专注模式过滤器设置完成之前这就是用户会看到的界面这里就是您的 App 的图标主要文本是 App 名次要文本则与您在过滤器中设置的标题对应当用户点击配置您的过滤器时会显示出同样的内容这时系统还会展示您提供的描述字符串以供参考标题和描述字符串都是静态的系统在安装您的 App 时就读取了它们定义您的专注模式过滤器时您必须提供一系列修饰为参数的属性用于指定用户可以自定的内容指定参数时必须为其命名并确定数据类型这些参数可以是标准数据类型比如 Bool, string, float 等等如果您希望设置某种自定义的数据类型您可以将其设为实体这样您就可以把它修饰为一个参数使用要学习更多关于实体和 App 意图的内容请观看“详解 App 意图”讲座定义专注模式过滤器时您只需要指定数据类型以及各参数名应用于各专注模式的参数值是由用户决定的可以把参数标记为可选项这样用户就不一定要设置它们非可选项的参数必须有一个默认值在代码中指定一个参数或可选参数的方法是：定义您希望出现在过滤器中的变量类型并将其修饰为一个参数在这里我创建了一个必选的 Bool 参数代表我的专注模式是否总是使用深色模式我把它的默认值设置为否我还创建了一个可选的 string 参数代表此专注模式下的用户状态最后我添加了一个可选的账户参数这是我的 App 定义的一个实体其包含了特定账户的信息这三个参数都设置了标题用于描述这些参数会在设置中展示给用户在专注模式设置中用户设置您的 App 的专注模式过滤器时设置界面会以类似我刚才展示过的网格的样子呈现但这次因为过滤器已经设置好了其内容会动态反映之前设置的内容这里仍然是您的 App 的图标主要文本和次要文本可以根据 FocusFilterIntent 中的显示内容属性自定义主要文本会显示出设置好了的参数比如选择账户设置状态等等次要文本会显示出设置好了的参数比如工作账户或工作中在我的代码中我设置了动态生成显示内容因为账户和状态都是可选参数它们只在用户设置之后才会出现在动态主次文本中由于 alwaysUseDarkMode 是一个必选参数它会始终包含在主要和次要文本中好了现在您定义好了专注模式过滤器用户可以在专注模式设置中为某个专注模式自定特定值了但您的 App 怎么知道用户自定了什么呢？您的 App 要如何适当更新自己？它必须根据系统的变化采取行动当专注模式发生了变化系统认为您的 App 有必要知道这个变化时它会用两种方式之一向您传达这个信息如果 App 正在运行而您已经部署了 FocusFilterIntent 它就会收到 perform 方法的调用如果 App 没有运行您可以部署一个扩展这样如果您已经在 FocusFilterIntent 中部署了 perform 它就会在扩展中被调用您的 App 和扩展都可以调用 perform 所以并非每个 App 都需要扩展一般来说如果您的 App 只是随着专注模式的改变更新界面外观那只在 App 内实现 perform 就足够了如果您的 App 的小组件、通知或标记都需要随着专注模式改变那您也许会需要部署一个扩展基本上如果您的 App 想要更新任何内部视图之外的东西您就需要部署扩展了在后面我会用“您的 App”这个词根据上下文不同它可能说的是您的 App 也可能是您的扩展要响应一个专注模式过滤器请部署 perform 函数访问设置中提供的参数的填充值依此更新您的 App 的外观与行为当系统认为您的 App 需要响应专注模式的变化时就会调用您的 perform 部署当系统认为先前提供的值不再有效时也会调用 perform 这种情况下您的过滤器参数会被设置成默认值当系统根据您的 App 的过滤器调用 perform 时所有参数会根据设置中设定的值填满要读取参数名的值可以调用 self.“参数名” 这个示例中在 perform 的最后我让 App 根据我收到的数据更新有时候您也许会需要询问当前的过滤器参数在我的案例中因为我的过滤器名叫 ExampleChatAppFocusFilter 我就要访问 ExampleChatAppFocusFilter.current

现在您的 App 可以根据专注模式过滤器行动了接下来就是进一步提升用户体验把您的 App 行为变化的额外上下文返回给系统

通过提供额外上下文您可以在 App 视图之外影响其行为比如过滤通知信息设定您的 App 的通知标记的数量一个给系统提供信息的方法是通过 AppContext 对象这个对象可以作为 perform 函数结果的一部分返回或者您可以在专注模式过滤器中随时返回 AppContext 并通过调用 invalidate 强制系统获取更新值当有专注模式过滤器启用时您的 App 也许有额外的上下文用来决定某个通知是否应该打断用户为了传递这个信息您的 App 必须在 AppContext 中设置 filterPredicate 属性这个“过滤器谓词”与一个叫做 filterCriteria 的新字符串属性共同工作在 UNNotification 上如果通知的过滤器与过滤器谓词(Predicate) 不符合该通知就会被静音要在 FocusFilterIntent 中设置过滤器谓词请把它加入您的 App 上下文中假如一台设备开启了个人专注模式用户在设置中只选中了个人账户在这种情况下我把过滤器谓词设置成个人账户的标识符如果收到的通知不是来自个人账户它就不会打断用户这里当我设置这个通知时我把 filterCriteria 设置成了工作账户的标识符因为我知道这个通知是要发送给工作账户的这个通知应该会被静音因为它的账户标识符与我刚刚设置的谓词不符它只和个人账户的标识符相符这是一个本地通知的示例但远程通知也可以通过 JSON 载荷来设置过滤器另一个给系统提供额外上下文的方法是更新您的 App 的标记数量以反映当前启用的专注模式下什么最重要这样可以防止您的用户分心在 UserNotifications 中有一个新的 API 为此设计在 UNUserNotificationCenter 上您只需用一个代表新标记值的无符号整数调用 setBadgeCount 即可现在您已经学会如何提供上下文以过滤通知或是设置标记数量了记住这个功能的目标是为了在用户需要专注时展示最有用的信息有时候这需要尽量减少展示不相关的内容以防止用户在启用专注模式时分心接下来请您思考一下您的 App 的哪些部分可以从专注模式过滤器中受益确定哪些属性可以配置设置好您的 App 和扩展来处理这些然后更进一步看看您是否需要提供额外上下文这就是专注模式过滤器！感谢您参加这次讲座祝您愉快度过接下来的 WWDC 时光 ♪

4:57 - Implementing SetFocusFilterIntent

// Implementing SetFocusFilterIntent

import AppIntents

struct ExampleChatAppFocusFilter: SetFocusFilterIntent {

    static var title: LocalizedStringResource = "Set account, status & look"
    static var description: LocalizedStringResource? = """
        Select an account, set your status, and configure
        the look of Example Chat App.
    """
}

7:02 - Defining your Parameters & Entities

// Defining your Parameters & Entities

import AppIntents

struct ExampleChatAppFocusFilter: SetFocusFilterIntent {

    @Parameter(title: "Use Dark Mode", default: false)
    var alwaysUseDarkMode: Bool

    @Parameter(title: "Status Message")
    var status: String?

    @Parameter(title: "Selected Account")
    var account: AccountEntity?

    // ...
}

8:43 - Display Representation

// Display Representation

struct ExampleChatAppFocusFilter: SetFocusFilterIntent {
    // ...
  
    var localizedDarkModeString: String {
        return self.alwaysUseDarkMode ? "Dark" : "Dynamic"
    }

    var displayRepresentation: DisplayRepresentation {
        var titleList: [LocalizedStringResource] = [], subtitleList: [String] = []
        if let account = self.account {
            titleList.append("Account")
            subtitleList.append(account.displayName)
        }
        if let status = self.status {
            titleList.append("Status")
            subtitleList.append(status)
        }
        titleList.append("Look")
        subtitleList.append(self.localizedDarkModeString)
    
        let title = LocalizedStringResource("Set \(titleList, format: .list(type: .and))")
        let subtitle = LocalizedStringResource("\(subtitleList.formatted())")

        return DisplayRepresentation(title: title, subtitle: subtitle)
    }
  
    // ...
}

11:24 - Implementing Perform on your Focus filter

// Implementing Perform on your Focus filter

import AppIntents

struct ExampleChatAppFocusFilter: SetFocusFilterIntent {
    // ...

    func perform() async throws -> some IntentResult {
        let myData = AppData(
            alwaysUseDarkMode: self.alwaysUseDarkMode,
            status: self.status,
            account: self.account
        )
        myModel.shared.updateAppWithData(myData)
        return .result()
    }
  
    // ...
}

11:47 - Calling Current

// Calling Current

import AppIntents

func updateCurrentFilter() async throws {
    do {
        let currentFilter = try await ExampleChatAppFocusFilter.current
        let myData = AppData(
            myRequiredBoolValue: currentFilter.myRequiredBoolValue,
            myOptionalStringValue: currentFilter.myOptionalStringValue,
            myOptionalAppEnum: currentFilter.myOptionalAppEnum,
            myAppEntity: currentFilter.myAppEntity
        )
        myModel.shared.updateAppWithData(myData)
    } catch let error {
        print("Error loading current filter: \(error.localizedDescription)")
        throw error
    }
}

13:27 - Set a filterPredicate

// Set filterPredicate on an App context

import AppIntents

struct ExampleChatAppFocusFilter: SetFocusFilterIntent {

    var appContext: FocusFilterAppContext {
        let allowedAccountList = [account.identifier]
        let predicate = NSPredicate(format: "SELF IN %@", allowedAccountList)
        return FocusFilterAppContext(notificationFilterPredicate: predicate)
    }
}

13:53 - Pass filterCriteria on UNNotificationContent

// Pass filterCriteria on UNNotificationContent

let content = UNMutableNotificationContent()
content.title = "Curt Rothert"
content.subtitle = "Slide Feedback"
content.body = "The run through today was great. I had few comments about slide 22 and 28."
content.filterCriteria = "work-account-identifier"

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