App Intentの最新テクノロジーの詳細

App Intentの最新テクノロジーの詳細

今年のリリースでApp Intentフレームワークに追加されたすべての新しい機能強化を紹介します。デベロッパの生産性向上に役立つ機能強化（遅延プロパティなど）、および新機能（インタラクティブなApp Intentスニペット、エンティティビューの注釈、ビジュアルインテリジェンスの統合など）について説明します。これまで以上に表現力が高まると同時に、より簡単かつスムーズに導入できるようになったApp Intentについても詳しく説明します。さらに、今年App Intentの対象に追加された新しいエキサイティングなクライアント（Spotlight、ビジュアルインテリジェンスなど）を紹介し、それらのコンテキストでスムーズに動作するApp Intentの作成方法についても解説します。

関連する章
- 0:00 - イントロダクション
- 0:55 - インタラクティブスニペット
- 8:15 - システム統合のための新機能
- 15:01 - より高度なユーザー体験
- 21:02 - 便利なAPI
リソース
関連ビデオ

WWDC25
WWDC24
こんにちは App Intentチームのエンジニア Jeffです今日は App Intentの新たな進歩について紹介します
App Intentによって皆さんはショートカット、Spotlight Visual Intelligenceなども含め使用するデバイス全体にアプリの機能を組み込めるようになります
フレームワークに詳しくない方はまず「App Intentの基礎知識」をご覧になることをお勧めしますこちらのビデオはいつでもご覧いただけます今回お伝えする内容はインタラクティブスニペットで構築できる新しい体験やアプリによってシステム全体で App Intentを活用する様々な方法やアプリのユーザー体験を洗練させるために使用できるその他の機能やデベロッパ体験の向上をめざして追加された便利な各種APIなど盛りだくさんですではインタラクティブスニペットの紹介から始めましょう
スニペットでは App Intentにより確認の要求や結果の表示をアプリに合わせたビューで実行できますインタラクティブ性も加わりスニペットに命を吹き込めるようになりました例えばガーデニングスニペットを構築して土が乾いたらスプリンクラーをオンにするよう提案させたり料理の注文をまとめてからレストランに送ったりライブアクティビティなど他のシステム機能と統合してスコアの確認後すぐに試合をフォローするのもいいですねサンプルアプリを使ってインタラクティブスニペットの簡単なデモをお見せしますその後実装について説明します
TravelTrackingアプリには世界中の観光名所が収録されていますタップしてAppIntentを実行し最寄りの観光名所を探します
観光名所が見つかるとスニペットが表示されますタイトルの横にはハートボタンがあります自分はトロント出身でナイアガラの滝は自分の庭のようなものですですからハートボタンをタップしてお気に入りに追加します
スニペットはすぐに更新され新しいステータスが表示されます構築には新しいSnippet Intent プロトコルが採用されていますこれらインテントはパラメータに従ってビューやアプリのステータスをレンダリングしますアクションやリクエストの確認後はステータス情報をもとに結果を表示できますまずは resultスニペットの仕組みを紹介しますアプリ内のインテントはパラメータ値を収容したスニペットのインテントを結果の一部として返すことができますスニペットの更新が必要になるたびシステムはこれを使用します更新の際システムはデベロッパが指定した値をスニペットインテントのパラメータに入力しますアプリエンティティの値はクエリから取得します
システムはスニペットインテントの performメソッドを実行しますインテントはパラメータとアプリのステータスにアクセスしてビューをレンダリングし結果の一部として返しますビューはボタンやトグルをアプリの任意のApp Intentに関連付けできます
この例ではハートボタンが Update Favoritesインテントを実行しチケット検索ボタンが Find Ticketsインテントを実行しますスニペットのためだけにインテントを作成する必要はありません既存のものを変更せずに再利用できます
ハードボタンをタップするとシステムは対応するインテントを実行して完了するまで待ちますこれでお気に入りのステータスが最新の状態になります完了するとシステムは先に返してあるパラメータ化されたスニペットインテントを使用して別の更新をトリガします前と同じように指定した値をパラメータに入力しますアプリエンティティも再度クエリから取得します次にシステムは performメソッドを実行しここでスニペットインテントが更新されたビューをレンダリングしますこの例ではハートのアイコンが塗りつぶされましたビューで行った変更は SwiftUIの contentTransition APIに従って実装されますスニペットが消えるまでこのサイクルが続けられます
スニペットインテントの returnを実装してみましょうまず既存のインテントを使用して ShowsSnippetIntentを戻り値の型に追加します次に resultメソッドの新しいパラメータを使用してスニペットインテントを提供しますこれによりスニペットインテントを使用するたびに指定した観光名所をパラメータに入力するようシステムに伝えます
次はスニペットインテント自体を実装しましょう大前提として SnippetIntentプロトコルに準拠している必要があります次にビューを正しくレンダリングするため必要な変数を追加しますパラメータとしてマークする必要がありそうしておかないとシステムには入力されませんこれはApp Intentですから AppDependenciesにもアクセスできます performメソッドの戻り値の型に ShowsSnippetViewを追加します本文でメソッドを使用してビュー生成に必要なステータスを取得し resultメソッドで viewパラメータを使用してそれを返します
SwiftUIビューの場合と同様にスニペットインテントが作成されライフサイクル中に何度も実行されますですからアプリのステータスを変更しないようにしてくださいダークモードへの切り替えなどデバイスの変更に反応してシステムが何度か実行することもあり得ますまたビューのレンダリングは迅速に行うようにして反応が悪くなるのを避けましょう
パラメータ値の指定は一度しか行わないため App Entitiesにのみ使用してくださいこれらは毎回照会される基本型の値であり決して変更されません他のすべての値は performメソッドで取得する必要があります
スニペットが作成できたら SwiftUIビューがインテントをトリガする仕組みを紹介しましょう
ビューの本文で LandmarkViewは Buttonイニシャライザを使用して対応するApp Intentとの関連付けを行いますトグルにも同様のAPIがあります
これらAPIはインタラクティブなウィジェットとともにアニメーションをカスタマイズする修飾子 contentTransitionと並んで導入されました
詳細をについては 2023年の Lucaの講演をご覧くださいそれでは確認スニペットを使ってチケット検索機能を実装しましょう
Find Ticketsボタンをタップするとチケットを何枚検索したいか尋ねてきます友人が一緒のため 4枚に増やしてから検索を開始します最終的に結果スニペットで見つかった最安値が表示されますでは順を追って説明します結果スニペットからスタートするとボタンやトグルでスニペットを提供するインテントをトリガさせると元のスニペットが置き換わりますオリジナルが結果示していた場合にのみこれが機能する点に注意してくださいフォローアップインテントはいずれかのスニペットを提示できますが提示できますが今回はリクエストの確認で構成ビューを示します実行するには requestConfirmation メソッドを呼び出しますアクション名をカスタマイズしてスニペットインテントを指定すると確認作業に便利です
スニペットがキャンセルされるとこのメソッドはエラーをスローしますキャッチはせずに performメソッドを終了させます
これでビューとのインタラクションはすべて resultスニペットと同じ更新サイクルを経由します
この例ではスニペットインテントは常に更新後のチケット数を示しますどういう仕組みでしょう？検索リクエストをAppEntityとしてモデル化したのでこのパラメータに入力する際システムは常にクエリから最新の値を取得するようになりますこれでビューに渡すだけで自動的に最新の値を取得できます
スニペットが見えている限りシステムはアプリを終了させないのでステータスを存分にメモリに保持できますデータベースへの格納は不要です
すべてのインタラクションの後で最終的に検索アクションをタップすると元のApp Intentの実行が再開されます
新しいステータスが発生したためタスクの途中でスニペットの更新が必要になる場合があります
このシナリオの場合はシンプルに更新を要するスニペットインテントで静的なリロードメソッドを呼び出します
最高のインタラクティブスニペットをデザインする方法についてはこちらのセッションをご覧くださいスニペットはほんの始まりに過ぎませんシステム全体にアプリを統合する上で App Intentが他にもどういう具合に役立つかを紹介します第一は画像検索ですこの機能によりカメラのキャプチャやスクリーンショットから直接検索を実行できます iOS 26の新機能としてアプリの検索結果も表示されますこれは観光名所のスクリーンショットです検索を実行するには画像を強調表示しますするとシステムが検索パネルを表示します TravelTrackingアプリを選択すると検索結果が表示されます結果をタップすると対応する観光名所のページを表示するアプリが開きます
画像検索をサポートするには IntentValueQueryプロトコルに準拠するクエリを実装します SemanticContentDescriptor型を入力として受け取り App Entityの配列を返します Image Searchは固有の DisplayRepresentation型で AppEntityを表示します
結果をタップすると対応するAppEntityが OpenIntentに送られアプリで処理されますこのOpenIntentは不可欠でこれがないとアプリは表示されません
クエリを実装するには IntentValueQueryプロトコルに準拠している構造体からスタートします valuesメソッドへの入力として SemanticContentDescriptorが必要です選択した領域のピクセルがここに格納されます CGImageなどの馴染みのある型に変換するには Video Toolboxや CoreImageのAPIを使用できます
検索を実行した後条件に合致したエンティティの配列を返します次に OpenIntentプロトコルに準拠するインテントを実装して結果のタップに対応させますターゲットパラメータは結果と同じエンティティ型にする必要があります OpenIntentは Image Searchのサポート以外に Spotlightなど他の場所で呼び出されることもありアプリ内のエンティティに移動する簡単な方法をユーザーに提供します
探しているものがすぐに見つかれば最高の体験が得られるでしょうシステムUIが完璧な候補を表示する可能性を上げられるよう数ページ分の結果を返しますサーバを使用してより大きなデータセットをクエリできますただし検索時間は短めにしましょう反応が鈍いという印象を与えかねません最後に探しているものが見つからなかった場合でも検索エクスペリエンスをアプリ内で続行できるようにします TravelTrackingに追加しましょう
必要な結果がリストにない場合ボタンをタップするとアプリが開き検索ビューが表示されますこれを実装するには新しいAppIntentマクロを使用して semanticContentSearch スキーマを指定しますこれは AssistantIntentマクロに替わる新しいAPIで VisualIntelligenceなどのアシスタント以外の機能までスキーマを拡張したことでこれが採用されましたスキーマが要求するセマンティックコンテンツプロパティを追加しますマクロはこれを自動的にインテントパラメータとしてマークします
performメソッドで検索メタデータを処理した後検索ビューを表示します追加機能として TravelTrackingに条件に合致した観光名所のコレクションを表示させましょうですがクエリ1つで LandmarkEntityと CollectionEntityの混在したデータをどうすれば返せるでしょうか？ UnionValuesを使いますまずクエリが返すエンティティの型を表すcaseを使用して UnionValueを宣言します次に戻り値の型をそれらの配列に変更しますこれで両方の混在するデータを返せるようになりましたもちろんエンティティの型それぞれに OpenIntentの実装も必要になります UnionValuesの詳細については KennyがApp Intentについて紹介した 2024年のセッションをご覧ください
アプリのコンテンツをアプリ外からでも検索できるのは素晴らしい機能ですが Apple intelligenceを使えばアプリがアクティブの状態でできることはもっとあります画面上のエンティティの話をしましょう NSUserActivitiesを使用するとエンティティを画面上のコンテンツに関連付けできますこれでアプリに表示されている物事について ChatGPTに質問できるようになります
TravelTrackingアプリではナイアガラの滝を見ながらこの場所が海の近くなのか Siriに尋ねることができます Siriは私が画面上のビューを参照していることを察知してスクリーンショットをChatGPTに送信するよう提案します LandmarkEntityは PDFに対応しているのでフルコンテンツオプションを代わりに選択して簡単にプレビューしてから送信できます
応答が表示され五大湖は相当に大きいけれども「海ではない」ことが分かりますエンティティとビューを関連付けるにはまず userActivity修飾子を LandmarkDetailViewに追加します次に updateクロージャでエンティティ識別子をアクティビティに関連付けます次に LandmarkEntityのデータ型を PDFなど ChatGPTが理解可能なものに変換できるようサポートします
そのためには Transferableプロトコルに適合させてから PDFデータ表現を提供します他にもプレーンテキストやリッチテキストなどに対応しています画面上のエンティティに関する詳細は App Intentのドキュメントで紹介しています
アプリのコンテンツをシステムで検索可能にする方法に関して Spotlightについて少しお話しします今はMac上で Spotlightから直接アクションを実行できるようになりました最高の体験を提供するため App Intentにもできることがあります
その1. アプリエンティティを IndexedEntityに適合させて Spotlightに提供することこれにより Spotlight検索でパラメータに合わせたフィルター処理を実行できるようになりますエンティティのプロパティを Spotlightキーに関連付けるため property属性で新しいindexingKeyパラメータが使用可能になりましたこの例では大陸に customIndexingKeyを使いましたこれでテキストフィールドに Asiaと入力するだけでアジアの観光名所が検索可能になります APIを採用するメリットとしてショートカットアプリがエンティティの検索アクションを自動生成するようになります
その2. 画面に表示されたエンティティ付きコンテンツに注釈を付けてビュー表示中は提案においてこれらエンティティを優先させますその3. PredictableIntentを実装しインテントやユーザーの過去の行動から得たパラメータに基づいてシステムが学習や提案を実行できるようにします値に応じて説明をカスタマイズして提供することも可能です
この機能について詳しく知りたい場合はこのセッションのショートカットと Spotlightの部分が参考になります機能をひと通りアプリに実装できたのでアプリのユーザー体験向上につながる新しい方法をいくつかご紹介しますまずはUndo機能から途中で気が変わってもよいと分かればユーザーが色々試す可能性は高くなりますそれこそがアプリで実行したアクションを元に戻せることが重要である理由です新しいUndoableIntentプロトコルでは馴染みのジェスチャーを使って App IntentでのUndoに対応させることができます
こちらはTravelTrackingアプリに登録したコレクションの一部です「Siriにタイプ入力」を使ってカスタムショートカットの1つを実行させ「Sweet deserts」コレクションを削除します削除を承認するとアプリから削除されますもしここで気が変わったら 3本の指で左にスワイプして取り消し操作をトリガすればコレクションを復元できます
DeleteCollectionIntentは最初に UndoableIntentプロトコルに準拠しますこのプロトコルは取り消しアクションと合わせて登録可能なオプションのundoManagerプロパティを提供します setActionNameなど他の操作も利用できますこから関連性が最も高い取り消しマネージャをインテントに提供します拡張機能内で動くインテントもその対象に含まれますこれによりアプリUI全体の取り消しアクションと App Intentの同期を維持し正しい順序で取り消しを実行できます削除に代わるオプションを提供してインテントにさらに磨きをかけましょう
新しい多肢選択式のAPIを使用すれば複数のオプションをより選びやすくなりますコレクションを削除するインテントをもう一度実行します今回はただ単に削除の確認を求めるだけではなくアーカイブするか尋ねるオプションをプラスします
このコレクションには思い出がありますね削除はせずアーカイブします performメソッドで requestChoiceを呼び出して多肢選択スニペットを提示し betweenパラメータを使用してオプションの配列を指定しますオプション名はカスタマイズできますまたスタイルを指定してシステムにレンダリング方法を指示できます
ダイアログとカスタムSwiftUIビューでもスニペットをカスタマイズできます
選択したオプションは requestChoiceメソッドから返されますただしキャンセルオプションだけはエラーをスローして performメソッドを終了させますこのエラーは検出しないようにしてくださいリクエストをキャンセルしたらインテントをただちに停止させる必要があります
フォローアップとして switchステートメントで選択したオプションに分岐させます作成した元のオプションは期待値として使用できますもう1つ手を入れる余地を紹介しますサポートしているモードではより詳細にアプリのフォアグラウンド化を制御できますこれによりデバイスとのやり取りに応じてアプリの動作に変化をつけられます例えば運転中のインテントからの情報提供を音声だけに制限できます一方デバイスを見られる状況なら直接アプリを表示させたいところですその方がより多くの情報を提供できるからですこの機能を使えば 1つのApp Intentを実装して両方の状況に対応できますその例を紹介します
ナイアガラの滝の混雑状況を取得できるインテントがあります
オプションをオフにしますこれはヘッドフォン装着中に Siriが使えないなどフォアグラウンド化が不可能なシナリオに似ています実行すると Siriにも読み上げ可能なダイアログだけ表示されます
一方ダイアログをオフにしを有効にして実行すると観光名所ページを直接開いて混雑率や現在の天気を確認することができます
この機能をインテントに追加します
まず静的変数を使用して対応モードを追加しますバックグラウンドのみに設定するとインテントはアプリをフォアグラウンド化させませんただ可能ならばインテントにアプリを表示させたいところですそこでインテントの実行前にアプリの起動をシステムに要求するフォアグラウンドモードを追加します
次に新しいcurrentModeプロパティでフォアグラウンド化されているかを確認できるようにします状態に応じて操作内容が替わりますでもちょっと待ってくださいなぜ観光名所に誰もいないのでしょう？なるほど閉まっていますねこのシナリオではアプリを開かないようインテントを変更しましょう performメソッドでは観光名所が営業中であるかを確認して閉まっていればすぐ終了しますこの場合インテント実行前はアプリのフォアグラウンド化をさせないようにしますそこでフォアグラウンドモードを動的にするよう変更しますバックグラウンドモードと 3種類のフォアグラウンドモードが利用できます Immediateモードはインテントの実行前にアプリをフォアグラウンド化するようシステムに指示します Dynamicモードはアプリ起動についてインテントが判断できるようにします Deferredモードは最終的にインテントにアプリをフォアグラウンド化させますがタイミングは遅らせます GetCrowdStatusではアプリが起動しない場合があるためダイナミックを選びます
これら2つのモードではインテントは continueInForegroundメソッドでアプリを表示させるタイミングを正確に制御します
観光名所が営業中と確認できたら systemContextで新しいプロパティを使用して表示できるかどうかを確認します continueInForeground メソッドを呼び出してアプリをフォアグラウンド化します alwaysConfirmを「false」に設定すると数秒前にアクティビティがあった場合システムはプロンプトを表示しませんアプリの起動に成功したらその時点でようやく混雑状況ビューを表示できるようになりますただしシステムまたはユーザーが起動リクエストを拒否した場合このメソッドはエラーをスローしますこのエラーを検出して適宜対処することができます最後に App Intentsを使った開発を手助けする方法をいくつか紹介します
App IntentでUIナビゲーションを実行する場合はビューを表示させるアプリステータスへのアクセスが必要です AppDependenciesやシングルトンなどグローバルに共有されたオブジェクトでのみ実行できますただし新しいビューコントロールAPIなら UIコードをApp Intentsから削除してビュー自体に処理を任せることができますこれを利用して OpenLandmark Intentをリファクタリングしましょうまず一番に必要になるのがインテントを TargetContentProvidingIntent プロトコルに準拠させる作業です SwiftUIビューでは NavigationStackをプログラムで変更する際に使用するパスプロパティがあります状態としてマークされているためアクセスはビュー本体からのみ実行できますこれこそまさに onAppIntentExecutionビュー修飾子の出番です指定した型のインテントとそのインテントを引数としたアクションクロージャを返します。内部ではインテントのパラメータを参照して UIを適宜変更できますこのコードを使えば UIコードをインテントから取り除けるほか performメソッドや不要になった依存関係を完全に排除できます素晴らしいでしょう？
システムはアプリをフォアグラウンド化する直前にアクションクロージャを実行しますそのためパラメータ値の読み取り対象はインテントに絞られます値のリクエストなど他の操作には対応しません同じ修飾子が複数のビューにある場合すべてのビューが実行されるため各ビューで応答が可能になりますアプリが複数のシーンやウインドウをサポートしている場合は必要に応じて特定のインテントをどれに実行させるかコントロールします例えば TravelTrackingアプリのコレクション編集中はシーンの観光名所は表示させないほうがよいでしょう集中しづらいからです handlesExternalEvents APIでコントロールできるのはありがたいですねインテント提供ターゲットコンテンツにはデフォルトで contentidentifierに設定されるプロパティがあります通常はインテントに指定された名前ですこの値はより具体的なものになるよういつでもカスタマイズできます
HandlesExternalEvents 修飾子と共にシーンに使用してアクティブ化条件を設定しシーンを使用してApp Intentを実行するようシステムに指示します既存のものがない場合は作成されます配列内の識別子は処理したいIntentのコンテンツ識別子のプロパティと一致させますただしアクティベーション条件が動的である場合は代わりに同じ修飾子をビューに使用できますここではコレクション編集時以外は OpenLandmarkIntentだけをシーンに処理させています SwiftUIシーンとアクティベーション条件の詳細についてはこれら2つのセッションで確認できます UIKitではインテントを UISceneAppIntentプロトコルに準拠させてこれらメンバーによる UISceneへのアクセスを実現できますまた AppIntentSceneDelegateへの適合後シーンデリゲートにインテント実行に応答させることもできます最後にアクティベーション条件を指定して App Intentを処理させたいシーンを決めることもできます次の改善ポイントは新しいComputedPropertyマクロです AppEntitiesへの値の保存が回避できるようになりました SettingsEntityはUserDefaultsから defaultPlaceをコピーします重複する値をこのように構造体に格納するのは避けたいものです代わりに本当のソースから直接導出させるのが適切でしょう新しいComputedPropertyマクロではゲッタからUserDefaultsへの直接アクセスによりこれを実現できます
また AppEntityインスタンスの生成コストを抑えるため DeferredPropertyマクロを新たに追加しました LandmarkEntityに含まれる crowdStatusプロパティはネットワークサーバから値を取得する分比較的コストがかかりますシステムが明示的に要求した場合だけ取得処理を実行させたいところです
このプロパティを DeferredPropertyとしてマークすれば非同期ゲッタを提供できます内部ではネットワークを呼び出すメソッドを呼び出しできますこの非同期ゲッタはショートカットなどのシステム機能が要求した場合のみ呼び出され LandmarkEntityの作成時や受け渡しの際には呼び出されません
3種類のプロパティ型の主な違いはこうですシステムオーバーヘッドが低いのでComputed Property over Deferredを選択しますフォールバックは Deferredプロパティの計算コストが高すぎる場合のみ実行します最後になりましたが App Intentは Swiftパッケージ対応になりました
従来はフレームワークとダイナミックライブラリを使用して AppIntentコードのパッケージ化を実行していました今後は Swiftパッケージと静的ライブラリにコードを入れることができます AppIntensePackageプロトコルの詳しい使い方については「Get to know App Intents」セッションをご覧くださいここまで機能の説明をお楽しみいただけたでしょうか次のステップではインテントのためにインタラクティブスニペットができることを紹介します画面上のコンテンツにエンティティを関連付けてシステムが自動的にエンティティを提案できるようにします複数選択式APIを使用してユーザーが選べるオプションを増やします複数のモードに対応してどういう形で実行しても Intentが最適な体験を提供できるようにします最後にコードをさらに詳しく知るにはデベロッパWebサイトのサンプルアプリをご覧ください最新情報を皆さんと共有できてとても嬉しく思います皆さんの創造的なアイデアをいまから心待ちにしています
お話はここまでですご視聴ありがとうございました

