優れたウィジェットの原則

優れたウィジェットの原則

ウィジェットの関連性とカスタマイズ性を維持することで、優れたウィジェットの基盤要素について検証します。タイムラインエントリとTimelineReloadPoliciesを使用してウィジェットを最新の状態に保つ方法を確認します。異なる表示環境や物理的位置にウィジェットを適応させる方法についても紹介します。最後に、ユーザの希望どおりにパーソナライズできるカスタマイズ可能なウィジェットを作成する方法を解説します。

リソース
関連ビデオ

WWDC22
- コンプリケーションとウィジェット：リローデッド
WWDC21
WWDC20
ダウンロード

♪ ♪ こんにちはシステムエクスペリエンスチームのエンジニアのブレッド･ケートーです今日のテーマは優れたウィジェットの原則最高のウィジェットを作るのに役立つホットな話題をご紹介します私たちはiOS 14に WidgetKitを導入しました WidgetKitにより美しくダイナミックなマルチプラットフォームのウィジェットを作成でき iOSやiPadOS macOSのホーム画面上に直接配置できます
スタートする前に WWDC 2020を見逃した方には素晴らしい講演があります ”WidgetKitについて”は WidgetKitフレームワークとそのコアコンセプトを紹介します ”Widget Code-Along”は複雑さを増していくウィジェット構築について基礎から応用まで３部構成で紹介します ”ウィジェットにおける SwiftUIビューの構築”では SwiftUIを最大限に活用してウィジェットに適応可能なビューの構築方法を説明しています最後に”優れたウィジェットをデザインする”ではデザインの考察をヒューマン・インターフェース・グループが解説します
今日は優れたウィジェットのための２つのトピック関連性の維持とカスタマイズについて話しますそれではまず関連性について関連性には３つのタイプがありますウィジットが最新の状態であるかや環境に適応しているか確認するために私たちが徹底的に議論すべきことですでは時間とプレゼンテーションそして場所という関連性についてお話します WidgetKitの中心となるのはタイムラインですこれは一日中関連性を保つための Widgetsの核となる仕組みですタイムラインは複数のエントリで構成されていますこの例では３つのエントリが表示されています午前９時午前９時３０分そして午前１０時システムがウィジェットにタイムラインを要求するとき結果のタイムラインはアーカイブされエントリが指定した時間に表示されますこれによりユーザーがユーザーインターフェースを必要とするときにすぐに表示できるようにしますいくつか例を見てみましょう最も単純なものからその中にどのようなコンテンツがあるのか
ここでは最もシンプルなタイムラインの例としてシングルエントリであるスクリーンタイムですさてスクリーンタイムは未来のデータを予測することはできません厳密にユーザーのデバイスがどう使用されたかという統計的な履歴にもとづいていますタイムラインにおける複数のエントリの利用はできませんそのため単一のエントリを使用しますこれが最もシンプルなタイムラインですとはいえすべてのウィジェットがシングルエントリである必要はありません考えてみてくださいなぜタイムラインに複数のエントリを提供しないのかもし将来性のあるコンテンツや重要な日付や期限があるときまたはコンテンツの将来を予測できる場合はウィジェットはタイムラインで複数のエントリを利用すべきです別の例として天気の場合ですご覧の通り天気のタイムラインでは１日の終わりに向けて複数のエントリがあります現時点では最初のエントリが最も正確ですなぜなら現時点での天気を示しているからですそれ以降のエントリはすべて予測データを表していますこの追加の予測データが非常に便利ですウィジェットのリロードは指定した正確な時間にリロードされると限りませんそしてリロードがその目標の時間に発生しなかった場合予測されたコンテンツがあることによりユーザーの利便性が向上します
写真の例をご紹介します写真のタイムラインには個人的または関連する写真が１日のうちの特定の時間に表示されます私にとってはこれらは本当に素晴らしい思い出ですそして１日に数回しかリロードされませんが複数のタイムラインエントリから新しい新鮮なコンテンツを提示することで常に活気に満ちた印象を与えていますご覧のように天気のような予測可能なデータがなくてもこの写真の例のようにユーザーに関連するコンテンツを取り組みタイムラインの複数のエントリを活用して驚きと喜びを与えることができます
さてウィジェットの中には他よりも多く見られるものもあるので更新の公平性を与えることにしましたこれを”アップデートバジェット”と呼んでいます１日の中で蓄積されていきユーザーの視聴習慣に大きく影響されますよく見られるウィジットは１日に約４０から７０回バックグランドで更新できますこれはユーザーが起きている通常の時間帯に均等に配置した場合約１５分から３０分ごとに更新されることになりますしかし当然のことながら全てのリロードが等間隔で行われる必要はありません私たちの目的とするのはさまざまな要求に応じた多様な更新サイクルのサポートです
例えばスポーツウィジェットがあるとします好きなチームの試合開始前はほとんど動いていない状態ですが試合前試合中そして試合後に多くのスコアの更新情報を受け取ることができます
WidgetKitはスマートでユーザが寝ているときなど長時間デバイスを使用していないときはアップデートを保留することがありますあるいは特定のウィジェットのバジェットが利用可能になるまで更新が保留されることがありますとはいえリロードは毎秒といったオペレーションではありませんウィジェットはホーム画面上でライブ感を演出するものではありませんあなたのウィジェットを１日中更新させる方法は数多くありますこれからそれぞれの機能を簡単に説明しその内容と仕組みを解説していきます先ほどご紹介したバジェットとの関係についてもどのように機能するのかご説明します１つ目は TimelineReloadPolicyですこれはWidgetKitのAPIですこれは自動的に行われるリロードの中核となる仕組みですタイムラインを提供する場合リロードポリシーも一緒に提供しますこのリロードポリシーはバックグランドで自動的にウィジェットに更新したいタイミングをシステムに通知しますこれらの自動更新はあなたのウィジェットの現在の利用可能なバジェットが消費されます
次は WidgetCenterのリロードAPIですウィジェットの既存データが無効になる事態が起きた時あなたのウィジェットをリフレッシュするAPIです通常このAPIを使ったリクエストは利用可能なバジェットを消費しますつまりアップデートはバジェットが利用可能になるまで行われませんしかしこのようなリロードをすぐにまたバジェットをかけずに行うことができる例外的な状況がありますあなたのコンテナAppがフォアグラウンドである時やナビゲーションやオーディオの再生など Appがユーザーセッションに参加している時です
このAPIは TimelineReloadPolicy API による自動バックグランドの更新を補充するものです ⁪著しく位置が変わった時にもウィジェットを更新できますウィジェットが位置情報を使用しておりさらにシステムが著しい位置情報の変更を検知するとバジェットに影響を与えずにアップデートすることができますリフレッシュはユーザーが次にウィジェット表示した時更新されるので位置情報が適切に解決されますただこれは位置情報の変更が発生した時や次にユーザーがウィジェットを見た時にすぐに起こることを保証するものではありません位置情報については後でも少し詳しくお話しますシステムは表示環境が変化した場合もウィジェットを更新します例えばユーザーがダイナミックテキストや太字などのアクセシビリティの設定を変更した場合や言語や地域 iCloudまたはApp Storeのアカウントの変更大幅な時間の変更などが考えられます最後にバジェットの関係でユーザーが滅多に見られないウィジットをもっている場合開発者がのぞむほどに更新されないかもしれませんあなたのタイムラインにどのような日付のものがあるのかそして好みの更新時間をシステムは把握していますさらにユーザーの一般的な閲覧履歴もですシステムはユーザーが閲覧したときにデータが古くなっている可能性がある場合バジェットのないリロードを許可することがありますもちろんこれら全てのシステム主導の更新は常にバジェットに影響を与えません先程の話のようにそれぞれのタイムラインはリロードポリシーとペアでバックグランドでいつ自動的に更新されるかを示します WidgetKitでは”atEnd” ”afterDate””never” の３つの選択肢がありますこの3つのリロードポリシーのうちあなたのウィジェットに適切なリロードポリシーは？さあそれぞれについて例を上げて説明しましょうそしてそれぞれについて注意すべき点を説明しましょう
最初はatEndリロードポリシーの紹介ですこのポリシーはタイムラインが終了した時にあなたのウィジェットが更新されます当然最後のエントリが関連するようになった時です今回の場合は午前１０時３０分です注意してくださいこの時間は単にウィジェットが更新できるようになった時間です更新を保証するものではありませんさらに atEndを使用する場合 Screen Timeの例のようにタイムラインが一つしかないウィジェットではシステムがウィジェットに対する適切な時間を選択してくれますあなたのウィジットが現在のタイムラインの寿命をこえるコンテンツがすでにあるなら AtEndをお勧めしますウィンドウのようにコンテンツを見て考えるのが良いでしょう例を見てみましょうここにあるのはカレンダーウィジェットの現在のタイムラインが６月７日のものです４つのエントリーがあります過去と未来のコンテンツも含めてウインドウを見せるために６月８日のタイムラインに変更してみましょうウィンドウを内容にあわせて表示することはどういうことか確認ができます
再び６月９日のタイムラインを見ましょう私たちはただユーザーから提供されたデータの見方を変えるだけですこのようなコンテンツこそ atEndポリシーの真価が発揮される場面だと思います
atEndポリシーを利用したウィジェットの例としてはリマインダーカレンダー写真 Tipsなどがあります繰り返しですがこれらはウィンドウとして見れる未来に無限のコンテンツを持つウィジェットですシングルエントリのタイムラインはシステムがリロード時間を選択するためあまり適していませんあなたが望んでいるものではないでしょう時間が経つと関連性や正確性を失うような予測コンテンツがある場合もお勧めできません私たちはシンプルにあなたのコンテンツが最も関連性が高くなるようにしたいのですもし私たちがタイムラインの最後まで待っていたら最も関連性の低いものが更新の対象になってしまいますそれでは最高のユーザー体験にならないのですこれがatEndですね次は afterDateについてリロードポリシーは指定された日付の後にウィジェットをリロード対象にします afterDateを使用すると対象となる時間を完全にコントロールすることができますこの例ではタイムラインは午前９時から午前11時頃までとしますウィジェットのリロードポリシーの日付は午前９時３０分を選択これは午前９時４５分から予測データの精度が低下し始めるからですこれにより午前９時３０分にすぐにリロードされなくてもウィジェットには予測データが表示されます
afterDateは１日を通して予測できないあるいは
正確性や関連性が定期的に変化するデータに最適です
afterDateを使用するウィジェットの例としては株価天気ニュースメールなどがありますこれらは予測できないまたは予測せぬ形で変化する可能性のあるコンテンツをもつウィジェットですさてafterDateではいくつかの潜在的な問題に注意しなければなりません注意すべき点は即座にリロードを行うこと 1分程度先の日付を指定することは有効ですが通常は非常に限られた時間の中でのみ有効ですこのレベルの解像度で更新の回数が多すぎると後でリロードできなくなります
また多くのデバイスでウィジェットの更新日を合わせる場合にも注意が必要です例えば東海岸では午前９時３０分に米国株式市場が開かれその日の最初のデータをサーバーから取得します覚えておいてくださいあなたのウィジェットは数千、数百万のデバイスに表示される可能性がありそれぞれのデバイスで複数回表示される可能性もありますこのように時間を合わせてデータを取り出す必要がある場合はキャッシングサーバにヒットするだけでなくこれらの日付にある程度のランダムジッタを追加することを検討する必要がありますこれらは想定外のコストや不必要なコストが発生しないようにするために特に重要です最後に私のお気に入りのリロードポリシー neverについてお話しましょう neverリロードポリシーは自動的なリロードがないので最もシンプルなポリシーですウィジェットのコンテンツがコンテナAppがフォアグラウンドになることやプッシュ通知のような個別のイベントでのみそのコンテンツが変化する場合 neverはウィジェットに最適な選択肢です neverポリシーを利用すると WidgetCenterのリロードAPI またはその他の付属拡張機能を使用しウィジェットを最新の状態に保ちますこれによりリロードが発生を最小限にしバジェットやユーザーのバッテリーへの影響を最小限に抑えることができますウィジェットが App内でまだ満たされていないような明確なユーザー条件を必要とする場合にも有効です例えばサービスへのログインや特定のコンテンツの購入などが必要な場合にも Neverは最適ですこのような条件が揃うまで意味のある情報を提供できない場合 neverを検討されると良いでしょう neverポリシーを使用するウィジェットの例に TV メモ音楽 Podcast 連絡先などがありますこれらのウィジェットや Appはコンテンツの変更を促すために App内でのユーザー操作を必要としたりコンテンツの更新のプッシュ通知を受け取けとりますタイムラインエントリを活用しましょうウィジットに適したリロードポリシーを選択し WidgetCenterのreload APIを使用し個別のイベントでタイムラインをリロードしてくださいでは関連性におけるプレゼンテーションに移りましょうあなたのウィジェットは iOSやmacOSの特定の状況で表示されることがありウィジェットの姿が変わる可能性がありますウィジェットはタイムラインの更新なしに再レンダリングされることがあります優れたウィジェットは常にこれらのプレゼンテーション環境に適切に適応しますダークモードとライトモード iOS 15に導入された部分的なプライバシー対応そして完全なプライバシ― 対応について説明します
WidgetKitはシステム設定の変更に応じてコンテンツをライトモードとダークモードの間で自動的に移行させますこのために SwiftUIの力を借りていますではウィジェットをそれぞれの状況でどのように見せたいかを考えてみましょうここにライトとダークの配色のメモとカレンダーの例があります忘れてはいけなのがすべてのウィジェットがライトやダークモードに合わせ背景やテキストカラーを変更する必要はないということです例えばミュージックや株価などのウィジェットなど色を変更しないウィジェットもありますあなたのAppデザインがダークもしくはライトなスタイルの高コントラストコンテンツにこだわらない場合はあなたのウィジェットに適した配色を自由に選んでください
ウィジェットの配所変更は Xcode Previewsでプレビューできます systemSmall widgetをライトモードでプレビューした簡単な例です
今度はダークモードですこの環境でウィジェットがどのように表示されるかプレビューするために colorScheme環境のオーバーライドを追加するだけでした次に示すようにライトとダークモードのシステム標準の背景色を使用する場合は BackgroundStyleを使用してください
ウィジェットは iOSロック画面などプライバシーに配慮した環境にも適用されます iOS 15の新機能としてウィジェットでは部分的なコンテンツ対応ができるようになりましたさてこれはとてもわかりにくいと思いますではいったい何のことか例をあげて説明しましょう
特定の口座で利用可能な残高を表示する銀行のウィジェットがあったとしますこのケースは口座に 128.45ドルあります
ロック画面に移動してデバイスをロックするとこのアカウントの残高は iOS 14では表示されますなぜなら WidgetKitにはデバイスがロックされた際に残高情報を動的に消去する方法がなかったからですしかし iOS 15ではそれが変わりましたこれらの状況で対応を加える特定のビューをコンテキストによってマーク可能となりましたではその方法をご紹介しましょう privacySensitiveというビューモディファイアを残高金額を表すテキストに挿入するだけですつまりパスコードロックされていないときはここで見られるようにビューにはまだ残高が表示されますしかし今度はデバイスをロックしてみると残高表示は隠されたつまり対応が加えられた状態になります
またこのモディファイアは hstackやvstackのようなコンテナビューを含むどのビューにも適用できることに注意してくださいまたコンテナに適用した場合コンテナ全体が対応が加えられます
iOS デバイスがパスコードロック状態のときアクセス不可の完全なデータ保護を利用するAppの場合例えば Appがヘルスデータを使用していてウィジェットの作成をスキップするかロック画面に表示することにある種の恐れがある場合この機能はその状況に適しています
WidgetKitではアクティブなタイムラインコンテンツをプレースホルダコンテンツに自動的に置き換えますデバイスがパスコードロックされている場合コンテンツへの完全な対応を行う場合に使用しますまたデバイスがパスコードロックされている間は更新を保留することができますこれはここに示す Default-data-protection entitlementを使用した場合に可能ですタイムラインデータはデバイス上のデータクラスの希望に応じて保存されます私たちはみなさんのデータプライバシーを大切にします最後に関連性における位置情報についてウィジェットは Appと同様に現在の物理的な位置やシンプルに関連する場所などのコンテキスト情報をさまざまな方法で提供することができます
あなたのAppが位置情報を使用している場合ウィジェットでも位置情報を利用することができますウィジェットはホーム画面と Macの通知センターに複数のインスタンスを持つことができるためインテント機能を使って天気ウィジェットを操作するのと同じようにウィジェットに対してあらかじめ選択された場所や検索可能な場所を提供することを検討してくださいさてウィジットで現在地を取得するにはいくつかのステップが必要になりますまず Info.plist に NSWidgetUsesLocation キーを指定する必要がありますこれによりウィジットの Extensionで位置情報を使用することがシステムに通知されます次に通常通り CLLocationManagerを使用します　ただし今回はウィジェットExtensionの TimelineProvider から使用しますウィジェットが必要とする解像度を考慮してください大まかな位置情報を解決する方が早いからです超精密な位置情報を必要としないのであればより良いユーザー体験を提供できます一般的には位置情報のリクエストが正確なものであればあるほど解決には時間がかかります
最後に CLLocationManagerの isAuthorizedForWidgetUpdates APIを使いウィジェットがロケーション更新に対して許可されているかどうか確認できますこれによりユーザーが位置情報を使用するためのウィジェット権限を付与したかがわかりますパーミッションを見てみましょう詳しくはこちらですウィジェットのロケーションパーミッション機能を見てみましょうパーミッションは通常そのAppコンテナと共有されますここでは設定Appから利用できる位置情報の一覧が表示されています
ユーザーが”Appの使用中” を選択した場合ユーザーの位置情報はコンテナAppがフォアグラウンドであるときまたはナビセッション中など Appが使用中であると考えられる状況でのみウィジェットで使用可能になります
ユーザーが”Appまたはウィジェットを使用中” を選択した場合は ”Appの使用中 " と同様に位置情報を利用できますただしウィジェット固有の許可が追加されますこれによりウィジェットにおけるパーミッションが最後の閲覧から１５分以内であれば位置情報を受け取れるようになりますまたこれらの２つのパーミッションセットのいずれかで位置情報が解決できない場合は代替コンテンツを検討し利用可能であれば以前のコンテンツも検討か単に位置情報が解決できなかったことを示すだけです
ユーザーが"常に"を選択した場合ウィジェットは常に位置情報にアクセスする利用可能なパーミッションを持つことになります最後にカスタマイズ可能なウィジェットの作成ですユーザーがウィジェットをパーソナライズするためサイズ種類構成について説明しますウィジェットには様々なサイズがありますウィジェットを配置する際に選択できるようにできるだけ多くのサイズをサポートすることをお勧めしますデバイス間でサイズにわずかな違いがありますシステム標準のパディングマージンテキストスタイルテキストサイズを使用することをお勧めします
さて iPadを見てみるとコンテンツショーケースに変換されます iPad専用の新しいサイズが iOS 15で追加されましたエクストララージと呼んでいます
ここにあるのでよく見ることができます大きなウィジェットと同じ高さですが iPadで利用可能なコンテンツがさらに多く表示されるようになりました systemLargeファミリーを既にサポートしている既存のウィジェット構成に追加しましたデフォルトではウィジェットの設定でサポートされているファミリーを指定しない場合 iOS 15 SDK またはそれ以降でビルドすると新しいサイズが自動的にサポートされます
パーソナライゼーションの次の軸はウィジェットの種類ですウィジェットの種類によってデータやコンテンツをさまざまな角度から見ることができます Appで最も効果的なウィジェットの種類を考えてみましょうこれらの説明の最良の方法は実際の例をあげることです以下は時計の例です左側には１都市の時間を追跡する City ウィジェットがあります右側には同じビューで多数の異なる都市に対応できる World Clock ウィジェットがありますこちらは株式における別の例です左側には株式記号のウィジェットがありますこれはある銘柄の株価を表示していますこの例では Appleですそして右側には概要ウィジェットがあります概要ウィジェットはユーザーのストックAppに反映されている一連の銘柄を表示します異なる種類のウィジェットをどうやって公開するのか？複数の種類のウィジェットの公開は極めて簡単です
先程の株式の例を使って見ましょうここでは左上にシンボルウィジェットと概要ウィジェットがありますこれらを公開するには WidgetBundleオブジェクトでさまざまなウィジェット構成を返し WidgetBundleに @main属性を含めますとても簡単ですねバンドル内で定義されるウィジェットの順序も非常に重要であることに注意してくださいこの順序はウィジェットがウィジェットギャラリーにどのように表示されるかを反映していますですから必ず最初にあげたウィジェットがヒーローユースケースであることを確認してください最後に Appのインストール後にウィジェットの可用性を動的に公開したり撤回したりすることはできませんウィジェットのサポートには時間の経過とともにいくつかの配慮が必要です
カスタマイズ可能性の最後の軸は構成を介して行われますそしてウィジェットは２種類をサポートしています静的およびインテントベース構成です静的ウィジェット構成ではウィジェットインスタンスそれぞれに同じコンテンツが提供されます前回の株式の概要の例を思い出してください各コンテンツはデバイス上の異なる場所にあってもまったく同じコンテンツを表示します静的ウィジェットは非常にシンプルでユーザーから構成やセットアップを取得しないため洗練されたウィジェット定義になっています
その一方でインテントウィジェット構成ではユーザーが設定したコンテンツを提供します右側の株式銘柄ウィジェットをご覧くださいこのユーザーは様々なインスタンスを設定をしそれぞれのインスタンスに異なる銘柄を表示していますさてこれはとても素晴らしいものですホーム画面上のウィジェットをスタックに入れ表示することでスペースを節約できますではどのようにしてユーザが設定行えるのでしょうかユーザーの視点から見るとシステムは関連するUIをすべて提供しますインテントをサポートしている場合編集モードでウィジェットをタップすると構成プラッタが表示されますユーザーが設定できるインテントのパラメータリストが表示されますこの例ではシンボルを追跡するための１つのパラメータがありますその値は現在Apple株の文字列AAPLとなっていますさてユーザーがパラメータをタップすると入力コントローラが表示されユーザーからの入力を得ます完了するとウィジェットが自動的に更新されますインテントでできるカスタマイズは多数あります WWDC 2020については素晴らしい講演がありインテントの設定をしたい方はこの後にご紹介しますとりあえずインテントに基づいてウィジェットをコーディングする場合と静的な構成に基づいてコーディングする場合の違いを簡単に説明します
静的な構成は本当にシンプルです TimelineProviderで StaticConfiguration オブジェクトをインスタンス化するだけですこれをインテントの構成と比べてみましょう StaticConfigurationは IntentConfigurationに
TimelineProviderは IntentTimelineProvider に置き換えられていることだけが違いです各インターフェースはインテントのサポートのため若干変更されていますこれによりタイムラインのデータ入力時にユーザーによる構成のインテントを受信できますサポートされているさまざまなデータタイプと構成UIからの外観などウィジェットのインテントの作成と構成の詳細については WWDC 2020の “Widgetに設定とインテリジェンスを追加する” を参照してください
まとめます優れたウィジェットがどのようにタイムラインのエントリを利用しリロードポリシーをマスターしてプレゼンテーションや潜在的な物理環境に適応するかを確認しましたさまざまなサイズ種類構成を提供してダイナミックでパーソナライズされた体験をユーザーに提供することを計画しましょうありがとうございました

