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

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

開発環境を設定する

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

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