👌

AppIntentsにおける主要プロトコル

2024/07/11に公開

AppIntent

https://developer.apple.com/documentation/appintents/appintent
インテントそのものを定義するプロトコル。これがインテントの本体。@Parameterでインテントに使う変数を宣言することができ、Perform()で実行内容を作る。これ単体でもショートカットアプリ内でアクションとして用いれるが、デフォルトでショートカットとして使えるようにするにはAppShortcutsPorviderで指定する必要がある。

AppShortcutsProvider

https://developer.apple.com/documentation/appintents/appshortcutsprovider
ショートカットを定義するプロトコル。ここでショートカットの名前、フレーズ、そして実行するアクション(AppIntent)などを指定する。アイコン(SF Symbols)や背景色なども指定する。ここで指定してショートカットはショートカットアプリやSpotlight検索で表示される。

AppEntity

https://developer.apple.com/documentation/appintents/appentity
AppIntentでデータのモデルを扱いたいときに使うプロトコル。

FileEntity

https://developer.apple.com/documentation/appintents/fileentity
iOS18から新しく加わった。

AppEnum

https://developer.apple.com/documentation/appintents/appenum
AppIntentでカスタムな型が必要な時に使う。

TypeDisplayRepresentable

AppEnumが表示される際に使われる文字列。

static var typeDisplayRepresentation = TypeDisplayRepresentation(name: "Name")

caseDisplayRepresentations

AppEnumのcaseが表示される際に使われる文字列。ショートカットアプリで変数を選択される時などに使用される。

Discussion