ショートカットと提案
ショートカットをサポートすると、人々はさまざまな方法で、あなたのアプリが提供するカスタムの意図やシステムの意図を発見して操作できるようになります。 例えば：
ショートカットアプリは、macOS 12 以降および watchOS 7 以降でも利用できます。開発者向けガイダンスについては、SiriKit > ショートカット を参照してください。
アプリアクションを広く利用できるようにする
あなたのアプリがサポートするアクションに関する情報を Donate (提供する、寄付する) ことで、システムは以下のようなさまざまな方法でアクションを人々に提供することができます。
寄付は、ショートカットアプリのギャラリーの自動化の提案にも役立ち、これにより、人々はあなたのアプリをハンドフリーで操作するための自動化を簡単に設定できます。
また、人々がまだ実行していないアクションのショートカットについてシステムに通知したり、Siri 文字盤でショートカットを使用できるようにもできます (ガイダンスについては、Siri に追加したいショートカットを人々に提案する および Siri の文字盤にショートカットを表示する を参照してください)。 開発者向けガイダンスについては、ショートカットの寄贈 (Donating Shortcuts) を参照してください。
人々がアクションを実行するたびに寄贈を行います。 人々が関連したアクションを実行するたびにショートカットを寄贈すると、ショートカットを提供するのに最適な時間と場所をシステムがより正確に予測するのに役立ちます。
人々が実際に行う行動のみを寄贈してください。 たとえば、コーヒーを注文するアプリは、人々がコーヒーを注文するたびに [コーヒーを注文する] ショートカットを寄贈しますが、メニューを閲覧するなど、人々が他のことをするときにこの寄贈は行いません。同様に、メディアアプリは曲に関する情報 (曲のタイトルやアルバムなど) を、人々が実際に聴いている場合にのみ提供します。(開発者向けガイダンスについては、Siri のメディア操作とアプリの選択を改善 を参照してください。)
対応するデータが必要なアクションの寄贈を削除します。 寄贈されたアクションに必要な情報が存在しなくなった場合、あなたのアプリは寄贈を削除して、ショートカットがもはや提案されないようにする必要があります。たとえば、人々がメッセージアプリで連絡先を削除した場合、アプリはその連絡先にメッセージを送るための寄贈を削除する必要があります。人々が自分でショートカットを作成した場合、その人々だけがそれを削除できます。開発者向けのガイダンスについては、寄贈されたショートカットの削除 を参照してください。
あなたのアプリで予約を処理する場合は、予約をシステムに寄贈することを検討してください。 これらの項目 (チケット付きイベント、旅行日程、レストラン、フライト、映画の予約など) は、カレンダーやマップに提案として自動的に表示されます。予約を寄贈すると、ロックスクリーンに表示され、あなたのアプリでチェックインするよう提案されたり、現在の交通状況を使用して人々がいつ出発すべきかを推奨するリマインダーとして表示されます。開発者向けガイダンスについては、予約の寄贈 を参照してください。
Siri に追加したいショートカットを人々に提案する
あなたのアプリが、人々がまだ実行していないが役立つと思われるアクションをサポートしている場合は、システムへの 推奨 ショートカットを提供して、人々がそれを見つけられるようにできます。たとえば、人々がコーヒー注文アプリを使用して毎日のコーヒーを注文するが、休日にはスペシャルを注文しない場合、アプリは、休日のコーヒーを注文する ショートカットを使用してこれを行う方法を提供したいと考えるかもしれません。
提案されたショートカットは、ショートカットアプリのギャラリーとショートカットエディターの両方に表示されます。また、人々があなたのアプリ内で提案されたショートカットを有効にするために使用できる [Siri に追加] ボタンをあなたのアプリに表示することもできます。開発者向けのガイダンスについては、ユーザーへのショートカットの提案 を参照してください。
Siri の文字盤にショートカットを表示する
Apple Watch では、人々はいくつかの方法でショートカットを実行できます。たとえば、人々は Siri に尋ねたり、文字盤でショートカット 複雑化 をタップしたり、watchOS 7 以降で利用可能なショートカットアプリを使用したりできます。Siri の文字盤でショートカットを利用できるようにもできます。
Siri の文字盤にショートカットを表示するには、ショートカットが関連する時刻や、ショートカットを Siri 文字盤に表示する方法などの情報を含めて、関連する ショートカットを定義します。あなたが提供する情報により、Siri の文字盤は、適切なコンテキストにいる人にあなたのショートカットをインテリジェントに表示します。
開発者向けガイダンスについては、アプリに関連するショートカットの定義 を参照してください。
ショートカットのタイトルとサブタイトルを作成
ショートカットのタイトルとサブタイトルは、システムがそれらを提案するとき、または人々がショートカットを Siri に追加または編集するときに表示されます。iPhone と Apple Watch の Siri Suggestions (Siri の提案) では、ショートカットはイメージを表示することもできます。
簡潔だが説明的であること。 効果的なタイトルは、ショートカットが実行されたときに何が起こるかを伝えます。サブタイトルは、タイトルを補足する追加の詳細を提供しますが、重複はしません。
タイトルは動詞で始め、文章スタイルの大文字化を使用し、句読点を付けません。 ショートカットのタイトルは、簡単な指示と考えてください。
| タイトルの例 | |
 | お気に入りのコーヒーを注文 |
 | ラテの大 |