import AppIntents
import SwiftUI

struct ClosestLandmarkIntent: AppIntent {
    static let title: LocalizedStringResource = "Find Closest Landmark"

    @Dependency var modelData: ModelData

    func perform() async throws -> some ReturnsValue<LandmarkEntity> & ShowsSnippetIntent & ProvidesDialog {
        let landmark = await self.findClosestLandmark()

        return .result(
            value: landmark,
            dialog: IntentDialog(
                full: "The closest landmark is \(landmark.name).",
                supporting: "\(landmark.name) is located in \(landmark.continent)."
            ),
            snippetIntent: LandmarkSnippetIntent(landmark: landmark)
        )
    }
}

4:31 - Building a SnippetIntent

struct LandmarkSnippetIntent: SnippetIntent {
    static let title: LocalizedStringResource = "Landmark Snippet"

    @Parameter var landmark: LandmarkEntity
    @Dependency var modelData: ModelData

    func perform() async throws -> some IntentResult & ShowsSnippetView {
        let isFavorite = await modelData.isFavorite(landmark)

        return .result(
            view: LandmarkView(landmark: landmark, isFavorite: isFavorite)
        )
    }
}

5:45 - Associate intents with buttons

struct LandmarkView: View {
    let landmark: LandmarkEntity
    let isFavorite: Bool

