ইন-অ্যাপ আপডেট (Unreal Engine) সংক্রান্ত সহায়তা

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

Unreal Engine SDK ওভারভিউ

Play In-App Updates API হল Play Core SDK ফ্যামিলির অংশ। Unreal Engine-এর API, আপনার অ্যাপ ও Play API-এর মধ্যে যোগাযোগ ম্যানেজ করার জন্য UInAppUpdatesManager ক্লাস অফার করে। অনুরোধ করা হয়ে গেলে, আপনার অ্যাপ EAppUpdateErrorCode ব্যবহার করে অনুরোধের স্ট্যাটাস চেক করতে পারবে।

Unreal Engine-এর যেসব ভার্সন কাজ করে

প্লাগ-ইনটি Unreal Engine 5.0 এবং পরবর্তী সব ভার্সনে কাজ করে।

আপনার ডেভেলপমেন্ট এমভায়রনমেন্ট সেট-আপ করুন

  1. GitHub রিপোজিটরি থেকে Play Unreal Engine প্লাগ-ইন ডাউনলোড করুন।

  2. আপনার Unreal Engine প্রোজেক্টের Plugins ফোল্ডারের মধ্যে GooglePlay ফোল্ডারটি কপি করুন।

  3. আপনার Unreal Engine প্রোজেক্ট খুলুন এবং এডিট করুন → প্লাগ-ইন বিকল্পে ক্লিক করুন।

  4. Google Play সার্চ করে চালু করা আছে চেকবক্সে টিকচিহ্ন দিন।

  5. গেম প্রোজেক্ট রিস্টার্ট করে বিল্ড ট্রিগার করুন।

  6. আপনার প্রোজেক্টের Build.cs ফাইল খুলুন এবং PlayInAppUpdates মডিউলটি PublicDependencyModuleNames-এ যোগ করুন:

    using UnrealBuildTool;
    
    public class MyGame : ModuleRules
    {
      public MyGame(ReadOnlyTargetRules Target) : base(Target)
      {
        // ...
    
        PublicDependencyModuleNames.Add("PlayInAppUpdates");
    
        // ...
      }
    }
    

আপডেট উপলভ্য আছে কিনা তা চেক করুন

আপডেটের অনুরোধ করার আগে, আপনার অ্যাপের জন্য কোনও আপডেট উপলভ্য আছে কিনা তা চেক করুন। আপডেট চেক করতে UInAppUpdatesManager::RequestInfo ব্যবহার করুন:

MyClass.h

void MyClass::OnRequestInfoOperationCompleted(
  EAppUpdateErrorCode ErrorCode,
  UAppUpdateInfo* UpdateInfo)
{
  // Check the resulting error code.
  if (ErrorCode == EAppUpdateErrorCode::AppUpdate_NO_ERROR)
  {
    // Check AppUpdateInfo's UpdateAvailability, UpdatePriority,
    // IsUpdateTypeAllowed(), ... and decide whether to ask the user
    // to start an in-app update.
  }
}

MyClass.cpp

void MyClass::CheckForUpdateAvailability()
{
  // Create a delegate to bind the callback function.
  FRequestInfoOperationCompletedDelegate Delegate;

  // Bind the completion handler (OnRequestInfoOperationCompleted) to the delegate.
  Delegate.BindDynamic(this, &MyClass::OnRequestInfoOperationCompleted);

  // Initiate the request info operation, passing the delegate to handle the result.
  GetGameInstance()
    ->GetSubsystem<UInAppUpdatesManager>()
    ->RequestInfo(Delegate);
}

ফেরত আসা UAppUpdateInfo ইনস্ট্যান্সে আপডেট উপলভ্যতার স্ট্যাটাস থাকে। ইন-অ্যাপ আপডেট আগে থেকেই প্রসেসে থাকলে, ইনস্ট্যান্সটি প্রসেসে থাকা আপডেটের স্ট্যাটাসও রিপোর্ট করে।

আপডেট বাসি হয়ে গেছে কিনা তা চেক করুন

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

Play Store-এর মাধ্যমে আপডেট উপলভ্য হওয়ার পর থেকে কত দিন হয়েছে তা চেক করতে UAppUpdateInfo:GetClientVersionStalenessDays ব্যবহার করুন:

int32 ClientVersionStalenessDays = UpdateInfo->GetClientVersionStalenessDays();

আপডেটের অগ্রাধিকার চেক করুন

Google Play Developer API আপনাকে প্রতিটি আপডেটের অগ্রাধিকার সেট করতে দেয়। এটি আপনার অ্যাপকে ব্যবহারকারীর কাছে কোনও আপডেট কতটা জোরালোভাবে সাজেস্ট করতে হবে তা সিদ্ধান্ত নিতে দেয়। যেমন, আপডেট প্রায়োরিটি সেট করার জন্য নিম্নলিখিত স্ট্র্যাটেজি বিবেচনা করুন:

  • UI-তে ছোটখাটো উন্নতি: কম-অগ্রাধিকার আপডেট; ফ্লেক্সিবল আপডেট বা অবিলম্বে আপডেট করার অনুরোধ করে না।
  • পারফর্ম্যান্সের উন্নতি: মাঝারি-অগ্রাধিকার আপডেট; একটি নমনীয় আপডেটের অনুরোধ করুন।
  • গুরুত্বপূর্ণ নিরাপত্তা আপডেট: উচ্চ-অগ্রাধিকার আপডেট; অবিলম্বে আপডেট করার অনুরোধ করুন।

