Instalacje bezpośrednie w Google Play (aplikacje)

Na tej stronie opisujemy, jak deweloperzy aplikacji mogą zintegrować instalację bezpośrednią, czyli nową funkcję testową Google Play, która wyświetla szczegóły aplikacji w Google Play w interfejsie karty połówkowej. Instalacja w ramach aplikacji umożliwia użytkownikom płynne instalowanie aplikacji bez opuszczania jej kontekstu. Deweloperzy aplikacji mogą zintegrować i przetestować funkcję instalacji w ramach aplikacji w przypadku aplikacji rozpowszechnianych w Google Play lub aktualizowanych w tej usłudze.

Wymagania

Aby interfejs karty połowy ekranu był widoczny w aplikacji:

  • Minimalna wersja Google Play musi wynosić 40.4.
  • Poziom interfejsu API Androida musi wynosić 23 lub wyższy.

Wywoływanie instalacji bezpośrednich z aplikacji

Aby wywołać z aplikacji półekranową stronę instalacji, utwórz instancję klasy Intent, która otwiera adres URL precyzyjnego linku. Jako wskazówkę możesz wykorzystać poniższy przykładowy kod (Kotlin lub Java).

Kotlin

val intent = Intent(Intent.ACTION_VIEW)
val referrer = ""
val id = ""
val callerId = ""
intent.setPackage("com.android.vending")
val deepLinkUrl = "https://play.google.com/d?id=$id&referrer=$referrer&listing=$csl_id"
intent.data = Uri.parse(deepLinkUrl)
intent.putExtra("overlay", true)
intent.putExtra("callerId", "$callerId")
val packageManager = context.getPackageManager()
if (intent.resolveActivity(packageManager) != null) {
  startActivityForResult(intent, 0)
} else {
  // Fallback to deep linking to full Play Store.
}

Java

Intent intent = new Intent(Intent.ACTION_VIEW);
String referrer = "";
String id = "";
String callerId = "";
String csl_id = "";
intent.setPackage("com.android.vending");
String deepLinkUrl = "https://play.google.com/d?id=" + id + "&referrer=" + referrer + "&listing=" + csl_id;
intent.setData(Uri.parse(deepLinkUrl));
intent.putExtra("overlay", true);
intent.putExtra("callerId", callerId);
PackageManager packageManager = context.getPackageManager();
if (intent.resolveActivity(packageManager) != null) {
  startActivityForResult(intent, 0);
} else {
  // Fallback to deep linking to full Play Store.
}

Parametry interfejsu API instalacji bezpośredniej

Pole Opis Wymagane
referrer Opcjonalny ciąg znaków referrer do śledzenia Nie
id Nazwa pakietu aplikacji do zainstalowania Tak
overlay Ustaw na true, jeśli chcesz wyświetlić kartę w ramce, lub na false, jeśli chcesz utworzyć precyzyjny link do Google Play. Tak
callerId Nazwa pakietu aplikacji wywołującej Tak
listing Opcjonalny parametr umożliwiający określenie docelowych informacji o niestandardowej aplikacji. Nie

Jeśli proces instalacji aplikacji nie wyświetla interfejsu wbudowanego w Google Play, zamiast niego wyświetlany jest bezpośredni link do strony aplikacji w Google Play.