    var body: some View {
        // ...
        Button(intent: UpdateFavoritesIntent(landmark: landmark, isFavorite: !isFavorite)) { /* ... */ }

        Button(intent: FindTicketsIntent(landmark: landmark)) { /* ... */ }
        // ...
    }
}

6:53 - Request confirmation snippet

struct FindTicketsIntent: AppIntent {

    func perform() async throws -> some IntentResult & ShowsSnippetIntent {
        let searchRequest = await searchEngine.createRequest(landmarkEntity: landmark)

        // Present a snippet that allows people to change
        // the number of tickets.
        try await requestConfirmation(
            actionName: .search,
            snippetIntent: TicketRequestSnippetIntent(searchRequest: searchRequest)
        )

        // Resume searching...
    }
}

7:24 - Using Entities as parameters

struct TicketRequestSnippetIntent: SnippetIntent {
    static let title: LocalizedStringResource = "Ticket Request Snippet"

    @Parameter var searchRequest: SearchRequestEntity

    func perform() async throws -> some IntentResult & ShowsSnippetView {
        let view = TicketRequestView(searchRequest: searchRequest)

        return .result(view: view)
    }
}

8:01 - Updating a snippet

func performRequest(request: SearchRequestEntity) async throws {
    // Set to pending status...
   
    TicketResultSnippetIntent.reload()

    // Kick off search...

    TicketResultSnippetIntent.reload()
}

