ショートカットに関するおすすめの方法

アプリのショートカットを設計、作成する際は、次のガイドラインに従ってください。

設計ガイドラインを遵守する

アプリのショートカットとシステムアプリで使用するショートカットを一致させるには、アプリ ショートカットのアイコンの設計ガイドラインに準拠します。

4 つの異なるショートカットのみを公開する

API では、最大 15 個の静的ショートカットと動的ショートカットの組み合わせがサポートされていますが、ランチャーでの外観を改善するために、4 つの異なるショートカットのみを公開することをおすすめします。

ランチャーにショートカットを表示するだけでなく、Google Shortcuts Integration Library を使用して、Google アシスタントなどの Google サーフェスにショートカットを表示できます。このライブラリでは、プッシュできる動的ショートカットの数に制限はありません。このライブラリを使用して多数のショートカットをプッシュする場合は、setRank() メソッドを呼び出して、サポートされているランチャーに表示する必要があるショートカットの rank を設定することをおすすめします。

ショートカットの説明の長さを制限する

ランチャーのアプリのショートカットを表示するメニューのスペースは限られています。可能であれば、ショートカットの「短い説明」の長さは 10 文字以下にし、「長い説明」の長さは 25 文字以下にしてください。

静的ショートカットのラベルの詳細については、属性値のカスタマイズをご覧ください。動的ショートカットと固定ショートカットについては、setLongLabel()setShortLabel() のリファレンス ドキュメントをご覧ください。

ショートカットとアクションの使用履歴を管理する

作成するショートカットごとに、ユーザーがアプリ内で同じタスクを直接実行するためのさまざまな方法を検討します。このような状況のそれぞれで reportShortcutUsed() を呼び出して、ユーザーがショートカットを表すアクションを実行する頻度の正確な履歴をランチャーで保持します。

ショートカットの内容が保持される場合にのみショートカットを更新する

動的ショートカットと固定ショートカットを変更する場合、その意味を保持するショートカットの情報を変更する場合にのみ、updateShortcuts() を呼び出します。それ以外の場合は、再作成するショートカットの種類に応じて、次のいずれかの方法を使用します。

たとえば、スーパーマーケットに移動するショートカットを作成する場合、スーパーマーケットの名前が変更されても場所が変わらない場合は、ショートカットを更新するのが適切です。ただし、ユーザーが別のスーパーマーケットで買い物を始めた場合は、新しいショートカットを作成することをおすすめします。

アプリを起動するたびに動的ショートカットを確認する

動的ショートカットは、ユーザーが新しいデバイスにデータを復元する際に保持されません。このため、バックアップと復元のコード スニペットに示すように、アプリを起動するたびに getDynamicShortcuts() から返されるオブジェクトの数を確認し、必要に応じて動的ショートカットを再公開することをおすすめします。