এই নির্দেশিকায় ইউনিটি ব্যবহার করে আপনার অ্যাপে কীভাবে ইন-অ্যাপ রিভিউ যুক্ত করবেন তা বর্ণনা করা হয়েছে। আপনি যদি কোটলিন বা জাভা , নেটিভ কোড বা আনরিয়েল ইঞ্জিন ব্যবহার করেন, তার জন্য আলাদা ইন্টিগ্রেশন নির্দেশিকা রয়েছে।
ইউনিটি এসডিকে ওভারভিউ
প্লে ইন-অ্যাপ রিভিউ এপিআই হলো প্লে কোর এসডিকে পরিবারের একটি অংশ। ইউনিটির জন্য এই এপিআই-তে একটি ReviewManager ক্লাস রয়েছে, যা RequestReviewFlow এবং LaunchReviewFlow মেথড ব্যবহার করে ফ্লো-এর জন্য অনুরোধ করতে ও তা চালু করতে ব্যবহৃত হয়। অনুরোধ করার পর, আপনার অ্যাপ ReviewErrorCode ব্যবহার করে অনুরোধটির অবস্থা যাচাই করতে পারে।
আপনার উন্নয়ন পরিবেশ সেট আপ করুন
ওপেনইউপিএম-সিএলআই
আপনার যদি OpenUPM CLI ইনস্টল করা থাকে, তাহলে আপনি নিম্নলিখিত কমান্ডটি ব্যবহার করে OpenUPM রেজিস্ট্রি ইনস্টল করতে পারেন:
openupm add com.google.play.reviewওপেনইউপিএম
ইউনিটি মেনু অপশন Edit > Project Settings > Package Manager নির্বাচন করে প্যাকেজ ম্যানেজার সেটিংস খুলুন।
প্যাকেজ ম্যানেজার উইন্ডোতে OpenUPM-কে একটি স্কোপড রেজিস্ট্রি হিসেবে যুক্ত করুন:
Name: package.openupm.com URL: https://package.openupm.com Scopes: com.google.external-dependency-manager com.google.play.common com.google.play.core com.google.play.reviewইউনিটি মেনু অপশন Window > Package Manager নির্বাচন করে প্যাকেজ ম্যানেজার মেনুটি খুলুন।
ম্যানেজার স্কোপ ড্রপ-ডাউন থেকে 'আমার রেজিস্ট্রি' নির্বাচন করুন।
প্যাকেজ তালিকা থেকে ইউনিটির জন্য গুগল প্লে ইন্টিগ্রিটি প্লাগইন প্যাকেজটি নির্বাচন করুন এবং ইনস্টল চাপুন।
গিটহাব থেকে আমদানি করুন
গিটহাব থেকে সর্বশেষ
.unitypackageরিলিজটি ডাউনলোড করুন।ইউনিটি মেনু অপশন Assets > Import package > Custom Package নির্বাচন করে সমস্ত আইটেম ইম্পোর্ট করার মাধ্যমে
.unitypackageফাইলটি ইম্পোর্ট করুন।
রিভিউম্যানেজার তৈরি করুন
ReviewManager এর একটি ইনস্ট্যান্স তৈরি করুন যা আপনার অ্যাপ এবং গুগল প্লে এপিআই-এর মধ্যে যোগাযোগ পরিচালনা করবে।
using Google.Play.Review;
// Create instance of ReviewManager
private ReviewManager _reviewManager;
// ...
_reviewManager = new ReviewManager();
একটি ReviewInfo অবজেক্টের জন্য অনুরোধ করুন
আপনার অ্যাপের ইউজার ফ্লো-এর ভালো দিকগুলো চিহ্নিত করতে এবং ব্যবহারকারীকে রিভিউ দেওয়ার জন্য অনুরোধ জানাতে (উদাহরণস্বরূপ, কোনো গেমের একটি লেভেলের শেষে ব্যবহারকারী সামারি স্ক্রিনটি বন্ধ করে দেওয়ার পর) কখন ইন-অ্যাপ রিভিউয়ের জন্য অনুরোধ করতে হবে, সেই সংক্রান্ত নির্দেশিকা অনুসরণ করুন। যখন আপনার অ্যাপ এই ধরনের কোনো একটি দিকের কাছাকাছি পৌঁছাবে, তখন ReviewManager ইনস্ট্যান্সটি ব্যবহার করে একটি অ্যাসিঙ্ক অপারেশন তৈরি করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:
var requestFlowOperation = _reviewManager.RequestReviewFlow();
yield return requestFlowOperation;
if (requestFlowOperation.Error != ReviewErrorCode.NoError)
{
// Log error. For example, using requestFlowOperation.Error.ToString().
yield break;
}
_playReviewInfo = requestFlowOperation.GetResult();
কলটি সফল হলে, এপিআইটি PlayReviewInfo অবজেক্টটি রিটার্ন করে, যা আপনার অ্যাপের ইন-অ্যাপ রিভিউ ফ্লো চালু করার জন্য প্রয়োজন। উদাহরণটিতে, অ্যাসিঙ্ক অপারেশনটি সম্পাদন করার জন্য কলটি একটি কো-রুটিনের ভিতরে করা হয়েছে (এটি মেইন থ্রেডকে ব্লক করে না)। যেহেতু কলটি অ্যাসিঙ্ক্রোনাসভাবে করা হয়, তাই এতে কয়েক সেকেন্ড পর্যন্ত সময় লাগতে পারে, সুতরাং আপনার অ্যাপের ইউজার ফ্লো-এর সেই পর্যায়ে পৌঁছানোর আগেই কলটি করা উচিত যেখানে আপনি ইন-অ্যাপ রিভিউ দেখাতে চান।
অ্যাপের মধ্যে পর্যালোচনা প্রক্রিয়াটি চালু করুন
আপনার অ্যাপ PlayReviewInfo ইনস্ট্যান্সটি পাওয়ার পর, এটি ইন-অ্যাপ রিভিউ ফ্লো চালু করতে পারে। মনে রাখবেন যে PlayReviewInfo অবজেক্টটি শুধুমাত্র সীমিত সময়ের জন্য বৈধ থাকে, তাই আপনার অ্যাপের ফ্লো চালু করার আগে খুব বেশি সময় অপেক্ষা করা উচিত নয়।
var launchFlowOperation = _reviewManager.LaunchReviewFlow(_playReviewInfo);
yield return launchFlowOperation;
_playReviewInfo = null; // Reset the object
if (launchFlowOperation.Error != ReviewErrorCode.NoError)
{
// Log error. For example, using launchFlowOperation.Error.ToString().
yield break;
}
// 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.
পরবর্তী পদক্ষেপ
আপনার ইন্টিগ্রেশনটি সঠিকভাবে কাজ করছে কিনা তা যাচাই করতে আপনার অ্যাপের ইন-অ্যাপ রিভিউ ফ্লো পরীক্ষা করুন ।