9:24 - Responding to Image Search

struct LandmarkIntentValueQuery: IntentValueQuery {

    @Dependency var modelData: ModelData

    func values(for input: SemanticContentDescriptor) async throws -> [LandmarkEntity] {
        guard let pixelBuffer: CVReadOnlyPixelBuffer = input.pixelBuffer else {
            return []
        }

        let landmarks = try await modelData.searchLandmarks(matching: pixelBuffer)

        return landmarks
    }
}

9:51 - Support opening an entity

struct OpenLandmarkIntent: OpenIntent {
    static var title: LocalizedStringResource = "Open Landmark"

    @Parameter(title: "Landmark")
    var target: LandmarkEntity

    func perform() async throws -> some IntentResult {
        /// ...
    }
}

10:53 - Show search results in app

@AppIntent(schema: .visualIntelligence.semanticContentSearch)
struct ShowSearchResultsIntent {
    var semanticContent: SemanticContentDescriptor

    @Dependency var navigator: Navigator

    func perform() async throws -> some IntentResult {
        await navigator.showImageSearch(semanticContent.pixelBuffer)

        return .result()
    }

    // ...
}

11:40 - Returning multiple entity types

@UnionValue
enum VisualSearchResult {
    case landmark(LandmarkEntity)
    case collection(CollectionEntity)
}a

