ادغام بررسی های درون برنامه ای (Kotlin یا Java)

این راهنما نحوه ادغام نظرات درون برنامه ای را با استفاده از Kotlin یا Java در برنامه خود توضیح می دهد. اگر از کد بومی یا Unity استفاده می کنید، راهنماهای ادغام جداگانه ای وجود دارد.

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

کتابخانه نقد درون برنامه‌ای Play بخشی از کتابخانه‌های هسته Google Play است. لطفاً وابستگی Gradle زیر را برای ادغام کتابخانه بررسی درون برنامه Play اضافه کنید.

شیار

// In your app’s build.gradle file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.play:review:2.0.2'

    // For Kotlin users also add the Kotlin extensions library for Play In-App Review:
    implementation 'com.google.android.play:review-ktx:2.0.2'
    ...
}

کاتلین

// In your app’s build.gradle.kts file:
...
dependencies {
    // This dependency is downloaded from the Google’s Maven repository.
    // So, make sure you also include that repository in your project's build.gradle file.
    implementation("com.google.android.play:review:2.0.2")

    // For Kotlin users also import the Kotlin extensions library for Play In-App Review:
    implementation("com.google.android.play:review-ktx:2.0.2")
    ...
}

ReviewManager را ایجاد کنید

ReviewManager رابطی است که به برنامه شما اجازه می دهد تا یک جریان بررسی درون برنامه ای را شروع کند. آن را با ایجاد یک نمونه با استفاده از ReviewManagerFactory به دست آورید.

کاتلین

val manager = ReviewManagerFactory.create(context)

جاوا

ReviewManager manager = ReviewManagerFactory.create(context)

درخواست یک شی ReviewInfo

دستورالعمل‌های مربوط به زمان درخواست بررسی درون‌برنامه‌ای را دنبال کنید تا نکات خوبی را در جریان کاربر برنامه‌تان تعیین کنید تا کاربر را برای بازبینی ترغیب کنید (مثلاً وقتی کاربر یک سطح را در یک بازی کامل می‌کند). وقتی برنامه شما به یکی از این نقاط رسید، از نمونه ReviewManager برای ایجاد یک کار درخواست استفاده کنید. در صورت موفقیت آمیز بودن، API شی ReviewInfo مورد نیاز برای شروع جریان بررسی درون برنامه را برمی گرداند.

کاتلین

val request = manager.requestReviewFlow()
request.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // We got the ReviewInfo object
        val reviewInfo = task.result
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode val reviewErrorCode = (task.getException() as ReviewException).errorCode
    }
}

جاوا

ReviewManager manager = ReviewManagerFactory.create(this);
Task<ReviewInfo> request = manager.requestReviewFlow();
request.addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        // We can get the ReviewInfo object
        ReviewInfo reviewInfo = task.getResult();
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode int reviewErrorCode = ((ReviewException) task.getException()).getErrorCode();
    }
});

جریان بررسی درون برنامه ای را راه اندازی کنید

از نمونه ReviewInfo برای راه‌اندازی جریان بررسی درون‌برنامه استفاده کنید. منتظر بمانید تا کاربر جریان بررسی درون‌برنامه‌ای را کامل کند تا برنامه شما به جریان کاربر عادی خود ادامه دهد (مانند ارتقاء به سطح بعدی).

کاتلین

val flow = manager.launchReviewFlow(activity, reviewInfo)
flow.addOnCompleteListener { _ ->
    // The flow has finished. The API does not indicate whether the user
    // reviewed or not, or even whether the review dialog was shown. Thus, no
    // matter the result, we continue our app flow.
}

جاوا

Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo);
flow.addOnCompleteListener(task -> {
    // The flow has finished. The API does not indicate whether the user
    // reviewed or not, or even whether the review dialog was shown. Thus, no
    // matter the result, we continue our app flow.
});

مراحل بعدی

جریان بررسی درون برنامه ای برنامه خود را آزمایش کنید تا مطمئن شوید که یکپارچه سازی شما به درستی کار می کند.