ادغام پیام‌های نصب درون برنامه‌ای

این راهنما نحوه ادغام اعلان‌های نصب درون برنامه‌ای را در برنامه شما با استفاده از کاتلین یا جاوا شرح می‌دهد.

توجه: فقط شرکای دسترسی زودهنگام می‌توانند پیام‌های نصب درون‌برنامه‌ای را نمایش دهند. درباره شرکت در برنامه دسترسی زودهنگام اطلاعات کسب کنید .

محیط توسعه خود را تنظیم کنید

کتابخانه‌ی Play In-App Install Prompts بخشی از کتابخانه‌های Google Play Core است. برای استفاده از این کتابخانه، وابستگی Gradle زیر را اضافه کنید:

گرووی

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

کاتلین

// 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 رابطی است که به برنامه شما اجازه می‌دهد اطلاعات را درخواست کرده و روند نصب را آغاز کند. برای دریافت آن، یک نمونه ایجاد کنید:

کاتلین

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)

جاوا

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 برمی‌گرداند.

کاتلین

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
}

جاوا

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 ، روند عادی برنامه را ادامه دهید.

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