struct LandmarkIntentValueQuery: IntentValueQuery {
    func values(for input: SemanticContentDescriptor) async throws -> [VisualSearchResult] {
        // ...
    }
}

struct OpenLandmarkIntent: OpenIntent { /* ... */ }
struct OpenCollectionIntent: OpenIntent { /* ... */ }

13:00 - Associating a view with an AppEntity

struct LandmarkDetailView: View {

    let landmark: LandmarkEntity

    var body: some View {
        Group{ /* ... */ }
        .userActivity("com.landmarks.ViewingLandmark") { activity in
            activity.title = "Viewing \(landmark.name)"
            activity.appEntityIdentifier = EntityIdentifier(for: landmark)
        }
    }
}

13:21 - Converting AppEntity to PDF

import CoreTransferable
import PDFKit

extension LandmarkEntity: Transferable {
    static var transferRepresentation: some TransferRepresentation {
        DataRepresentation(exportedContentType: .pdf) {landmark in
            // Create PDF data...
            return data
        }
    }
}

14:05 - Associating properties with Spotlight keys

struct LandmarkEntity: IndexedEntity {

    // ...

    @Property(indexingKey: \.displayName)
    var name: String

    @Property(customIndexingKey: /* ... */)
    var continent: String

    // ...
}

15:49 - Making intents undoable

