ইন-অ্যাপ রিভিউ একত্রিত করুন (নেটিভ)

এই নির্দেশিকাটি বর্ণনা করে কিভাবে আপনার অ্যাপে নেটিভ (C অথবা C++) কোড ব্যবহার করে ইন-অ্যাপ পর্যালোচনাগুলি একীভূত করবেন। আপনি যদি Kotlin অথবা Java , Unity অথবা Unreal Engine ব্যবহার করেন তবে আলাদা ইন্টিগ্রেশন নির্দেশিকা রয়েছে।

নেটিভ SDK ওভারভিউ

Play Core Native SDK হল Google Play Core লাইব্রেরি পরিবারের অংশ। Play Core Native SDK-তে একটি C হেডার ফাইল রয়েছে, review.h , যা Java Play In-App Review লাইব্রেরি থেকে ReviewManager মোড়ানো হয়। এই হেডার ফাইলটি আপনার অ্যাপকে আপনার নেটিভ কোড থেকে সরাসরি API কল করতে দেয়। উপলব্ধ পাবলিক ফাংশনগুলির একটি সারসংক্ষেপের জন্য, Play Review নেটিভ মডিউল ডকুমেন্টেশন দেখুন।

ReviewManager_requestReviewFlow একটি অনুরোধ শুরু করে যা পরবর্তীতে ইন-অ্যাপ পর্যালোচনা প্রবাহ চালু করার জন্য প্রয়োজনীয় তথ্য সংগ্রহ করে। আপনি ReviewManager_getReviewStatus ব্যবহার করে অনুরোধের ফলাফল ট্র্যাক করতে পারেন। ReviewManager_getReviewStatus যে সমস্ত স্ট্যাটাস ফেরত দিতে পারে সে সম্পর্কে আরও তথ্যের জন্য, ReviewErrorCode দেখুন।

ফাংশনটি সফল হলে অনুরোধ এবং লঞ্চ ফাংশন উভয়ই REVIEW_NO_ERROR ফেরত দেয়।

আপনার উন্নয়ন পরিবেশ সেট আপ করুন

1. নিচের যেকোনো একটি করুন:

   • অ্যান্ড্রয়েড স্টুডিও সংস্করণ ৪.০ বা তার উচ্চতর সংস্করণ ইনস্টল করুন। অ্যান্ড্রয়েড এসডিকে প্ল্যাটফর্ম সংস্করণ ১০.০ (এপিআই লেভেল ২৯) ইনস্টল করতে এসডিকে ম্যানেজার ইউআই ব্যবহার করুন।
   • Android SDK কমান্ড-লাইন টুল ইনস্টল করুন এবং sdkmanager ব্যবহার করে Android SDK প্ল্যাটফর্ম সংস্করণ 10.0 (API স্তর 29) ইনস্টল করুন।

2. SDK ম্যানেজার ব্যবহার করে সর্বশেষ CMake এবং Android Native Development Kit (NDK) ইনস্টল করে নেটিভ ডেভেলপমেন্টের জন্য Android Studio প্রস্তুত করুন। নেটিভ প্রজেক্ট তৈরি বা আমদানি সম্পর্কে আরও তথ্যের জন্য, NDK দিয়ে শুরু করা দেখুন।

3. জিপ ফাইলটি ডাউনলোড করুন এবং আপনার প্রকল্পের পাশাপাশি এটি এক্সট্র্যাক্ট করুন।

   ডাউনলোড লিংক	আকার	SHA-256 চেকসাম
   প্লে-কোর-নেটিভ-এসডিকে-১.১৫.৪.জিপ	৩৯.৬ মাইল	92b43246860d4ce4772a3a0786212d9b4781920e112d81b93ca1c5ebd8da89cb

