Play Games PC SDK ব্যবহার করে আপনার গেমকে শক্তিশালী করুন

Play Games PC SDK-এর মাধ্যমে আপনি পিসিতে আপনার গেম তৈরি এবং নগদীকরণ করতে Google Play পরিষেবাগুলি অ্যাক্সেস করতে পারেন। Play বিলিং ব্যবহার করে ডিজিটাল সামগ্রী বিক্রি করুন, Play Games ব্যবহার করে নির্বিঘ্নে সাইন-ইন করুন এবং নিশ্চিত করুন যে আপনার ব্যবহারকারীদের Play Integrity-এর সাথে আপনার অ্যাপ্লিকেশনের বৈধ এনটাইটেলমেন্ট আছে।

শুরু করতে প্রস্তুত?

পূর্বশর্ত

  • প্লে কনসোলের ভিতরে একটি অ্যাপ এন্ট্রি তৈরি করুন এবং একটি প্লে প্যাকেজ নাম দাবি করুন।

  • পিসির জন্য Google Play গেমস ডাউনলোড এবং ইনস্টল করুন এবং আপনার Google অ্যাকাউন্ট দিয়ে সাইন ইন করুন৷

ধাপ 1 : আপনার প্রকল্পে SDK যোগ করুন

  • Play Games PC C++ SDK ডাউনলোড করুন।

  • আপনার অ্যাপ্লিকেশনের কোডবেসে API শিরোনাম ফোল্ডার includes/ কপি করুন।

  • আপনার অ্যাপ্লিকেশনের প্রকল্পে imports/ থেকে পুনরায় বিতরণযোগ্য ফাইলগুলি অনুলিপি করুন।

    • play_pc_sdk.dll এর বিষয়বস্তু অ্যাক্সেস করার অনুমতি দিয়ে play_pc_sdk.lib এর সাথে আপনার প্রজেক্ট লিঙ্ক করুন।

ধাপ 2 : একটি ম্যানিফেস্ট ফাইল যোগ করুন

আপনি আপনার গেমের মধ্যে থেকে SDK ব্যবহার করার আগে আপনাকে প্লে কনসোলের ভিতরে যে প্লে প্যাকেজ নামের দাবি করেছেন তার সাথে এক্সিকিউটেবল গেমটিকে যুক্ত করতে হবে। আপনার গেমের এক্সিকিউটেবল একই ডিরেক্টরিতে একটি manifest.xml ফাইল যোগ করে এটি করা হয়েছে।

manifest.xml বিষয়বস্তুর উদাহরণ:

<?xml version="1.0" encoding="utf-8"?>
<Manifest version="1">
    <Application>
        <PackageName>com.example.package</PackageName>
    </Application>
</Manifest>

manifest.xml প্লেসমেন্টের উদাহরণ:

C:\Program Files
└───Example Game
    ├───Game.exe
    └───manifest.xml

ধাপ 3 : ডিজিটালভাবে আপনার গেম সাইন ইন করুন

আপনার গেমটি SDK ব্যবহার করার আগে, গেমটির এক্সিকিউটেবলকে অবশ্যই একটি প্রমাণীকৃত ডিজিটাল স্বাক্ষর ব্যবহার করে ডিজিটালভাবে স্বাক্ষর করতে হবে। কিভাবে একটি এক্সিকিউটেবল সাইন ইন করবেন তার নির্দেশাবলীর জন্য SignTool-এ ডকুমেন্টেশন দেখুন।

ধাপ 4 : SDK শুরু করুন

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

API শুরু করতে GooglePlayInitialize কল করে SDK ব্যবহার শুরু করুন। এটি গ্লোবাল স্টেট সেটআপ করবে, SDK রানটাইমের সাথে সংযোগ করবে এবং অ্যাপ্লিকেশনটি সঠিকভাবে শুরু হয়েছে তা যাচাই করবে। এটিকে অবশ্যই কল করতে হবে এবং অন্য কোনো API ব্যবহার করার আগে InitializeResult::ok() সমান true সাথে ধারাবাহিকতা কলব্যাক সম্পূর্ণ করতে হবে।

// Initialize the SDK as part of the startup sequence of your application.
auto promise = std::make_shared<std::promise<InitializeResult>>();
GooglePlayInitialize(
  [promise](InitializeResult result) {
    promise->set_value(std::move(result));
  });

auto initialize_result = promise->get_future().get();
if (initialize_result.ok()) {
  // The SDK succeeded with initialization. Continue with the startup sequence
  // of the game.
  // ...
} else if (initialize_result.code() == InitializationError::kActionRequiredShutdownClientProcess) {
  // The SDK failed to initialize and has requested that your game process exit
  // as soon as possible.
  exit(1);
} else {
  // The SDK failed to initialize for an alternative reason. It is still
  // generally recommended that you exit the game process as soon as possible,
  // because it won't be possible to access any APIs in the SDK. Critical
  // operations such as verifying the user owns a valid license to your game
  // won't be possible.
  // ...
}