struct DeleteCollectionIntent: UndoableIntent {
    // ...

    func perform() async throws -> some IntentResult {

        // Confirm deletion...

        await undoManager?.registerUndo(withTarget: modelData) {modelData in
            // Restore collection...
        }
        await undoManager?.setActionName("Delete \(collection.name)")

       // Delete collection...
    }
}

16:52 - Multiple choice

struct DeleteCollectionIntent: UndoableIntent {
    func perform() async throws -> some IntentResult & ReturnsValue<CollectionEntity?> {
        let archive = Option(title: "Archive", style: .default)
        let delete = Option(title: "Delete", style: .destructive)

        let resultChoice = try await requestChoice(
            between: [.cancel, archive, delete],
            dialog: "Do you want to archive or delete \(collection.name)?",
            view: collectionSnippetView(collection)
        )

        switch resultChoice {
        case archive: // Archive collection...
        case delete: // Delete collection...
        default: // Do nothing...
        }
    }
    // ...
}

18:47 - Supported modes

struct GetCrowdStatusIntent: AppIntent {

    static let supportedModes: IntentModes = [.background, .foreground]

    func perform() async throws -> some ReturnsValue<Int> & ProvidesDialog {
        if systemContext.currentMode == .foreground {
            await navigator.navigateToCrowdStatus(landmark)
        }

        // Retrieve status and return dialog...
    }
}

