集成应用内安装提示

本指南介绍如何使用 Kotlin 或 Java 将应用内安装提示集成到您的应用中。

设置您的开发环境

Play 应用内安装提示库是 Google Play Core 库的一部分。如需使用该库，请添加以下 Gradle 依赖项：

// In your app's build.gradle.kts file:
...
dependencies {
    implementation("com.google.android.play:crossdeviceprompt:0.0.1")
    ...
}

显示跨设备安装提示

确定在应用流程中的哪个时刻提示用户在另一部设备上安装您的应用效果最好（例如，当用户将手机中的视频投放到电视上时）。当您的应用达到其中一个阶段时，请执行以下步骤：

  1. 创建 CrossDevicePromptInstallationRequest 网址。
  2. 使用 CrossDevicePromptManager 创建一个接受请求作为参数的请求任务。
  3. 将生成的 CrossDevicePromptInfo 对象与 launchPromptFlow() 搭配使用，以向用户显示提示。

如果在获取 CrossDevicePromptInfo 或显示提示时发生错误，系统会抛出异常。

val crossDevicePromptManager = CrossDevicePromptManagerFactory.create(activity)
val request = CrossDevicePromptInstallationRequest.create()

try {
    val info = crossDevicePromptManager.requestInstallationPromptFlow(request).await()
    crossDevicePromptManager.launchPromptFlow(activity, info).await()
} catch (e: CrossDevicePromptException) {
    Log.e(TAG, "Cross-device prompt failed with error: ${e.errorCode}", e)
}

如需验证您的实现，请参阅测试应用内安装提示。