kActionRequiredShutdownClientProcess কোডের সাথে আরম্ভ করা ব্যর্থ হলে যত তাড়াতাড়ি সম্ভব গেম প্রক্রিয়া থেকে প্রস্থান করুন । SDK-এর রানটাইম ব্যবহারকারীকে সাহায্য করার চেষ্টা করবে আপনার গেমের জন্য কোন অতিরিক্ত পদক্ষেপের প্রয়োজন নেই। উদাহরণস্বরূপ ব্যবহারকারীর যদি গেমটির বৈধ লাইসেন্স না থাকে তবে Google Play Games ব্যবহারকারীকে একটি অনুলিপি কেনার জন্য অনুরোধ করবে। অন্যান্য ত্রুটির জন্য এখনও যত তাড়াতাড়ি সম্ভব গেমের প্রক্রিয়া থেকে প্রস্থান করার পরামর্শ দেওয়া হচ্ছে কারণ ব্যবহারকারী আপনার গেমের বৈধ লাইসেন্সের মালিক কিনা তা যাচাই করার মতো গুরুত্বপূর্ণ ক্রিয়াকলাপগুলি সম্পাদন করতে SDK ব্যবহার করবে না৷

একটি অ-সফল প্রতিক্রিয়া নিম্নলিখিত শর্তগুলির মধ্যে একটি নির্দেশ করতে পারে:

  • SDK রানটাইম ইনস্টল করা নেই, ডিভাইসে চলছে না বা আপনার গেমে সংহত SDK-এর সাথে সামঞ্জস্যপূর্ণ নয় এমন একটি পুরানো সংস্করণ।

  • SDK রানটাইম গেমটির অ্যাপ্লিকেশন পরিচয় যাচাই করতে অক্ষম ছিল৷ এটি একটি অবৈধ manifest.xml বা বিকাশের সময় বিকাশকারী মোড সক্ষম না করে SDK ব্যবহার করার কারণে হতে পারে৷ এটি ছাড়া আপনার গেমের এক্সিকিউটেবলকে আপনার প্লে প্যাকেজের নামে নিবন্ধিত ডিজিটাল শংসাপত্রের সাথে ডিজিটালভাবে স্বাক্ষর করতে হবে।

  • গেম এক্সিকিউটেবল Google Play গেমস ক্লায়েন্টের মাধ্যমে চালু করা হয়নি।

  • Google Play Games-এর সক্রিয় ব্যবহারকারীর কাছে অ্যাপ্লিকেশনটির লাইসেন্স নেই।

ধাপ 5 : (ঐচ্ছিক) একাধিক গেম-প্রসেস সমর্থন করা

যদি আপনার গেম একাধিক প্রক্রিয়া ব্যবহার করে এবং এমন একটি প্রক্রিয়া থেকে প্লে গেমস PC SDK ব্যবহার করার পরিকল্পনা করে যা PC-এর জন্য Google Play Games দ্বারা সরাসরি চালু করা হয় না, অতিরিক্ত ইন্টিগ্রেশন পদক্ষেপের প্রয়োজন হয়:

  1. PC-এর জন্য Google Play Games দ্বারা সরাসরি চালু করা প্রক্রিয়াটিকে অবশ্যই Play Games PC SDK-এর সফল সূচনা যাচাই করতে হবে।

    এটি যত তাড়াতাড়ি সম্ভব ত্রুটিগুলি সারফেস করে সেরা ব্যবহারকারীর অভিজ্ঞতা প্রদান করে৷ মনে রাখবেন যে SDK ব্যবহার করে চাইল্ড-প্রসেসকে সরাসরি চালু করা প্রক্রিয়া ছাড়াও আরম্ভ করতে হবে।

  2. একটি শিশু-প্রক্রিয়ায় প্লে গেমস পিসি SDK ব্যবহার করতে কমান্ড লাইন প্যারামিটারগুলি তৈরি করা চাইল্ড-প্রক্রিয়াতে ফরোয়ার্ড করুন।

    উদাহরণ কমান্ড লাইন প্যারামিটার ফরওয়ার্ডিং:

    Processes hierarchy tree:

GooglePlayGames.exe
└───YourGameLauncher.exe --foo=abc --bar=123
    └───YourGame.exe --foo=abc --bar=123

    এই উদাহরণে আমরা একটি প্রক্রিয়া অনুক্রম দেখতে পাচ্ছি যেখানে পিসির জন্য Google Play গেমস ( GooglePlayGames.exe ) কিছু উদাহরণ প্যারামিটার ( --foo=abc --bar=123 ) সহ গেমটি ( YourGameLauncher.exe ) চালু করে। গেমটি তারপর একটি শিশু-প্রক্রিয়া তৈরি করে ( YourGame.exe ) যা প্লে গেমস PC SDK ব্যবহার করে। এটি অনুমোদন করার জন্য পিসির জন্য Google Play Games দ্বারা চালু করা গেম প্রক্রিয়াটি চাইল্ড-প্রসেসকে দেওয়া কমান্ড লাইন প্যারামিটারগুলিকে ফরোয়ার্ড করে।

  3. গেম চলা বন্ধ হয়ে গেলে সমস্ত প্রক্রিয়া থেকে প্রস্থান করুন।

    যখন কোনও ব্যবহারকারী আপনার গেমটি বন্ধ করে দেয় বা SDK প্রারম্ভিক ব্যর্থতার কারণে গেমটি প্রস্থান করে, যেমন kActionRequiredShutdownClientProcess , আপনার গেমটি তৈরি করা সমস্ত প্রক্রিয়া বন্ধ করুন। এটি নিশ্চিত করে যে পরের বার যখন আপনার গেমটি PC ক্লায়েন্টের জন্য Google Play Games দ্বারা চালু হবে, তখন নতুন পরিবর্তনগুলি যেমন একটি ভিন্ন সক্রিয় অ্যাকাউন্টে স্যুইচ করা কার্যকর হবে৷

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

আপনার IDE-তে বিকাশ করার সময় SDK ব্যবহার করুন:

আপনার অ্যাপে Google Play PC বৈশিষ্ট্য যোগ করুন: