Google Play 内嵌安装（应用）

本页介绍了应用开发者如何集成内嵌式安装，这项 Google Play 新测试功能可在半页界面中显示 Google Play 应用商品详情。借助内嵌安装功能，用户无需离开应用上下文即可体验流畅的安装流程。应用开发者可以为通过 Play 分发或更新的应用集成和测试内嵌安装功能。

要求

如需在应用中显示半屏幕界面，请执行以下操作：

  • Google Play 的最低版本必须为 40.4。
  • Android API 级别必须为 23 或更高级别。

从应用调用内嵌式安装

如需从应用调用内嵌安装半页面，请创建 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，intent 会深层链接到 Google Play 是
callerId 调用方应用的 软件包名称 是
listing 用于指定自定义商品详情的目标的选项参数 否

如果应用安装流程未显示 Google Play 内嵌安装半页面界面，则系统会改为显示指向 Google Play 商品详情的直接（深层链接）。