15:46 - Xcode Previews for Widget Views with Color Scheme Overrides

struct MyWidgetEntryView : View {
    var date: Date

    var body: some View {
        ZStack {
            Rectangle().fill(BackgroundStyle())
            VStack {
                Text("Hello")
            }
        }
    }
}

struct MyWidget_Previews: PreviewProvider {
    static var previews: some View {
        MyWidgetEntryView(date: Date())
            .previewContext(WidgetPreviewContext(family: .systemSmall))
            .environment(\.colorScheme, .dark)
    }
}

16:34 - Widget Partial Privacy Redactions - Banking Example

struct MyWidgetEntryView : View {

    var body: some View {
        ZStack {
            Rectangle().fill(BackgroundStyle())
            VStack(alignment: .leading) {
                Text("Balance")
                    .font(.largeTitle)
                    .fontWeight(.bold)
                    .foregroundColor(Color.blue)
                Text("$128.45")
                    .privacySensitive()
                    .font(.title2)
                    .foregroundColor(Color.gray)
            }
        }
    }
}

23:08 - WidgetBundle Example

struct IndividualSymbolWidget : Widget {
    var body: some WidgetConfiguration {
    …
}
}

struct StocksOverviewWidget : Widget {
    var body: some WidgetConfiguration {
    …
    }
}

