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:

Groovy

// In your app's build.gradle file:
...
dependencies {
    // This dependency is downloaded from the <a href="/studio/build/dependencies#google-maven">Google's Maven repository</a>.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:crossdeviceprompt:0.0.1-eap01'
    ...
}

Kotlin

// In your app's build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the <a href="/studio/build/dependencies#google-maven">Google's Maven repository</a>.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:crossdeviceprompt:0.0.1-eap01")
    ...
}

CrossDevicePromptManager erstellen

CrossDevicePromptManager ist die Schnittstelle, über die Ihre App Informationen anfordern und den Installationsaufforderungsablauf starten kann. So erstellen Sie eine Instanz, um sie zu erhalten:

Kotlin

import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptInfo
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManager
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManagerFactory
import com.google.android.play.core.crossdeviceprompt.model.CrossDevicePromptInstallationRequest

...

val crossDevicePromptManager: CrossDevicePromptManager =
    CrossDevicePromptManagerFactory.create(context)

Java

import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptInfo;
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManager;
import com.google.android.play.core.crossdeviceprompt.CrossDevicePromptManagerFactory;
import com.google.android.play.core.crossdeviceprompt.model.CrossDevicePromptInstallationRequest;

...

CrossDevicePromptManager crossDevicePromptManager =
    CrossDevicePromptManagerFactory.create(context);

CrossDevicePromptInstallationRequest-Objekt anfordern

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 ein CrossDevicePromptInstallationRequest.
  2. Verwenden Sie CrossDevicePromptManager, um eine Anforderungsaufgabe zu erstellen, die die Anfrage als Parameter akzeptiert.

Wenn der Vorgang erfolgreich ist, gibt die API das CrossDevicePromptInfo-Objekt im Erfolgs-Callback zurück. Andernfalls gibt die API im Fehler-Callback ein Exception zurück.

Kotlin

val request: CrossDevicePromptInstallationRequest? =
    CrossDevicePromptInstallationRequest.create()
val result: Task<CrossDevicePromptInfo?> =
    crossDevicePromptManager.requestInstallationPromptFlow(request)

result.addOnSuccessListener { crossDevicePromptInfo ->
    // Requested a prompt flow successfully
}

result.addOnFailureListener { e ->
    // Failed to request a prompt flow
}

Java

CrossDevicePromptInstallationRequest request =
    CrossDevicePromptInstallationRequest.create();
Task<CrossDevicePromptInfo> result =
    crossDevicePromptManager.requestInstallationPromptFlow(request);

result.addOnSuccessListener(crossDevicePromptInfo -> {
    // Requested a prompt flow successfully
});

result.addOnFailureListener(e -> {
    // Failed to request a prompt flow
});

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