অগ্রাধিকার নির্ধারণ করতে, Google Play ০ থেকে ৫-এর মধ্যে একটি পূর্ণসংখ্যা ব্যবহার করে, যেখানে ০ ডিফল্ট এবং ৫ হল সর্বোচ্চ অগ্রাধিকার। আপডেটের জন্য অগ্রাধিকার সেট করতে, Google Play Developer API-তে Edits.tracks.releases-এর অধীনে inAppUpdatePriority ফিল্ড ব্যবহার করুন। রিলিজে নতুন যোগ করা সব ভার্সন রিলিজের মতোই একই অগ্রাধিকারের বলে বিবেচনা করা হয়। নতুন রিলিজ রোল-আউট করার সময় অগ্রাধিকার সেট করা যায় এবং পরে তা পরিবর্তন করা যায় না।

Play Developer API ডকুমেন্টেশনে যেভাবে বর্ণনা করা হয়েছে সেই অনুযায়ী Google Play Developer API ব্যবহার করে অগ্রাধিকার সেট করুন। অ্যাপ-মধ্যস্থ আপডেট সংক্রান্ত অগ্রাধিকার Edit.tracks: update পদ্ধতিতে পাস করা Edit.tracks রিসোর্সে উল্লেখ করতে হবে। নিম্নলিখিত উদাহরণে ভার্সন কোড ৮৮ ও inAppUpdatePriority ৫ সহ অ্যাপ রিলিজ করার পদ্ধতি দেখানো হয়েছে:

{
  "releases": [{
      "versionCodes": ["88"],
      "inAppUpdatePriority": 5,
      "status": "completed"
  }]
}

আপনার অ্যাপের কোডে, আপনি UAppUpdateInfo::UpdatePriority ব্যবহার করে কোনও নির্দিষ্ট আপডেটের জন্য অগ্রাধিকার লেভেল চেক করতে পারেন:

int32 Priority = UpdateInfo->GetPriority();

আপডেট শুরু করুন

আপডেট উপলভ্য আছে বলে কনফার্ম করার পরে, আপনি UInAppUpdatesManager::StartUpdate ব্যবহার করে আপডেটের জন্য অনুরোধ করতে পারবেন। আপডেটের অনুরোধ করার আগে, আপনার কাছে আপ-টু-ডেট UAppUpdateInfo অবজেক্ট আছে কিনা তা নিশ্চিত করুন। আপডেট ফ্লো কনফিগার করতে আপনাকে একটি UAppUpdateOptions অবজেক্ট তৈরি করতে হবে।

নিম্নলিখিত উদাহরণটি অবিলম্বে আপডেট ফ্লোয়ের জন্য একটি UAppUpdateOptions অবজেক্ট তৈরি করে:

// Creates an UAppUpdateOptions defining an immediate in-app
// update flow and its parameters.
UAppUpdateOptions* Options = NewObject<UAppUpdateOptions>();
Options->CreateOptions(EAppUpdateType::AppUpdate_TYPE_IMMEDIATE);

নিম্নলিখিত উদাহরণটি একটি ফ্লেক্সিবল আপডেট ফ্লোয়ের জন্য একটি UAppUpdateOptions অবজেক্ট তৈরি করে:

// Creates an UAppUpdateOptions defining a flexible in-app
// update flow and its parameters.
UAppUpdateOptions* Options = NewObject<UAppUpdateOptions>();
Options->CreateOptions(EAppUpdateType::AppUpdate_TYPE_FLEXIBLE);

UAppUpdateOptions অবজেক্টে একটি IsAssetPackDeletionAllowed ফাংশনও থাকে যা ডিভাইস স্টোরেজ সীমিত হলে আপডেটটি অ্যাসেট প্যাক মুছে ফেলার অনুমতি দেয় কিনা তা রিটার্ন করে। এই ফিল্ডটি ডিফল্ট হিসেবে false-এ সেট করা আছে, তবে আপনি UAppUpdateOptions::SetAssetPackDeletionAllowed ব্যবহার করে ফিল্ডটি সেট করতে পারেন পরিবর্তে এটি true-এ সেট করতে:

// Sets the AssetPackDeletionAllowed field to true.
Options->SetAssetPackDeletionAllowed(true);

আপনি ফ্লেক্সিবল আপডেট নাকি ইমিডিয়েট আপডেট-এর অনুরোধ করছেন তার উপর পরবর্তী ধাপগুলি নির্ভর করে।

ফ্লেক্সিবল আপডেট ম্যানেজ করা

