Lista kontrolna wymagań technicznych dotyczących gier błyskawicznych

Ostrzeżenie: aplikacja błyskawiczna w Google Play nie będzie już dostępna. Od grudnia 2025 r. nie będzie można publikować aplikacji błyskawicznych w Google Play, a wszystkie interfejsy Instant API Usług Google Play przestaną działać. Użytkownicy nie będą już otrzymywać aplikacji błyskawicznych z Google Play za pomocą żadnego mechanizmu.

Wprowadzamy tę zmianę na podstawie opinii deweloperów i naszych ciągłych inwestycji w ulepszanie ekosystemu od czasu wprowadzenia aplikacji błyskawicznych w Google Play.

Aby nadal optymalizować wzrost liczby użytkowników, zachęcamy deweloperów do kierowania użytkowników do standardowej aplikacji lub gry za pomocą precyzyjnych linków, które w razie potrzeby przekierowują ich do określonych ścieżek lub funkcji.

Aby gra mogła być utrzymywana w programie natychmiastowego odtwarzania, musi spełniać te wymagania: Aby sprawdzić zgodność, skorzystaj z listy kontrolnej do samodzielnej weryfikacji.

Wymagania

Gra błyskawiczna musi spełniać wszystkie wymagania dotyczące aplikacji błyskawicznych w Google Play oraz wszystkie te wymagania techniczne i wymagania dotyczące zasad:

  1. Gra jest publikowana za pomocą pakietu aplikacji.

  2. Rozmiar gry to maksymalnie 15 MB (po uruchomieniu można pobrać dodatkowe zasoby).

  3. Gra obsługuje ograniczenia piaskownicy aplikacji błyskawicznych w Google Play.

  4. Gra jest kierowana na Androida 8.0 (poziom interfejsu API 26) lub nowszego.

  5. Gra obsługuje architekturę 64-bitową.

  6. Gra nie korzysta z powiadomień.

  7. Gra wymaga tylko uprawnień z listy obsługiwanych uprawnień aplikacji błyskawicznych w Google Play.

  8. Wymagane jest automatyczne logowanie za pomocą Usług Gier Play.

    • Jeśli logowanie ciche się nie powiedzie, poproś użytkownika o interaktywne zalogowanie się. Użytkownicy powinni mieć możliwość anulowania interaktywnego logowania. Więcej informacji znajdziesz na liście kontrolnej jakości Usług gier Play.
  9. Zapewnij widok wyskakujących okienek Usług gier Google Play, aby użytkownicy mogli wyraźnie zobaczyć, że są zalogowani.

  10. Gra zawiera rozwiązanie do zapisywania w chmurze, które jest powiązane z identyfikatorem gracza w usługach gier Google Play. Dzięki temu stan gry użytkownika jest zachowywany w sesjach gry natychmiastowej i na różnych urządzeniach. Możesz użyć usługi takiej jak Cloud Firestore lub innej bazy danych w chmurze. Sprawdź, czy postępy gracza są powiązane z identyfikatorem gracza w usługach gier Play i przywracane natychmiast po zalogowaniu się gracza.

    • Zapisywanie stanu gry jest obowiązkowe w przypadku gier, które obsługują dowolny rodzaj trwałości między sesjami gry. Inne typy gier (np. roguelike i proste gry planszowe) przeznaczone do krótkich sesji nie wymagają zapisywania stanu gry. Zdecydowanie zalecamy jednak używanie zapisów gry lub tablic wyników do utrwalania tego stanu, aby użytkownicy nie tracili cennych wyników ani osiągnięć.
  11. Jeśli jeszcze go nie masz, dodaj do strony w sklepie film promocyjny w orientacji poziomej, który pokazuje rozgrywkę. Użytkownicy lubią filmy, które zawierają rozgrywkę pochodzącą bezpośrednio z gry. Google Play automatycznie wygeneruje z tego filmu klip z najważniejszymi momentami, który zostanie uwzględniony w aplikacji Gry Google Play. Możesz nagrać film bezpośrednio za pomocą narzędzia adb. Jeśli Twoja gra jest dostępna tylko w trybie pionowym, możesz przekonwertować ją na tryb poziomy za pomocą edytorów wideo.

  12. Gra nie zawiera przycisku instalacji. Przycisk instalacji nie jest potrzebny, ponieważ gra błyskawiczna powinna być taka sama jak zainstalowana gra. Użytkownicy nadal mogą zainstalować grę ze strony szczegółów w aplikacji Gry Play i Sklepie Google Play.

  13. Gra nie implementuje funkcji Google Play Games Services Anti-Piracy ani nie zawiera w manifeście uprawnienia com.android.vending.CHECK_LICENSE. Funkcja zapobiegająca piractwu uniemożliwia użytkownikom piracenie gier, które wymagają zakupu. Nie ma ona zastosowania w przypadku gier bezpłatnych. Włączenie testu na piractwo uniemożliwi aplikacjom błyskawicznym w Google Play logowanie się w usługach gier Play.

  14. Jeśli gra korzysta z OpenGL, upewnij się, że jest przeznaczona na OpenGL ES 2.0, ponieważ jest to jedyna wersja w pełni obsługiwana w przypadku aplikacji błyskawicznych Google Play na urządzeniach z Androidem 7 lub starszym. Upewnij się, że podajesz prawidłową wersję za pomocą parametru <uses-feature>, ustawiając android:glEsVersion na 0x00020000.

  15. W pliku AndroidManifest.xml określ 1337 jako wersję błyskawiczną, aby wskazać, że jest to pełna wersja gry błyskawicznej (a nie wersja próbna):

      <?xml version="1.0" encoding="utf-8"?>
      <manifest xmlns:android="http://schemas.android.com/apk/res/android"
         xmlns:dist="http://schemas.android.com/apk/distribution"
         package="com.yourapp.package">
         <dist:module dist:instant="true" />
         <application android:allowBackup="true">
             <meta-data android:name="com.google.android.gms.instant.flavor" android:value="1337"/>
            ...
         </application>
      </manifest>
  16. Gra generuje przychody w sposób nienaruszający komfortu użytkowników zgodnie z tymi wytycznymi:

    • Zadbaj o to, aby banery reklamowe nie przeszkadzały w grze.
    • Umieszczaj reklamy w naturalnych przerwach w rozgrywce, między treściami na stronie, poziomami lub etapami. Nie zasypuj użytkowników reklamami. Powtarzane reklamy często pogarszają wrażenia użytkowników i powodują przypadkowe kliknięcia.
    • Reklamy przed filmem wyświetlane przed rozpoczęciem gry muszą być możliwe do pominięcia po maksymalnie 5 sekundach.
    • Reklamy nie mogą być maskowane jako komponenty gry ani elementy menu lub nawigacji w grze.
    • Promocja krzyżowa innych gier jest dopuszczalna, o ile spełnia powyższe wymagania dotyczące reklam.