4. আপনার অ্যাপের build.gradle ফাইলটি নীচের চিত্রের মতো আপডেট করুন:

   খাঁজকাটা

       // App build.gradle
   
       plugins {
         id 'com.android.application'
       }
   
       // Define a path to the extracted Play Core SDK files.
       // If using a relative path, wrap it with file() since CMake requires absolute paths.
       def playcoreDir = file('../path/to/playcore-native-sdk')
   
       android {
           defaultConfig {
               ...
               externalNativeBuild {
                   cmake {
                       // Define the PLAYCORE_LOCATION directive.
                       arguments "-DANDROID_STL=c++_static",
                                 "-DPLAYCORE_LOCATION=$playcoreDir"
                   }
               }
               ndk {
                   // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
                   abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
               }
           }
           buildTypes {
               release {
                   // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
                   proguardFile '$playcoreDir/proguard/common.pgcfg'
                   proguardFile '$playcoreDir/proguard/gms_task.pgcfg'
                   proguardFile '$playcoreDir/proguard/per-feature-proguard-files'
                   ...
               }
               debug {
                   ...
               }
           }
           externalNativeBuild {
               cmake {
                   path 'src/main/CMakeLists.txt'
               }
           }
       }
   
       dependencies {
           // Import these feature-specific AARs for each Google Play Core library.
           implementation 'com.google.android.play:app-update:2.1.0'
           implementation 'com.google.android.play:asset-delivery:2.3.0'
           implementation 'com.google.android.play:integrity:1.5.0'
           implementation 'com.google.android.play:review:2.0.2'
   
           // Import these common dependencies.
           implementation 'com.google.android.gms:play-services-tasks:18.0.2'
           implementation files("$playcoreDir/playcore-native-metadata.jar")
           ...
       }
       

   কোটলিন

   // App build.gradle
   
   plugins {
       id("com.android.application")
   }
   
   // Define a path to the extracted Play Core SDK files.
   // If using a relative path, wrap it with file() since CMake requires absolute paths.
   val playcoreDir = file("../path/to/playcore-native-sdk")
   
   android {
       defaultConfig {
           ...
           externalNativeBuild {
               cmake {
                   // Define the PLAYCORE_LOCATION directive.
                   arguments += listOf("-DANDROID_STL=c++_static", "-DPLAYCORE_LOCATION=$playcoreDir")
               }
           }
           ndk {
               // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
               abiFilters.clear()
               abiFilters += listOf("armeabi-v7a", "arm64-v8a", "x86", "x86_64")
           }
       }
       buildTypes {
           release {
               // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
               proguardFile("$playcoreDir/proguard/common.pgcfg")
               proguardFile("$playcoreDir/proguard/gms_task.pgcfg")
               proguardFile("$playcoreDir/proguard/per-feature-proguard-files")
               ...
           }
           debug {
               ...
           }
       }
       externalNativeBuild {
           cmake {
               path = "src/main/CMakeLists.txt"
           }
       }
   }
   
   dependencies {
       // Import these feature-specific AARs for each Google Play Core library.
       implementation("com.google.android.play:app-update:2.1.0")
       implementation("com.google.android.play:asset-delivery:2.3.0")
       implementation("com.google.android.play:integrity:1.5.0")
       implementation("com.google.android.play:review:2.0.2")
   
       // Import these common dependencies.
       implementation("com.google.android.gms:play-services-tasks:18.0.2")
       implementation(files("$playcoreDir/playcore-native-metadata.jar"))
       ...
   }

5. আপনার অ্যাপের CMakeLists.txt ফাইলগুলি নীচে দেখানো হিসাবে আপডেট করুন:

   cmake_minimum_required(VERSION 3.6)
   
   ...
   
   # Add a static library called “playcore” built with the c++_static STL.
   include(${PLAYCORE_LOCATION}/playcore.cmake)
   add_playcore_static_library()
   
   // In this example “main” is your native code library, i.e. libmain.so.
   add_library(main SHARED
           ...)
   
   target_include_directories(main PRIVATE
           ${PLAYCORE_LOCATION}/include
           ...)
   
   target_link_libraries(main
           android
           playcore
           ...)
   

তথ্য সংগ্রহ