| 今日の天気予報を見せて |
| 天気予報 |
重要な情報を先頭にします。 デバイスのスクリーンサイズによっては、特定のコンテキストで長いタイトルとサブタイトルが切り捨てられる場合があります。
アプリ名を除外します。 システムは、ショートカットに関連したアプリを既に識別しています。
タイトルとサブタイトルをローカライズします。 複数の言語でコンテンツを提供することで、人々がどこにいても同じように優れた体験を提供できます。
より魅力的な提案のためにカスタムイメージを提供することを検討してください。 たとえば、[お気に入りのコーヒーを注文] のショートカットは、顧客のお気に入りのコーヒー 1 杯を表示できます。以下を意味するイメージを作成しましょう。
人々がショートカットを追加できるようにする
人々は、あなたのアプリ内またはショートカットアプリ内からショートカットを追加できます。
[Siri に追加] ボタンを提供して、人々が一般的なアクションのショートカットを追加できるようにします。 人々がボタンをタップすると表示される [Siri に追加] シートで、カスタムの音声コマンドを入力または録音 (またはアプリの提案されたフレーズを受け入れる) して、ショートカットを追加できます。ショートカットが追加されると、ボタンのテキストは自動的に [Siri に追加済み] に変わり、呼び出しフレーズが表示されます。これらの変更により、人々はショートカットの追加に成功したことがわかり、重要なことに、Siri にショートカットを実行するように依頼するときに何を言うべきかを思い出させることができます。[Siri に追加] ボタンの使用に関するガイダンスについては、[Siri に追加] ボタンのスタイル を参照してください。
ショートカットを追加するカスタムボタンを作成する場合は、システム提供のボタンを反映した体験を提供します。 カスタムボタンに [Siri に追加] というフレーズを表示します。代替フレーズ ([音声コマンドの追加]、[音声ショートカットの作成]、[音声プロンプトの作成[ など) を表示したり、カスタムボタンに Siri アイコンを表示したりしないでください。また、Siri アイコンをボタンとして使用したり、インターフェイスの他の場所に表示したりしないでください。(1 つのスクリーンにいくつかのショートカットを表示する方法については、1 つの場所に複数のショートカットを表示する を参照してください)。
人々があなたのカスタムボタンを使用してショートカットを追加した後、彼らが覚えやすいようにトリガーフレーズを表示することが重要です。カスタムの [Siri に追加] ボタンを作成した場合は、システム提供の体験をミラーリングし、ボタンを更新して [Siri に追加] の後にフレーズを表示することができます。
人々が追加したショートカットを編集および削除できるようにします。 ショートカットを追加した後にあなたのアプリに表示されるトリガーフレーズをタップすると、ショートカット編集ビューが再び表示され、フレーズを更新したり、ショートカットを削除したりできるようになります。
あなたのアプリに表示されるショートカットを更新します。 人々は、ショートカットアプリであなたのアプリのショートカットを追加、削除、および更新できます。ただし、これらの変更が発生しても、ショートカットアプリはあなたのアプリに通知しません。最新のショートカットの変更に合わせてそのインターフェイスを最新の状態に保つのは、あなたのアプリの責任です。
ショートカット用にデフォルトフレーズを提供
アプリは、設定中にショートカット用のデフォルトのフレーズを提供します。あなたのショートカットを Siri に追加すると、人々はこれらのフレーズをパーソナライズできます。
フレーズは短く覚えやすいものにしてください。 人々はあなたのフレーズを性格に話さなければならないことに注意してください。そのため、長いフレーズや紛らわしいフレーズは間違いや欲求不満を引き起こします。2 語または 3 語のフレーズが最も効果的です。人々はより多くの単語を覚えるのが難しく、長すぎるフレーズは切り捨てられます。
提案するフレーズが正確で具体的であることを確認してください。 コーヒーを再注文する や いつものコーヒーを注文する などのフレーズは、ショートカットの機能を明確に説明しているため、後でそのフレーズを思い出しやすくなります。また、あなたの提案したフレーズが各ショートカットの範囲に固有のものであることを確認してください。たとえば、野球を見る のほうが スポーツを見る よりも明確で記憶に残ります。また、ショートカットの呼び出しフレーズを変更して別の結果を得ることができるとほのめかさないことも重要です。たとえば、大きなクラムチャウダーを注文する などのフレーズは、"大きな" を "小さな" に、"クラムチャウダー" を "ロブスター ビスク" に置き換えれば、ショートカットで欲しいものが得られるという意味で人々が解釈されるでしょう。
重要な Siri のコマンドを強要しないでください。 たとえば、あなたのアプリで 911 に電話する などのフレーズを提案したり、Hey Siri というテキストを含めたりしないでください。
ショートカットをカスタマイズ可能にする
あなたのアプリが意図を実行するために必要な各詳細のパラメーターを定義すると、人々はショートカットアプリまたはあなたの [Siri に追加] シートでこれらの詳細を編集して、ショートカットをカスタマイズできます。
人々が編集できる詳細と、その編集がアクションにどのように影響するかを示すために、パラメーターの概要 を提供して下さい。パラメーターの概要では、動詞で始まる文でパラメーターを使用してアクションを簡潔に説明します。たとえば、カスタマイズ可能な [コーヒーを注文する] ショートカットは、[コーヒーの注文数量] のようなパラメーターの概要を表示できます。ここで、数量 と コーヒー は人々が編集できるパラメーターです。以下は、人々が 数量 と コーヒー パラメーターの値を指定した後、[コーヒーを注文] ショートカットがどのように見えるかの例です。
あなたのサポートするカスタムの意図ごとにパラメーターの概要を提供して下さい。 少なくとも、パラメーターの概要には、あなたの意図が必要とするすべてのパラメーターと、他のアプリやアクションから値を受け取るすべてのパラメーターを含める必要があります。概要には、オプションのパラメーターや、人々が編集する可能性が低いパラメーターを含める必要はありません。要約からこれらのようなパラメーターを省略した場合でも、人々は [Show More] セクションでそれらにアクセスできます。
あなたの意図のタイトルに明確に関連する短いパラメーターの概要を作成します。 意図のタイトルとパラメーターの概要が似ていると、人々はどこから見てもアクションを認識しやすくなります。概要とタイトルで同じ単語を使用することを目指します。特に、両方のフレーズを同じ動詞で始めると役立ちます。たとえば、あなたの意図のタイトルが "百科事典を検索" の場合、適切なパラメーターの概要は "検索語 で百科事典を検索" のようになります。
文章のように読めるパラメーターの概要を目指します。 文章スタイルの大文字化を使用しますが、末尾の句読点は含めません。可能であれば、句読点を完全に避けてください。概要内の句読点 (特にコロン、セミコロン、および括弧) は、概要を読みにくく理解しにくくします。
必要に応じて、複数のパラメーターの概要を提供します。 あなたのアクションに、他のパラメーターとの親子関係を持つパラメーターが含まれている場合、親パラメーターの現在の値に基づいて、概要の複数のバリアントを提供できます。たとえば、あなたの コーヒーの注文 のショートカットで、注文した商品を受け取りに行きたいか配達してもらいたいかを人々が指定する場合、パラメーターの概要は現在の選択を反映する必要があります。このシナリオでは、人々が店舗の場所を選択するのに役立つ 1 つのパラメーターの概要と、配送先住所を選択するのに役立つ別の概要を作成する必要があります。作成する概要のすべてのバリアントで、一貫した文法構造とパラメーターの順序を使用してください。
配達か受け取りか
配送先住所
人々が複数の手順のショートカットで使用できる情報の出力パラメーターを提供します。 たとえば、コーヒーを注文する アクションは、推定配達時間と注文のコストを含む出力を提供します。この情報を使用して、人々は配達時間について友人にメッセージを送信し、お気に入りの予算管理アプリに取引を記録する、複数ステップのショートカットを作成できます。
入力パラメーターの定義を検討してください。 アクションの入力パラメーターを定義すると、そのアクションは、複数ステップのショートカットで前のアクションから出力を自動的に受け取ることができます。たとえば、あなたのアクションが イメージ パラメータで受け取ったイメージにフィルタを適用する場合、イメージ を入力パラメータとして指定して、他のアクションからのイメージを自動的に受け入れるようにできます。あなたの意図の定義ファイルで入力パラメーターを構成して下さい (Siri ショートカットとショートカットアプリを使用したユーザー操作の追加 の "ユーザー構成可能なショートカットの定義" に示されています)。
人々が同じアクションのさまざまなバリエーションを区別できるようにします。 たとえば、メッセージ送信 アクションを提供するアプリでは、連絡先の写真を使用して、人々が送信するさまざまなメッセージを視覚的に区別できるようにします。これを行うには、人々にとって最も識別しやすいパラメーターを選択し、それをキーパラメーターとして指定します (Siri ショートカットとショートカットアプリを使用したユーザーの操作の追加 の "ユーザー構成可能なショートカットの定義" に示されています)。アクションを寄贈するたびに、必ずキーパラメーターのイメージを提供してください (開発者向けのガイダンスについては、INImage (INImage) を参照してください)。
同じ基本タスクを実行する複数のアクションを提供することは避けてください。 たとえば、メモにテキストを追加するアクションとイメージを追加する別のアクションを提供する代わりに、人々が両方の種類のコンテンツを追加できる単一のアクションを提供することを検討してください。いくつかの高レベルのアクションを提供すると、アクションが複数ステップのショートカットに組み合わされたときに何をするかを理解しやすくなります。
開発者向けガイダンスについては、ショートカットの管理 (Shortcut-Related UI) を参照してください。
[Siri に追加] ボタンのスタイル
[Siri に追加] ボタンは、いくつかの視覚的スタイルで使用できます。あなたのアプリのインターフェイスに合わせてボタンの角の半径をカスタマイズすることもできます。
黒。 十分なコントラストを提供する白または明るい色の背景で使用してください。黒またはダークな背景では使用しないでください。
白。 十分なコントラストを提供する暗い背景で使用します。白または明るい色の背景では使用しないでください。
輪郭のある黒。 十分なコントラストを提供するダークな背景で使用します。白または明るい色の背景では使用しないでください。
輪郭のある白。 十分なコントラストを提供できない白または明るい色の背景で使用します。ダークな背景や彩度の高い背景では使用しないでください。
[Siri に追加] ボタンの可変幅に対応します。 ボタンの幅は、様々なロケールによって異なり、ユーザーの呼び出しフレーズを表示するために更新された場合にも異なります。
[Siri に追加] ボタンの周囲に空きスペースを確保します。 少なくとも、ボタンのすべての側面にボタンの高さの 1/10 の余白を残します。
1 つの場所に複数のショートカットを表示する
あなたのアプリにいくつかのショートカットが含まれている場合は、アプリの専用領域を作成してそれらを表示することを検討してください。専用のスクリーンにより、人々はあなたのアプリのすべてのショートカットを一目で確認し、使用したいショートカットを簡単に追加できます。または、1 つのショートカットの追加オプションをサポートするために、フォローアップの質問を提供することを検討してください。
あなたのショートカットのリストには明確なタイトルを使用してください。 たとえば、ナビゲーションバーのタイトルに "Siri Shortcuts" を使用すると、スクリーンの目的が明確に伝わります。
ショートカットリストのカスタム [追加] ボタンを作成することを検討してください。 システムが提供する [Siri に追加] ボタンは、1 つのビューで複数回使用すると、視覚的な重みが大きくなりすぎる可能性があります。リスト内のすべての項目が Siri ショートカットであることがスクリーンで明確にわかる場合は、リスト内の各ショートカットに "追加" または ""+" を使用する、より単純なボタンを表示できます。
ショートカットが追加されたら、フィードバックを提供してください。 [追加] ボタンを [編集] ボタンに置き換え、録音したフレーズを表示することで、ショートカットが正常に追加されたことを人々に示します。または、[追加] ボタンを削除して、人々が録音したフレーズをタップして編集ビューを開くようにできます。
リソース
関連
開発者用文書
SiriKit (SiriKit)
