GameActivity   Android Game Development Kit-এর অংশ।

GameActivity হল একটি Jetpack লাইব্রেরি যা Android গেমকে অ্যাপ সাইকেল কমান্ড, ইনপুট ইভেন্ট এবং অ্যাপ্লিকেশনের C/C++ কোডে টেক্সট ইনপুট প্রসেস করতে সাহায্য করার জন্য ডিজাইন করা হয়েছে। GameActivity হল NativeActivity-এর সরাসরি বংশধর এবং একই ধরনের আর্কিটেকচার শেয়ার করে:

alt_text

আগের ডায়াগ্রামে যেমন দেখানো হয়েছে, GameActivity নিম্নলিখিত ফাংশনগুলি সম্পাদন করে:

  • Java-সাইড কম্পোনেন্টের মাধ্যমে Android ফ্রেমওয়ার্কের সাথে ইন্টার‍্যাক্ট করা।
  • নেটিভ সাইডে অ্যাপ সাইকেল কমান্ড, ইনপুট ইভেন্ট ও ইনপুট টেক্সট পাস করা।
  • C/C++ সোর্স কোডকে তিনটি লজিক্যাল কম্পোনেন্টে মডেল করা:
    • GameActivity-এর JNI ফাংশন, যা সরাসরি GameActivity-এর Java ফাংশনালিটি সাপোর্ট করে এবং native_app_glue-এ ইভেন্ট এনকিউ করে।
    • native_app_glue, যা মূলত নিজস্ব নেটিভ থ্রেডে চলে (অ্যাপ্লিকেশনের মূল থ্রেড থেকে আলাদা) এবং এর লুপারের সাহায্যে টাস্ক এক্সিকিউট করে।
    • অ্যাপ্লিকেশনের গেম কোড, যা native_app_glue-এর মধ্যে সারিবদ্ধ ইভেন্টগুলি পোল এবং প্রসেস করে এবং native_app_glue থ্রেডের মধ্যে গেম কোড এক্সিকিউট করে।

GameActivity-এর সাহায্যে, আপনি গেম ডেভেলপমেন্টের মূল বিষয়ের উপর ফোকাস করতে পারবেন এবং JNI কোড নিয়ে অতিরিক্ত সময় ব্যয় করা এড়াতে পারবেন।

আপনি যদি আগে থেকেই NativeActivity-এর সাথে পরিচিত হন, তাহলে GameActivity এবং NativeActivity-এর মধ্যে প্রধান পার্থক্যগুলি নিচে উল্লেখ করা হল:

  • GameActivity SurfaceView-এ রেন্ডার করে, যা গেমের জন্য অন্যান্য UI কম্পোনেন্টের সাথে ইন্টার‍্যাক্ট করা অনেক সহজ করে তোলে।
  • টাচ ও কী ইনপুট ইভেন্টের জন্য, GameActivity-এ android_input_buffer ইন্টারফেসের সাথে সম্পূর্ণ নতুন ইমপ্লিমেন্টেশন আছে, যা NativeActivity-এর ব্যবহার করা InputQueue থেকে আলাদা।
  • GameActivity হল AppCompatActivity-এর একটি ডিরাইভড ক্লাস, যা আপনাকে অন্যান্য Jetpack কম্পোনেন্ট নির্বিঘ্নে ব্যবহার করতে দেয়। ActionBar, Fragment এবং অন্যান্য সব উপলভ্য।
  • GameActivity, GameTextInput লাইব্রেরি ইন্টিগ্রেট করার মাধ্যমে টেক্সট ইনপুট কার্যকারিতা যোগ করে।
  • GameActivity থেকে প্রাপ্ত অ্যাপগুলি C/C++ কোডের তিনটি অংশই একটি লাইব্রেরিতে তৈরি করবে বলে আশা করা হচ্ছে। অন্যদিকে, NativeActivity-এর JNI ফাংশন ফ্রেমওয়ার্কের অংশ (OS দ্বারা সবসময় লোড করা হয়)। তাই, শুধুমাত্র native_app_glue এবং অ্যাপ্লিকেশনের C/C++ কোড একটি লাইব্রেরিতে বিল্ড করা হবে বলে আশা করা হচ্ছে।
  • NativeActivity হল Android ফ্রেমওয়ার্কের অংশ এবং এটি রিলিজ সাইকেল (সাধারণত বার্ষিক) অনুসরণ করে। GameActivity হল Jetpack লাইব্রেরির অংশ, যার রিলিজ সাইকেল অনেক বেশি ঘন ঘন (সাধারণত পাক্ষিক); নতুন ফিচার এবং ত্রুটি সমাধান অনেক দ্রুত আসতে পারে।

