Tích hợp lời nhắc cài đặt trong ứng dụng

Hướng dẫn này mô tả cách tích hợp lời nhắc cài đặt trong ứng dụng vào ứng dụng của bạn bằng Kotlin hoặc Java.

Thiết lập môi trường phát triển

Thư viện Lời nhắc cài đặt trong ứng dụng của Play là một phần của Thư viện Google Play Core. Để sử dụng thư viện này, hãy thêm phần phụ thuộc Gradle sau:

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'
    ...
}

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

Tạo CrossDevicePromptManager

CrossDevicePromptManager là giao diện cho phép ứng dụng của bạn yêu cầu thông tin và khởi chạy luồng lời nhắc cài đặt. Tạo một thực thể để lấy thực thể đó:

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

Yêu cầu đối tượng CrossDevicePromptInstallationRequest

Xác định thời điểm thích hợp nhất trong luồng ứng dụng để nhắc người dùng cài đặt ứng dụng của bạn trên một thiết bị khác (ví dụ: khi họ truyền video từ điện thoại sang TV). Khi ứng dụng của bạn chạy đến một trong những thời điểm này, hãy thực hiện các bước sau:

  1. Tạo CrossDevicePromptInstallationRequest.
  2. Sử dụng CrossDevicePromptManager để tạo một tác vụ yêu cầu chấp nhận yêu cầu làm tham số.

Nếu tác vụ thành công, API sẽ trả về đối tượng CrossDevicePromptInfo trong lệnh gọi lại thành công. Nếu không, API sẽ trả về một Exception trong lệnh gọi lại thất bại.

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

Để xác minh việc triển khai, hãy xem phần Kiểm thử lời nhắc cài đặt trong ứng dụng.