本页介绍了应用开发者如何集成内嵌式安装,这是 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,则 intent 会深层链接到 Google Play |
是 |
callerId |
调用方应用的软件包名称 | 是 |
listing |
一个可选参数,用于为自定义商品详情指定目标 | 否 |
如果应用安装流程未显示 Google Play 内嵌式安装半屏界面,则会改为显示 Google Play 商品详情的直接链接(深层链接)。