Lista kontrolna samodzielnego sprawdzania

Google sprawdza zgodność i bezbłędne działanie, przeprowadzając weryfikację gry. Możesz zaoszczędzić czas, sprawdzając zgodność i prawidłowe działanie przed rozpoczęciem procesu sprawdzania. Skorzystaj z tej listy kontrolnej:

  1. Film promocyjny
  2. Reklamy i zakupy w aplikacji
    • Banery reklamowe są nieuciążliwe i nie powodują przypadkowych kliknięć.
    • Reklamy wyświetlają się w naturalnych przerwach w grze i nie zasypują użytkowników.
    • Wszystkie reklamy przed filmem można pominąć po maksymalnie 5 sekundach.
    • W grze nie ma przycisku instalacji.
  3. Użycie danych
    • Użytkownicy mogą zacząć grać w mniej niż 15 sekund przez połączenie LTE lub 4G.
  4. Przycisk Wstecz
    • Gracz może wyjść z gry, naciskając przycisk Wstecz w menu głównym gry. Okno potwierdzenia wyjścia jest dozwolone, ale nie jest wymagane. Jeśli używane jest okno potwierdzenia, gra powinna zostać zamknięta, gdy użytkownik potwierdzi wyjście lub ponownie naciśnie przycisk Wstecz.
  5. Logowanie za pomocą usług gier Google Play
    1. Gdy otworzysz grę w aplikacji Gry Google Play, nastąpią te zdarzenia:
      • Gra próbuje zalogować użytkownika w usługach gier Google Play bez jego udziału.
      • Usługi gier Play wyświetlają komunikat powitalny „Cześć” z identyfikatorem gracza.
    2. Jeśli logowanie ciche się nie powiedzie, rozpocznie się logowanie interaktywne. Użytkownik może anulować logowanie, aby uniknąć nieskończonej pętli logowania.
  6. Przywracanie stanu gry (zapis gry / zakupy w aplikacji)
    • Sprawdź, czy stan gry można przywrócić:
      1. Zagraj w grę i osiągnij znaczący postęp (np. zdobądź nowy poziom lub nowy rekord) oraz, w stosownych przypadkach, dokonaj zakupu w aplikacji.
      2. Zamknij grę, a następnie usuń ją z urządzenia (zwykle w sekcji Ustawienia > Aplikacje).
      3. Uruchom ponownie grę na tym samym urządzeniu i sprawdź, czy postępy w grze i zakupy w aplikacji zostały automatycznie przywrócone.
      4. Uruchom ponownie grę na innym urządzeniu i sprawdź, czy postępy w grze i zakupy w aplikacji zostały automatycznie przywrócone.
  7. Obsługa offline
    • Sprawdź, czy w grę można grać offline:
      1. Uruchom grę online i zacznij grać.
      2. Zamknij grę i zakończ proces gry.
      3. Włącz tryb samolotowy na urządzeniu.
      4. Uruchom ponownie grę i sprawdź, czy można w nią grać offline.
  8. Obsługa urządzeń
    • Upewnij się, że w grę można w pełni grać na tabletach z Androidem.
    • Upewnij się, że gra działa na Androidzie 5 (poziom interfejsu API 21) lub nowszym.