রিলিজের লোকেশন

GameActivity লাইব্রেরি নিম্নলিখিত চ্যানেলে উপলভ্য:

C/C++ কোডটি Prefab ফর্ম্যাট ব্যবহার করে সব রিলিজ চ্যানেলে সোর্স কোড হিসেবে প্রদান করা হয়। GameActivity ভার্সন ১.২.২ ডিস্ট্রিবিউশনে একটি স্ট্যাটিক লাইব্রেরি যোগ করে। এই ভার্সন এবং এর পরবর্তী ভার্সন থেকে, আমরা আপনাকে সোর্স কোডের পরিবর্তে স্ট্যাটিক লাইব্রেরি ব্যবহার করার সাজেশন দিই।

Jetpack লাইব্রেরির কন্টেন্ট

Jetpack লাইব্রেরির সাথে, GameActivity, AAR-এর সাথে রিলিজ করা হয়েছে। এই AAR-এ নিম্নলিখিত প্রধান কম্পোনেন্ট থাকে:

  • Java কোডের জন্য একটি JAR ফাইল
  • C/C++স্ট্যাটিক লাইব্রেরি game-activity_static GameActivity ভার্সন 1.2.2 এবং পরবর্তী ভার্সনে অন্তর্ভুক্ত করা হয়েছে।
  • C/C++ সোর্স কোড (/prefab ফোল্ডারের অধীনে)

এই পৃষ্ঠায় লিঙ্ক করা ইন্টিগ্রেশন সংক্রান্ত নির্দেশাবলীতে ধরে নেওয়া হয়েছে যে আপনি বিল্ড সিস্টেমে Prefab ব্যবহার করতে পারবেন; অন্যথায়, আপনি বিল্ড সিস্টেমে prefab/modules/game-activity/include ফোল্ডারের মধ্যে প্যাক করা সোর্স কোড কপি করতে এবং প্রয়োজনীয় ইন্টিগ্রেশন ধাপগুলি সম্পূর্ণ করতে পারবেন। Android Jetpack লাইব্রেরির জন্য androidx-এর অধীনে রিলিজের জন্য একই ধরনের ফাইল স্ট্রাকচার আছে; সাধারণত, gradle তার ক্যাশে ডিরেক্টরিতে (~/.gradle/caches/...) AAR আনপ্যাক করে। আপনি prefab/modules/game-activity/include সার্চ করে এবং আপনার রিলিজ ভার্সনের লোকেশন বেছে নিয়ে C/C++ সোর্স কোড খুঁজে পেতে পারেন।

Jetpack লাইব্রেরি ব্যবহার করে ইন্টিগ্রেট করার নির্দেশাবলীর জন্য, GameActivity ব্যবহার শুরু করুন দেখুন।

AOSP সোর্স কোডের কন্টেন্ট

AOSP-তে সবসময় সবচেয়ে সাম্প্রতিক সোর্স কোড থাকে। আপনার নিজের রিলিজ তৈরি করতে বিল্ড সংক্রান্ত নির্দেশাবলী অনুসরণ করুন অথবা আপনার বিল্ড এনভায়রনমেন্টে সরাসরি সোর্স ইন্টিগ্রেট করুন। C/C++ সোর্স কোড Jetpack লাইব্রেরির মতো ফাইল স্ট্রাকচারে সেভ করা হয়।

ইন্টিগ্রেশন সংক্রান্ত নির্দেশিকা

আপনার অ্যাপ্লিকেশনে GameActivity ইন্টিগ্রেট করতে এইসব নির্দেশিকা অনুসরণ করুন:

অতিরিক্ত রিসোর্স

GameActivity সম্পর্কে আরও জানতে, নিম্নলিখিতগুলি দেখুন:

মতামত

GameActivity-তে কোনও সমস্যার ব্যাপারে অভিযোগ জানাতে বা নতুন ফিচারের অনুরোধ করতে, GameActivity ইস্যু ট্র্যাকার ব্যবহার করুন।