Instalacje bezpośrednie w Google Play (aplikacje)

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

Wymagania

Aby interfejs półarkusza pojawił się w aplikacji:

  • minimalna wersja Google Play musi być 40.4;
  • poziom interfejsu API Androida musi wynosić 24 lub więcej.

Wywoływanie instalacji bezpośrednich z aplikacji

Aby wywołać półarkusz instalacji bezpośredniej z aplikacji, utwórz instancję klasy Intent, która otwiera adres URL precyzyjnego linku. Skorzystaj z poniższego przykładowego kodu (w Kotlinie lub Javie).

Kotlin

val intent = Intent(Intent.ACTION_VIEW)
val referrer = "<Your referrer string>"
val id = "<Package name of the app that is to be installed>"
val callerId = "<Package name of your app>"
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 = "<Your referrer string>";
String id = "<Package name of the app that is to be installed>";
String callerId = "<package name of your app>";
String csl_id = "<Custom store listing 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 Inline Install API

Pole Opis Wymagane
referrer Opcjonalny ciąg znaków do śledzenia źródła Nie
id Nazwa pakietu aplikacji, która ma zostać zainstalowana Tak
overlay Ustaw na true jeśli wymagany jest półarkusz instalacji bezpośredniej; jeśli false, intencja prowadzi do precyzyjnego linku w Google Play Tak
callerId Nazwa pakietu aplikacji wywołującej Tak
listing Opcjonalny parametr określający miejsce docelowe niestandardowych informacji o aplikacji Nie

Jeśli proces instalacji aplikacji nie wyświetla interfejsu półarkusza instalacji bezpośredniej w Google Play, zamiast tego wyświetlany jest bezpośredni link (precyzyjny link) do strony aplikacji w Google Play.