整合應用程式內安裝提示

本指南說明如何使用 Kotlin 或 Java，在應用程式中整合應用程式內安裝提示。

注意： 只有搶先體驗計畫的合作夥伴，才能顯示應用程式內安裝提示。 瞭解如何加入搶先體驗計畫。

設定開發環境

Play 應用程式內安裝提示程式庫是 Google Play Core Library 的一部分。如要使用這個程式庫，請加入下列 Gradle 依附元件：

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

CrossDevicePromptManager 介面可讓應用程式要求提供資訊，並啟動安裝提示流程。建立執行個體以取得該物件：

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 物件

在應用程式流程中找出最佳時機，提示使用者在其他裝置上安裝應用程式 (例如使用者將手機上的影片投放到電視時)。當應用程式到達其中一個時間點時，請執行下列步驟：

1. 建立 CrossDevicePromptInstallationRequest。
2. 使用 CrossDevicePromptManager 建立要求工作，並接受要求做為參數。

如果工作成功，API 會在成功回呼中傳回 CrossDevicePromptInfo 物件。否則，API 會在失敗回呼中傳回 Exception。

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

重要事項： 如果在應用程式內安裝提示流程期間發生錯誤，請勿通知使用者，也不要變更應用程式正常流程。呼叫 onComplete 後，請照常進行應用程式原本的流程。

如要驗證導入狀態，請參閱「測試應用程式內安裝提示」。