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

این راهنما نحوه ادغام نقد و بررسی‌های درون برنامه‌ای را در برنامه شما با استفاده از کاتلین یا جاوا شرح می‌دهد. اگر از کد بومی ، یونیتی یا موتور آنریل استفاده می‌کنید، راهنماهای ادغام جداگانه‌ای وجود دارد.

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

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

گرووی

// 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.
});

مراحل بعدی

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