یکپارچه‌سازی پیام‌واره‌های نصب درون‌برنامه‌ای

این راهنما نحوه ادغام پیام‌واره‌های نصب درون‌برنامه را در برنامه‌تان بااستفاده از Kotlin یا Java توضیح می‌دهد.

راه‌اندازی محیط توسعه

«کتابخانه پیام‌واره‌های نصب درون‌برنامه Play» بخشی از کتابخانه‌های اصلی Google Play است. برای استفاده از کتابخانه، وابستگی Gradle زیر را اضافه کنید:

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

نمایش پیام‌واره نصب بین‌دستگاهی

بهترین لحظه در جریان برنامه را برای درخواست از کاربر برای نصب برنامه در دستگاه دیگر تعیین کنید (برای مثال، زمانی که کاربر ویدیویی را از تلفن خود به تلویزیون پخش می‌کند). وقتی برنامه شما به یکی از این نقاط می‌رسد، مراحل زیر را انجام دهید:

  1. ‫CrossDevicePromptInstallationRequest ایجاد کنید.
  2. از CrossDevicePromptManager برای ایجاد وظیفه درخواست استفاده کنید که درخواست را به‌عنوان پارامتر می‌پذیرد.
  3. از شیء CrossDevicePromptInfo حاصل با launchPromptFlow() برای نمایش پیام‌واره به کاربر استفاده کنید.

اگر هنگام دریافت CrossDevicePromptInfo یا نمایش پیام‌واره خطایی رخ دهد، استثنایی ایجاد می‌شود.

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

برای درستی‌سنجی پیاده‌سازی خود، به آزمایش پیام‌واره‌های نصب درون‌برنامه‌ای مراجعه کنید.