19:30 - Supported modes

struct GetCrowdStatusIntent: AppIntent {
    static let supportedModes: IntentModes = [.background, .foreground(.dynamic)]

    func perform() async throws -> some ReturnsValue<Int> & ProvidesDialog {
        guard await modelData.isOpen(landmark) else { /* Exit early... */ }

        if systemContext.currentMode.canContinueInForeground {
            do {
                try await continueInForeground(alwaysConfirm: false)
                await navigator.navigateToCrowdStatus(landmark)
            } catch {
                // Open app denied.
            }
        }

        // Retrieve status and return dialog...
    }
}

21:30 - View Control

extension OpenLandmarkIntent: TargetContentProvidingIntent {}

struct LandmarksNavigationStack: View {

    @State var path: [Landmark] = []

    var body: some View {
        NavigationStack(path: $path) { /* ... */ }
        .onAppIntentExecution(OpenLandmarkIntent.self) { intent in
            self.path.append(intent.landmark)
        }
    }
}

23:13 - Scene activation condition

@main
struct AppIntentsTravelTrackerApp: App {
    var body: some Scene {
        WindowGroup { /* ... */ }

        WindowGroup { /* ... */ }
        .handlesExternalEvents(matching: [
            OpenLandmarkIntent.persistentIdentifier
        ])
    }
}

23:33 - View activation condition

struct LandmarksNavigationStack: View {
    var body: some View {
        NavigationStack(path: $path) { /* ... */ }
        .handlesExternalEvents(
            preferring: [],
            allowing: !isEditing ? [OpenLandmarkIntent.persistentIdentifier] : []
        )
    }
}

24:23 - Computed property

struct SettingsEntity: UniqueAppEntity {

    @ComputedProperty
    var defaultPlace: PlaceDescriptor {
        UserDefaults.standard.defaultPlace
    }

    init() {
    }
}

24:48 - Deferred property

struct LandmarkEntity: IndexedEntity {
    // ...

    @DeferredProperty
    var crowdStatus: Int {
        get async throws {
            await modelData.getCrowdStatus(self)
        }
    }

    // ...
}

25:50 - AppIntentsPackage

// Framework or dynamic library
public struct LandmarksKitPackage: AppIntentsPackage { }

// App target
struct LandmarksPackage: AppIntentsPackage {
    static var includedPackages: [any AppIntentsPackage.Type] {
        [LandmarksKitPackage.self]
    }
}

関連する章

リソース

関連ビデオ

WWDC25

WWDC24