Utwórz skróty

Podczas projektowania i tworzenia skrótów do aplikacji postępuj zgodnie z tymi wskazówkami:

Stosuj wskazówki dotyczące układu reklamy

Aby skróty do aplikacji były wizualnie spójne ze skrótami używanymi w aplikacjach systemowych, postępuj zgodnie ze wskazówkami dotyczącymi projektowania ikon skrótów do aplikacji.

Publikuj tylko 4 różne skróty

Chociaż interfejs API obsługuje kombinację maksymalnie 15 skrótów statycznych i dynamicznych do aplikacji, zalecamy publikowanie tylko 4 różnych skrótów, aby poprawić ich wygląd w programie uruchamiającym.

Oprócz wyświetlania skrótów w programie uruchamiającym użyj biblioteki integracji skrótów Google, aby wyświetlać skróty w usługach Google takich jak Asystent Google. Ta biblioteka obsługuje wysyłanie nieograniczonej liczby skrótów dynamicznych. Jeśli używasz tej biblioteki do wysyłania dużej liczby skrótów, zalecamy ustawienie rank skrótów, które mają się pojawiać w obsługiwanych programach uruchamiających, przez wywołanie metody setRank().

Ogranicz długość opisu skrótu

Miejsce w menu, w którym wyświetlane są skróty do aplikacji w programie uruchamiającym, jest ograniczone. Jeśli to możliwe, ogranicz długość „krótkiego opisu” skrótu do 10 znaków, a „długiego opisu” do 25 znaków.

Więcej informacji o etykietach skrótów statycznych znajdziesz w artykule Dostosowywanie wartości atrybutów. W przypadku skrótów dynamicznych i przypiętych zapoznaj się z dokumentacją referencyjną dotyczącą metod setLongLabel() i setShortLabel().

Zachowaj historię użycia skrótów i działań

W przypadku każdego utworzonego skrótu zastanów się, w jaki sposób użytkownik może wykonać to samo zadanie bezpośrednio w aplikacji. W każdej z tych sytuacji wywołaj metodę reportShortcutUsed(), aby program uruchamiający zachowywał dokładną historię tego, jak często użytkownik wykonuje działania reprezentujące Twoje skróty.

Aktualizuj skróty tylko wtedy, gdy zachowują one swoje znaczenie

Podczas zmieniania skrótów dynamicznych i przypiętych wywołuj metodę updateShortcuts() tylko wtedy, gdy zmieniasz informacje o skrócie, który zachowuje swoje znaczenie. W przeciwnym razie użyj jednej z tych metod w zależności od typu skrótu, który odtwarzasz:

• Skróty dynamiczne: pushDynamicShortcut().

• Skróty przypięte: requestPinShortcut().

  Jeśli na przykład utworzysz skrót do supermarketu, możesz go zaktualizować, jeśli zmieni się nazwa supermarketu, ale jego lokalizacja pozostanie taka sama. Jeśli jednak użytkownik zacznie robić zakupy w innym supermarkecie, lepiej utworzyć nowy skrót.

Sprawdzaj skróty dynamiczne za każdym razem, gdy uruchamiasz aplikację

Skróty dynamiczne nie są zachowywane, gdy użytkownik przywraca dane na nowym urządzeniu. Z tego powodu zalecamy, aby za każdym razem, gdy uruchamiasz aplikację, sprawdzać liczbę obiektów zwracanych przez metodę getDynamicShortcuts() i w razie potrzeby ponownie publikować skróty dynamiczne, jak pokazano we fragmencie kodu w sekcji Tworzenie kopii zapasowej i przywracanie.