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

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

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

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

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

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

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

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

   • অ্যান্ড্রয়েড স্টুডিও সংস্করণ 4.0 বা উচ্চতর ইনস্টল করুন। Android SDK প্ল্যাটফর্ম সংস্করণ 10.0 (API স্তর 29) ইনস্টল করতে SDK ম্যানেজার UI ব্যবহার করুন।
   • Android SDK কমান্ড-লাইন টুলগুলি ইনস্টল করুন এবং Android SDK প্ল্যাটফর্ম সংস্করণ 10.0 (API স্তর 29) ইনস্টল করতে sdkmanager ব্যবহার করুন৷

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

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

   ডাউনলোড লিংক	আকার	SHA-256 চেকসাম
   play-core-native-sdk-1.15.3.zip	37.8 MiB	9db60185185342f28d2c278b60222333608c67bc022e458a25224eaea8c4c4b7

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.2.2'
           implementation 'com.google.android.play:integrity:1.4.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.2.2")
       implementation("com.google.android.play:integrity:1.4.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-এর সংস্করণ চালান

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

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

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

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

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

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

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

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