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 cách sử dụ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-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")
    ...
}

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à chạy quy trình lời nhắc cài đặt. Tạo một thực thể để lấy thông tin đó:

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 quy trình của ứ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ề Exception trong lệnh gọi lại không thành công.

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 quá trình triển khai, hãy xem bài viết Kiểm thử lời nhắc cài đặt trong ứng dụng.