Utwórz skróty

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

stosuj wskazówki dotyczące układu reklamy
Aby skróty aplikacji były wizualnie spójne ze skrótami używanymi w aplikacjach systemowych, postępuj zgodnie z wytycznymi dotyczącymi projektowania ikon skrótów do aplikacji.
Opublikuj 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 dynamicznych skrótów. Jeśli używasz tej biblioteki do przesyłania dużej liczby skrótów, zalecamy ustawienie rank skrótów, które muszą pojawiać się w obsługiwanych programach uruchamiających, przez wywołanie metody setRank().

Ograniczanie długości opisu skrótu

Miejsce w menu, w którym wyświetlają się 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 statycznych skrótów znajdziesz w artykule Dostosowywanie wartości atrybutów. W przypadku skrótów dynamicznych i przypiętych zapoznaj się z dokumentacją referencyjną dotyczącą setLongLabel()setShortLabel().

Zachowywanie historii używania 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łuj funkcję reportShortcutUsed(), aby program uruchamiający zachowywał dokładną historię tego, jak często użytkownik wykonuje działania reprezentujące skróty.

Aktualizowanie skrótów tylko wtedy, gdy zachowują one swoje znaczenie

Podczas zmiany skrótów dynamicznych i przypiętych wywołuj funkcję 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 odtwarzanego skrótu:

  • Skróty dynamiczne: pushDynamicShortcut().
  • Przypięte skróty: requestPinShortcut().

    Jeśli na przykład utworzysz skrót do supermarketu, warto go zaktualizować, gdy 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 przy każdym uruchomieniu aplikacji
Skróty dynamiczne nie są zachowywane, gdy użytkownik przywraca dane na nowe urządzenie. Z tego powodu zalecamy sprawdzanie liczby obiektów zwracanych przez getDynamicShortcuts() przy każdym uruchomieniu aplikacji i w razie potrzeby ponowne publikowanie skrótów dynamicznych, jak pokazano w fragmencie kodu w sekcji Tworzenie kopii zapasowych i przywracanie.