集成应用内安装提示

本指南介绍如何使用 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)
}
MainActivity.kt

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