In-App-Installationsaufforderungen einbinden

In diesem Leitfaden wird beschrieben, wie Sie In-App-Installationsaufforderungen mit Kotlin oder Java in Ihre App einbinden.

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

Bestimme den besten Moment im Ablauf deiner App, um den Nutzer aufzufordern, deine 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 Anfrageaufgabe zu erstellen, die die Anfrage als Parameter akzeptiert.
  3. Verwenden Sie das resultierende CrossDevicePromptInfo-Objekt mit launchPromptFlow(), um dem Nutzer die Aufforderung anzuzeigen.

Wenn beim Abrufen des CrossDevicePromptInfo oder beim Anzeigen der Aufforderung 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)
}

Informationen zum Überprüfen Ihrer Implementierung finden Sie unter In-App-Installationsaufforderungen testen.