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 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, hãy thêm phần phụ thuộc Gradle sau:

// In your app's build.gradle.kts file:
...
dependencies {
    implementation("com.google.android.play:crossdeviceprompt:0.0.1")
    ...
}

Hiện lời nhắc cài đặt trên nhiều thiết bị

Xác định thời điểm phù 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 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 dưới dạng tham số.
  3. Sử dụng đối tượng CrossDevicePromptInfo thu được với launchPromptFlow() để hiển thị lời nhắc cho người dùng.

Nếu xảy ra lỗi khi lấy CrossDevicePromptInfo hoặc hiển thị lời nhắc, thì hệ thống sẽ gửi một ngoại lệ.

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

Để 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.