アプリ内インストール プロンプトを統合する

このガイドでは、Kotlin または Java を使用して、アプリ内インストール プロンプトをアプリに統合する方法について説明します。

開発環境を設定する

Play In-App Install Prompts Library は Google Play Core Library の一部です。ライブラリを使用するには、次の 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)
}

実装を確認するには、アプリ内インストール プロンプトをテストするをご覧ください。