@main
struct MyWidgetBundle: WidgetBundle {
    var body: some Widget {
        // Order of these widgets defines the order in the Widget Gallery
        IndividualSymbolWidget()
        StocksOverviewWidget()
    }
}

25:43 - Static Widget Configuration Example

@main
public struct SampleWidget: Widget {
    public var body: some WidgetConfiguration {
        StaticConfiguration(kind: "com.sample.myStaticSampleWidgetKind",
                            provider: Provider()) { entry in
                                SampleWidgetEntryView(entry: entry)
                            }
        .configurationDisplayName("My Widget")
        .description("This is an example widget.")
    }
}

public struct Provider: TimelineProvider {
    public func timeline(with context: Context,
                         completion: @escaping (Timeline<Entry>) -> ()) {
        let entry = SimpleEntry(date: Date())
        // TODO: Generate a timeline entry
        completion(timeline)
    }
}

25:55 - Intent Widget Configuration Example

@main
public struct SampleWidget: Widget {
    public var body: some WidgetConfiguration {
        IntentConfiguration(kind: "com.sample.myIntentSampleWidgetKind",
                            intent: SampleConfigurationIntent.self
                            provider: Provider()) { entry in
                                SampleWidgetEntryView(entry: entry)
                            }
        .configurationDisplayName("My Widget")
        .description("This is an example widget.")
    }
}

public struct Provider: IntentTimelineProvider {
    public func timeline(for configuration: SampleConfigurationIntent, with context: Context,
                         completion: @escaping (Timeline<Entry>) -> ()) {
        let entry = SimpleEntry(date: Date(), configuration: configuration)
        // generate a timeline
        completion(timeline)
    }
}

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

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

リソース

関連ビデオ

WWDC22

WWDC21

WWDC20