আপনার কাছে আপ-টু-ডেট UAppUpdateInfo অবজেক্ট এবং সঠিকভাবে কনফিগার করা UAppUpdateOptions অবজেক্ট থাকলে, আপনি আপডেট ফ্লোর অনুরোধ করতে UInAppUpdatesManager::StartUpdate-এ কল করতে পারেন।

MyClass.h

void MyClass::OnStartUpdateOperationCompleted(EAppUpdateErrorCode ErrorCode)
{
  // ...
}

MyClass.cpp

// .cpp
void MyClass::StartUpdate()
{
  // Create a delegate to bind the callback function.
  FUpdateOperationCompletedDelegate Delegate;

  // Bind the completion handler (OnStartUpdateOperationCompleted) to the delegate.
  Delegate.BindDynamic(this, &MyClass::OnStartUpdateOperationCompleted);

  // Initiate the start update operation, passing the delegate to handle the result.
  GetGameInstance()
    ->GetSubsystem<UInAppUpdatesManager>()
    ->StartUpdate(UpdateInfo, UpdateOptions, Delegate);
}

ফ্লেক্সিবল আপডেট ফ্লোয়ের জন্য, ডাউনলোড সম্পূর্ণ হওয়ার পরে আপনাকে অ্যাপ আপডেট ইনস্টল করার প্রক্রিয়া ট্রিগার করতে হবে। এটি করতে, নিম্নলিখিত উদাহরণের মতো InAppUpdatesManager::CompleteUpdate-কে কল করুন:

MyClass.h

void MyClass::OnCompleteUpdateOperationCompleted(EAppUpdateErrorCode ErrorCode)
{
  // ...
}

MyClass.cpp

void MyClass::CompleteFlexibleUpdate()
{
  // Create a delegate to bind the callback function.
  FUpdateOperationCompletedDelegate Delegate;

  // Bind the completion handler (OnCompleteUpdateOperationCompleted) to the delegate.
  Delegate.BindDynamic(this, &MyClass::OnCompleteUpdateOperationCompleted);

  // Initiate the complete update operation, passing the delegate to handle the result.
  GetGameInstance()
    ->GetSubsystem<UInAppUpdatesManager>()
    ->CompleteUpdate(UpdateInfo, UpdateOptions, Delegate);
}

অবিলম্বে আপডেট ম্যানেজ করা

আপনার কাছে আপ-টু-ডেট UAppUpdateInfo অবজেক্ট এবং সঠিকভাবে কনফিগার করা UAppUpdateOptions অবজেক্ট থাকলে, আপনি আপডেট ফ্লোর অনুরোধ করতে InAppUpdatesManager::StartUpdate-এ কল করতে পারেন।

MyClass.h

void MyClass::OnStartUpdateOperationCompleted(EAppUpdateErrorCode ErrorCode)
{
  // ...
}

MyClass.cpp

void MyClass::StartUpdate()
{
  // Create a delegate to bind the callback function.
  FUpdateOperationCompletedDelegate Delegate;

  // Bind the completion handler (OnStartUpdateOperationCompleted) to the delegate.
  Delegate.BindDynamic(this, &MyClass::OnStartUpdateOperationCompleted);

  // Initiate the start update operation, passing the delegate to handle the result.
  GetGameInstance()
    ->GetSubsystem<UInAppUpdatesManager>()
    ->StartUpdate(UpdateInfo, UpdateOptions, Delegate);
}

অবিলম্বে আপডেট করার ফ্লোয়ের জন্য, Google Play ব্যবহারকারীর কনফার্মেশন ডায়ালগ দেখায়। ব্যবহারকারী অনুরোধ গ্রহণ করলে, Google Play অটোমেটিক আপডেট ডাউনলোড ও ইনস্টল করে, তারপর ইনস্টলেশন সম্পূর্ণ হলে আপডেট করা ভার্সনে অ্যাপ রিস্টার্ট করে।

সমস্যা ম্যানেজ করা

এই বিভাগে সাধারণ সমস্যার সমাধান বর্ণনা করা হয়েছে।

  • UInAppUpdatesManager::StartUpdate-এর থেকে AppUpdate_INVALID_REQUEST সমস্যা দেখালে, এর অর্থ হল UAppUpdateInfo সঠিক নয়। আপডেট ফ্লো শুরু করার আগে, UInAppUpdatesManager::RequestInfo থেকে রিটার্ন করা UAppUpdateInfo অবজেক্টটি নাল নয় তা নিশ্চিত করুন।
  • UInAppUpdatesManager::StartUpdate যদি AppUpdate_NOT_ALLOWED সমস্যা দেখায়, তাহলে বুঝতে হবে যে UAppUpdateOptions অবজেক্ট এমন একটি আপডেট টাইপ নির্দেশ করছে যা উপলভ্য আপডেটের জন্য অনুমোদিত নয়। আপডেট ফ্লো শুরু করার আগে UAppUpdateInfo অবজেক্টটি বেছে নেওয়া আপডেটের ধরন অনুমোদিত কিনা তা নির্দেশ করে কিনা তা চেক করুন।

পরবর্তী ধাপ

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