Google Play 內嵌安裝 (應用程式)

本頁面說明應用程式開發人員如何整合內嵌安裝功能。這項 Google Play 新測試功能會以半頁介面顯示 Google Play 應用程式產品詳細資料。透過內嵌安裝功能，使用者不必離開應用程式，就能順暢地安裝應用程式。應用程式開發人員可以整合並測試內嵌安裝功能，適用於透過 Play 發布或更新的應用程式。

需求條件

如要在應用程式中顯示半頁介面：

  • Google Play 最低版本須為 40.4。
  • Android API 級別必須為 24 以上。

從應用程式叫用內嵌安裝功能

如要從應用程式叫用內嵌安裝半頁畫面，請建立 Intent 類別的執行個體，開啟深層連結網址。請參考下列程式碼範例 (Kotlin 或 Java)。

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.
}

內嵌安裝 API 參數

欄位 說明 必填
referrer 選用的參照網址追蹤字串 否
id 要安裝的應用程式 套件名稱 是
overlay 如果要求內嵌半頁功能表，請設為 true；如果為 false，意圖會深層連結至 Google Play 是
callerId 呼叫端應用程式的 套件名稱 是
listing 選用參數，用於指定自訂商店資訊的目標 否

如果應用程式安裝流程未顯示 Google Play 內嵌安裝半頁面介面，系統會改為顯示 Google Play 資訊的直接連結 (深層連結)。