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

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

নেটিভ এসডিকে ওভারভিউ

প্লে কোর নেটিভ এসডিকে হলো গুগল প্লে কোর লাইব্রেরি পরিবারের একটি অংশ। প্লে কোর নেটিভ এসডিকে-তে review.h একটি সি হেডার ফাইল অন্তর্ভুক্ত রয়েছে, যা জাভা প্লে ইন-অ্যাপ রিভিউ লাইব্রেরির ReviewManager র‍্যাপ করে। এই হেডার ফাইলটি আপনার অ্যাপকে নেটিভ কোড থেকে সরাসরি এপিআই কল করার সুযোগ দেয়। উপলব্ধ পাবলিক ফাংশনগুলোর একটি সার্বিক ধারণা পেতে, প্লে রিভিউ নেটিভ মডিউলের ডকুমেন্টেশন দেখুন।

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

request এবং launch উভয় ফাংশনই সফল হলে REVIEW_NO_ERROR রিটার্ন করে।

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

1. নিম্নলিখিতগুলির মধ্যে যেকোনো একটি করুন:

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

2. এসডিকে ম্যানেজার ব্যবহার করে সর্বশেষ সিমেক (CMake) এবং অ্যান্ড্রয়েড নেটিভ ডেভেলপমেন্ট কিট (এনডিকে) ইনস্টল করে নেটিভ ডেভেলপমেন্টের জন্য অ্যান্ড্রয়েড স্টুডিও প্রস্তুত করুন। নেটিভ প্রজেক্ট তৈরি বা ইম্পোর্ট করার বিষয়ে আরও তথ্যের জন্য, এনডিকে দিয়ে শুরু করা (Getting Started with the NDK ) দেখুন।

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

   ডাউনলোড লিঙ্ক	আকার	SHA-256 চেকসাম
   play-core-native-sdk-1.16.0.zip	৫৪.৮ এমআইবি	008b8fedc6179a6dc6ccc21af75591afc7036f78f3d5559d844f1b923934fef0

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.6.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.6.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
           ...)
   

তথ্য সংগ্রহ

গুগলকে পণ্যটির উন্নতি সাধনে সহায়তা করার জন্য প্লে কোর নেটিভ এসডিকে সংস্করণ-সম্পর্কিত ডেটা সংগ্রহ করতে পারে, যার মধ্যে অন্তর্ভুক্ত রয়েছে:

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

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

উল্লেখ্য, আপনার প্লে কোর নেটিভ এসডিকে ব্যবহারের সাথে সম্পর্কিত এই ডেটা সংগ্রহ এবং সংগৃহীত ডেটার উপর গুগলের ব্যবহার, প্লে কনসোলে আপনার অ্যাপ প্যাকেজ আপলোড করার সময় গ্রেডলে ঘোষিত লাইব্রেরি নির্ভরতা সংগ্রহের থেকে পৃথক ও স্বাধীন।

আপনার প্রোজেক্টে প্লে কোর নেটিভ এসডিকে ইন্টিগ্রেট করার পর, যে ফাইলগুলিতে এপিআই কল রয়েছে, সেগুলিতে নিম্নলিখিত লাইনটি অন্তর্ভুক্ত করুন:

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

আপনার প্রোজেক্টে প্লে কোর নেটিভ এসডিকে ইন্টিগ্রেট করার পর, যে ফাইলগুলিতে এপিআই কল থাকবে, সেগুলিতে নিম্নলিখিত লাইনটি অন্তর্ভুক্ত করুন:

#include "play/review.h"

রিভিউ এপিআই শুরু করুন

যখনই আপনি 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_requestReviewFlow অপারেশনের অগ্রগতি নিরীক্ষণ করতে, উদাহরণস্বরূপ প্রতি ফ্রেমে একবার, ReviewManager_getReviewStatus কল করুন। এতে কয়েক সেকেন্ড পর্যন্ত সময় লাগতে পারে, তাই আপনার অ্যাপ যখন ইন-অ্যাপ রিভিউ ফ্লো দেখাতে চায়, সেই পর্যায়ে পৌঁছানোর আগেই এই প্রক্রিয়াটি শুরু করা উচিত।

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();

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

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