In-App-Installationsaufforderungen einbinden

In diesem Leitfaden wird beschrieben, wie Sie In-App-Installationsaufforderungen in Ihre App einbinden. Dazu können Sie entweder Kotlin oder Java verwenden.

Entwicklungsumgebung einrichten

Die Play In-App Install Prompts Library ist Teil der Google Play Core-Bibliotheken. Wenn Sie die Bibliothek verwenden möchten, fügen Sie die folgende Gradle-Abhängigkeit hinzu:

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

Aufforderung zur geräteübergreifenden Installation anzeigen

Bestimmen Sie den besten Moment im Ablauf Ihrer App, um den Nutzer aufzufordern, Ihre App auf einem anderen Gerät zu installieren (z. B. wenn er ein Video von seinem Smartphone auf einen Fernseher streamt). Wenn Ihre App einen dieser Punkte erreicht, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie einen CrossDevicePromptInstallationRequest.
  2. Verwenden Sie CrossDevicePromptManager, um eine Anforderungsaufgabe zu erstellen, die die Anfrage als Parameter akzeptiert.
  3. Verwenden Sie das resultierende CrossDevicePromptInfo-Objekt mit launchPromptFlow(), um dem Nutzer die Aufforderung zu präsentieren.

Wenn beim Abrufen der CrossDevicePromptInfo oder beim Anzeigen des Prompts ein Fehler auftritt, wird eine Ausnahme ausgelöst.

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)
}

Weitere Informationen zum Testen von In-App-Installationsaufforderungen