Play Core Native SDK Google-কে পণ্যটি উন্নত করার অনুমতি দেওয়ার জন্য সংস্করণ সম্পর্কিত ডেটা সংগ্রহ করতে পারে, যার মধ্যে রয়েছে:

• অ্যাপের প্যাকেজের নাম
• অ্যাপের প্যাকেজ সংস্করণ
• কোর নেটিভ SDK এর সংস্করণটি খেলুন

আপনার অ্যাপ প্যাকেজটি Play Console-এ আপলোড করার সময় এই ডেটা সংগ্রহ করা হবে। এই ডেটা সংগ্রহ প্রক্রিয়া থেকে বেরিয়ে আসতে, build.gradle ফাইল থেকে $playcoreDir/playcore-native-metadata.jar আমদানিটি সরিয়ে ফেলুন।

মনে রাখবেন, Play Core Native SDK ব্যবহারের সাথে সম্পর্কিত এই ডেটা সংগ্রহ এবং Google-এর সংগৃহীত ডেটা ব্যবহারের সাথে সম্পর্কিত তথ্য, Play Console-এ আপনার অ্যাপ প্যাকেজ আপলোড করার সময় Gradle-এ ঘোষিত Google-এর লাইব্রেরি নির্ভরতার সংগ্রহ থেকে পৃথক এবং স্বাধীন।

আপনার প্রোজেক্টে Play Core Native SDK ইন্টিগ্রেট করার পর, API কল ধারণকারী ফাইলগুলিতে নিম্নলিখিত লাইনটি অন্তর্ভুক্ত করুন:

পর্যালোচনা অন্তর্ভুক্ত করুন।

আপনার প্রোজেক্টে Play Core Native SDK ইন্টিগ্রেট করার পর, API কল ধারণকারী ফাইলগুলিতে নিম্নলিখিত লাইনটি অন্তর্ভুক্ত করুন:

#include "play/review.h"

পর্যালোচনা API আরম্ভ করুন

যখনই আপনি API ব্যবহার করতে চান, আপনাকে প্রথমে ReviewManager_init ফাংশনটি কল করে এটি শুরু করতে হবে, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে যা android_native_app_glue.h দিয়ে তৈরি করা হয়েছে:

void android_main(android_app* app) {
  app->onInputEvent = HandleInputEvent;

  ReviewErrorCode error_code = ReviewManager_init(app->activity->vm, app->activity->clazz);
  if (error_code == REVIEW_NO_ERROR) {
    // You can use the API.
  }
}

অ্যাপ-মধ্যস্থ পর্যালোচনা প্রবাহের অনুরোধ করুন

আপনার অ্যাপের ব্যবহারকারী প্রবাহের ভালো দিকগুলি নির্ধারণ করার জন্য অ্যাপ-মধ্যস্থ পর্যালোচনার অনুরোধ করার সময় নির্দেশিকা অনুসরণ করুন যাতে ব্যবহারকারীকে পর্যালোচনার জন্য অনুরোধ করা যায় (উদাহরণস্বরূপ, কোনও ব্যবহারকারী কোনও গেমের স্তরের শেষে সারাংশ স্ক্রিনটি বাতিল করার পরে)। যখন আপনার অ্যাপ এই পয়েন্টগুলির একটির কাছাকাছি চলে যায়, তখন অ্যাপ-মধ্যস্থ পর্যালোচনা প্রবাহ চালু করার জন্য আপনার অ্যাপের প্রয়োজনীয় তথ্য অ্যাসিঙ্ক্রোনাসভাবে অনুরোধ করতে ReviewManager_requestReviewFlow এ কল করুন। ReviewManager_getReviewStatus কল করে ReviewManager_requestReviewFlow অপারেশনের অগ্রগতি পর্যবেক্ষণ করুন, উদাহরণস্বরূপ প্রতি ফ্রেমে একবার। এতে কয়েক সেকেন্ড সময় লাগতে পারে, তাই আপনার অ্যাপটি অ্যাপ-মধ্যস্থ পর্যালোচনা প্রবাহ দেখানোর সময় পৌঁছানোর আগে এই প্রক্রিয়াটি শুরু করা উচিত।

