集中モードフィルタについて

集中モードフィルタについて

現在有効になっているユーザの集中モードに基づいてAppの動作をカスタマイズする方法をご確認ください。App インテントを使用して、Appの集中モードフィルタを定義したり、システムによる変更に対応させたり、Appのビューをさまざまな方法で表示したりする方法を紹介します。また、通知のフィルタリング方法やバッジカウントの更新方法も紹介します。このセッションを最大限に活用するには、WWDC22の「Appインテントの詳細」を最初にご覧ください。

リソース
関連ビデオ

WWDC22
- Appインテントの詳細
- WWDC22（1日目）のまとめ
ダウンロード

♪♪ ♪ iOS System ExperienceチームのTejaです集中モードフィルタがこのセッションのテーマです集中モードはiOS 15 macOS Monterey watchOS 8で導入されましたシステムの動作を設定して重要なことに集中できるようになります集中モードを有効にするにはコントロールセンターへシステムが提供する集中モードかカスタムの集中モードを選択します集中モードが有効な間は通知のカスタマイズが可能です例えば仕事の集中モードでは同僚からの通知のみを許可したり仕事関連の一部のAppからの通知のみを許可したりできます各集中モードについてシステムの挙動に関する設定とスケジュールが可能です iOS 16とmacOS Venturaは集中モードフィルタにより集中モードをさらに強化しますまず集中モードフィルタとその動作を紹介します次にAppで集中モードフィルタを定義する方法その後集中モードフィルタに対する操作が意味することについて最後にAppがシステムにいかに追加のコンテキストを提供できるか説明します集中モードフィルタは現在の集中モードに基づき Appの動作をカスタマイズする方法です集中モードフィルタ採用のシステムAppの素晴らしい例のいくつかですカレンダーAppではデフォルトで表示するカレンダーをフィルタリングできます普段はこんな感じこのように仕事と個人の予定が混在していますカレンダーの集中モードフィルタを設定し個人用カレンダーだけを表示できます集中モードフィルタ設定後これが私のカレンダーです集中モードによるフィルタリングが示されフィルタの切り替え方法が提供されていますこれで個人的な時間を楽しむときに仕事に邪魔されませんメールAppでもフィルタして特定のメールボックスのみを表示することができますメールの通知もフィルタされるので該当する通知だけが目立つよう強調表示されます仕事の集中モード中は個人的なメールの影響なしで仕事関連のメールのみ配信し影響を受けないよう設定できます集中モードフィルタを Appに実装する理由は色々考えられます Appが複数のアカウントを管理している場合特定のアカウントを集中モードに関連付けることをお勧めします大量のデータがあるAppの場合コンテンツのフィルタリングが必要になるかもしれませんユーザーが集中している時に気が散らないようバッジ数を減らしたり App内のアラートや通知を集中モードに対して減らします Appの見え方において集中モードに基づきテーマやレイアウトを適用することもできます Appが異なるコンテンツを表示できる場合集中モードフィルタでユーザー体験を向上させることができます集中モードフィルタの仕組みを説明しましょう Appにて集中モードごとにカスタマイズ可能なことを定義しますこれには Appインテントを使用しますシステムに集中モードごとに構成できる内容を示し Appインテントで定義されるプロパティを設定するUIは集中モードフィルタとして集中モードの設定に現れますユーザーがAppに対し集中モードフィルタを設定することで Appが特定の動作をするように設定が可能になります集中モードフィルタをコードベースに組み込む方法です集中モードフィルタの定義にはいくつかパーツがありますまずSetFocusFilterIntentを実装すること Appが集中モードごとのカスタム設定の意思があることをシステムに対し示します次にパラメータを定義しますこれらはApp内で設定できる内容を表したものです最後にディスプレイ表現を設定してシステム設定に集中モードフィルタの正しい内容を表示させるようにしますこれによりユーザは設定内容を認識できますコードの説明ですまずAppIntentsをインポート SetFocusFilterIntentを実装した構造体を定義しますこれが集中モードフィルタですタイトルと説明の設定でユーザーがその内容を見つけるのをサポートします集中モードフィルタは設定のグリッドビューに表示され集中モードフィルタの設定前はこのような感じでユーザーに表示されますアイコンは Appのアイコンプライマリテキストは Appの名前セカンダリテキストはユーザーがフィルタを設定すると集中モードフィルタの設定したタイトル変数と一致したものになりますフィルタの設定のためにタップをすると同じ内容が表示されますただしこの場合システムには追加情報として入力された説明文字も含む形となりますタイトルと説明文字は静的なもので Appのインストール時にシステムに読み取られます集中モードフィルタを定義する際にはプロパティの指定によりカスタマイズできる内容を示すことができますパラメータを指定する際は名前とデータ型を与える必要がありますパラメータは Bool型や float型文字列など標準データ型が使えさらにエンティティを使ってカスタムデータ型としてパラメーターを指定することもできますエンティティと Appインテントの詳細は「Appインテントの詳細」をご確認ください集中モードフィルタの定義はパラメーターのデータ型と名前の指定各集中モードで適用されるパラメータ値はユーザーが設定しますパラメータはオプショナルとしてマークが可能でその場合設定は任意ですオプショナルでない場合はデフォルト値を提供しますコードではパラメータまたはオプショナルパラメータの指定は集中モードフィルタ内で変数を定義し @Parameterを指定します集中モードフィルタが常にダークモードを使用かを表すBool型のパラメータを作成しました既定値はfalseですオプショナルの文字列パラメータも作成し集中モード中のステータスを表現します最後にAppで定義したエンティティである特定のアカウント情報を含むアカウントパラメータをオプショナルで用意しましたそれぞれのパラメータに設定されるタイトルはパラメータの説明のため設定で表示されます集中モードの設定で集中モードフィルタを設定すると先ほどと同様にグリッドに表示されます今回はフィルタが既に構成されているため内容を反映させるダイナミックな内容になりますアイコンはAppと同じプライマリテキストとセカンダリテキストは FocusFilterIntentのディスプレイ表現プロパティでカスタマイズできますプライマリテキストは Select Account Set Status などといった表現でどのパラメータが設定されているかを表現しますセカンダリテキストは Work AccountやWorkingなどパラメータの設定内容を表現する必要があります私のコードではディスプレイ表現を動的に生成するように設定しましたアカウントとステータスはオプショナルなので実際に設定された場合のみ動的な形でテキストに含まれます alwaysUseDarkModeは必須のパラメータなので両方のテキストに含まれます集中モードフィルタの定義ができました集中モード設定に行くと特定の値をカスタマイズできますカスタマイズされたことを Appが知る方法は？そしてそれに応じて App自体を更新するには？システムからの変化に対応する必要があります集中モードの変更が発生しシステムがそれがAppに対し重要なものだと判断した場合いずれかの方法でその情報をAppに提供します Appが起動中であれば FocusFilterIntent内の performメソッドが呼び出しを受けます起動してない場合 Extensionを実装することで対応できます FocusFilterIntentに performを実装していれば Extensionで呼び出されます performはAppからも Extensionからも稼働しますがすべてのAppにExtensionが必要ということではありません通常集中モードの遷移に対応して自身のViewを更新するだけなら Appでのみperformを実装するだけで十分です Appのウィジェット通知などを集中モード遷移に基づいて変化させる場合は Extensionの実装を検討する必要があります基本的にAppが View以外を更新する場合は Extensionの実装が必要ですこれ以降の「みなさんのApp」といった場合 AppとExtensionのいずれかを意味することもあります集中モードフィルタに対応するには perform関数を実装し設定で提供されるパラメータ値にアクセスし AppのViewと動作を更新します performの実装は Appが Focusの遷移に必要と判断すると呼び出されます performは以前に提供された値が適切なものではなくなったと判断された場合にも呼び出されますこの場合集中モードフィルタのパラメータはデフォルト値で設定されます performが呼び出されると設定内容と一致するパラメータの値が入力されます指定のパラメータ値を読み取るには self."name of the parameter."からこの例では performの最後に受け取ったデータで Appを更新します時には現在のパラメーターを照会したい場合があるかもしれません私の場合 ExampleChatApp FocusFilterなので ExampleChatAppFocus Filter.currentにアクセスします
これで対応できます次の手順ではAppがどう変更されたかの追加のコンテキストを提供することでユーザー体験の向上実現します
追加のコンテキストを提供すると Viewの外部にも影響を与えることができますたとえば通知のフィルタリングや Appの通知バッジ数の設定などです情報提供の方法のひとつが AppContextデータを経由するものですこのデータは performメソッドの結果の一部として戻せるものですあるいは集中モードフィルタで任意でAppContextを返し invalidateを呼び出しシステムに更新値を取得させることもできます集中モードフィルタが有効な場合特定の通知が割り込みにとなるかを判断する追加コンテキストを持てますこの情報を渡すためには filterPredicateプロパティの設定が必要ですこのFilter Predicateは filterCriteriaという新しい文字列を使い連携動作します通知のフィルタ基準が Filter Predicateと一致しない場合は通知は消音となります FocusFilterIntentからの Filter Predicate設定は App Contextにそれを含めますパーソナルの集中モードが有効でユーザーが個人アカウントを選択し集中モードを設定したとします個人アカウントの識別子を Filter Predicateに設定受信する通知が個人アカウントからでない場合ユーザーの作業を中断しないようにこの通知を設定するとき filterCriteriaを仕事用アカウントのIDに設定通知が仕事用アカウントに行くことを把握しているのでこの場合アカウントが一致しないため通知は消音された形になりますなぜならアカウント識別子は私が先ほど設定した個人の識別子と一致しないためですこれはローカル通知用ですがフィルタの条件をリモート通知の JSONペイロードにすることもできますシステムに追加のコンテキストを提供する別の方法は Appのバッジ数を更新して集中モードにとって重要なものだけを反映させることですこれでユーザーが集中できるようになります UNUserNotificationsにそれ用の新しいAPIがあります UNUserNotificationCenterでは新しいバッジの値を表す setBadgeCountを呼び出すだけですバッジ数の設定など追加のコンテキストを提供する方法が分かりましたこの機能の目的は集中モードに対する最も関連性の高いことをユーザーに提供することです集中モードの邪魔にならぬようコンテンツの最小化が必要なこともあるでしょう次のステップは Appのどの部分に集中モードフィルタが有効かその検討と特性を決定し AppとExtensionの設定と処理追加コンテキストの提供でさらに一歩踏み込んで判断することです以上が集中モードフィルタですありがとうございました 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"

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

リソース

関連ビデオ

WWDC22