ReviewErrorCode error_code = ReviewManager_requestReviewFlow();
if (error_code == REVIEW_NO_ERROR) {
    // The request has successfully started, check the status using
    // ReviewManager_getReviewStatus.
} else {
    // Error such as REVIEW_PLAY_STORE_NOT_FOUND indicating that the in-app
    // review isn't currently possible.
}

স্ট্যাটাসগুলি পরিচালনা করুন এবং অ্যাপ-মধ্যস্থ পর্যালোচনা প্রবাহ চালু করুন

যখনই কোনও অনুরোধ শুরু হয় বা অ্যাপ-মধ্যস্থ পর্যালোচনা প্রবাহ চালু হয়, তখন আপনি ReviewManager_getReviewStatus ব্যবহার করে স্থিতি পরীক্ষা করতে পারেন। এটি আপনাকে API স্থিতির উপর নির্ভর করে লজিক সংজ্ঞায়িত করতে দেয়। এটি করার একটি উপায় হল স্ট্যাটাসটিকে একটি গ্লোবাল ভেরিয়েবল হিসাবে রাখা এবং ব্যবহারকারী যখন একটি নির্দিষ্ট ক্রিয়া সম্পাদন করে (উদাহরণস্বরূপ, একটি গেমে "পরবর্তী স্তর" বোতামে ট্যাপ করা), তখন স্থিতিটি REVIEW_REQUEST_FLOW_COMPLETED কিনা তা পরীক্ষা করা, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:

ReviewStatus status;
ReviewErrorCode error_code = ReviewManager_getReviewStatus(&status);
if (error_code != REVIEW_NO_ERROR) {
    // There was an error with the most recent operation.
    return;
}

switch (status) {
    case REVIEW_REQUEST_FLOW_PENDING:
        // Request is ongoing. The flow can't be launched yet.
        break;
    case REVIEW_REQUEST_FLOW_COMPLETED:
        // Request completed. The flow can be launched now.
        break;
    case REVIEW_LAUNCH_FLOW_PENDING:
        // The review flow is ongoing, meaning the dialog might be displayed.
        break;
    case REVIEW_LAUNCH_FLOW_COMPLETED:
        // The review flow has finished. Continue with your app flow (for
        // example, move to the next screen).
        break;
    default:
        // Unknown status.
        break;
}

যখন স্থিতি REVIEW_REQUEST_FLOW_COMPLETED হয় এবং আপনার অ্যাপ প্রস্তুত থাকে, তখন অ্যাপ-মধ্যস্থ পর্যালোচনা প্রবাহ চালু করুন:

// This call uses android_native_app_glue.h.
ReviewErrorCode error_code = ReviewManager_launchReviewFlow(app->activity->clazz);
if (error_code != REVIEW_NO_ERROR) {
    // There was an error while launching the flow.
    return;
}

ইন-অ্যাপ রিভিউ ফ্লো চালু করার পর, সম্পূর্ণতার স্থিতি পরীক্ষা করতে থাকুন এবং আপনার অ্যাপ ফ্লো চালিয়ে যান। এটি পরিচালনা করার একটি সাধারণ উপায় হল গেম লুপ প্যাটার্ন অনুসরণ করা।

বিনামূল্যের সম্পদ

আপনার অ্যাপটি API ব্যবহার শেষ করার পরে (উদাহরণস্বরূপ, অ্যাপ-মধ্যস্থ পর্যালোচনা প্রবাহ সম্পন্ন হওয়ার পরে) ReviewManager_destroy ফাংশনে কল করে রিসোর্স মুক্ত করতে ভুলবেন না।

void ReviewManager_destroy();

পরবর্তী পদক্ষেপ

আপনার ইন্টিগ্রেশন সঠিকভাবে কাজ করছে কিনা তা যাচাই করতে আপনার অ্যাপের ইন-অ্যাপ পর্যালোচনা প্রবাহ পরীক্ষা করুন ।