GameActivity   यह Android Game Development Kit का हिस्सा है.

GameActivity, Jetpack लाइब्रेरी है. इसे Android गेम के C/C++ कोड में, ऐप्लिकेशन साइकल के निर्देश, इनपुट इवेंट, और टेक्स्ट इनपुट को प्रोसेस करने में मदद करने के लिए डिज़ाइन किया गया है. GameActivity, NativeActivity का डायरेक्ट डिसेंडेंट है और इसका आर्किटेक्चर भी मिलता-जुलता है:

alt_text

पिछले डायग्राम में बताया गया है कि GameActivity ये काम करता है:

  • Java-साइड कॉम्पोनेंट के ज़रिए, Android फ़्रेमवर्क के साथ इंटरैक्ट करना.
  • ऐप्लिकेशन साइकल के कमांड, इनपुट इवेंट, और इनपुट टेक्स्ट को नेटिव साइड पर पास करना.
  • C/C++ सोर्स कोड को तीन लॉजिकल कॉम्पोनेंट में मॉडल करना:
    • GameActivity के जेएनआई फ़ंक्शन, जो सीधे तौर पर GameActivity के Java फ़ंक्शन के साथ काम करते हैं और इवेंट को native_app_glue में सूची में जोड़ते हैं.
    • native_app_glue, जो ज़्यादातर अपने नेटिव थ्रेड में चलता है. यह ऐप्लिकेशन के मुख्य थ्रेड से अलग होता है. साथ ही, यह अपने लूपर की मदद से टास्क को पूरा करता है.
    • ऐप्लिकेशन का गेम कोड, जो native_app_glue में सूची में शामिल इवेंट को पोल और प्रोसेस करता है. साथ ही, native_app_glue थ्रेड में गेम कोड को लागू करता है.

GameActivity की मदद से, गेम डेवलपमेंट पर फ़ोकस किया जा सकता है. साथ ही, जेएनआई कोड को मैनेज करने में ज़्यादा समय खर्च करने से बचा जा सकता है.

अगर आपको NativeActivity के बारे में पहले से जानकारी है, तो GameActivity और NativeActivity के बीच के मुख्य अंतर ये हैं:

  • GameActivity, SurfaceView में रेंडर होता है. इससे गेम के लिए, यूज़र इंटरफ़ेस (यूआई) के अन्य कॉम्पोनेंट के साथ इंटरैक्ट करना आसान हो जाता है.
  • टच और की इनपुट इवेंट के लिए, GameActivity में android_input_buffer इंटरफ़ेस के साथ पूरी तरह से नया सेटअप है. यह NativeActivity के इस्तेमाल किए जाने वाले InputQueue से अलग है.
  • GameActivity, AppCompatActivity की एक डिराइव्ड क्लास है. इसकी मदद से, Jetpack के अन्य कॉम्पोनेंट आसानी से इस्तेमाल किए जा सकते हैं. ActionBar, Fragment, और अन्य सभी उपलब्ध हैं.
  • GameActivity, GameTextInput लाइब्रेरी को इंटिग्रेट करके, टेक्स्ट इनपुट की सुविधा जोड़ता है.
  • GameActivity से बनाए गए ऐप्लिकेशन के लिए ज़रूरी है कि वे C/C++ कोड के तीनों हिस्सों को एक लाइब्रेरी में बनाएं. वहीं दूसरी ओर, NativeActivity के जेएनआई फ़ंक्शन, फ़्रेमवर्क का हिस्सा होते हैं. इन्हें ओएस हमेशा लोड करता है. इसलिए, सिर्फ़ native_app_glue और ऐप्लिकेशन के C/C++ कोड को एक लाइब्रेरी में बनाया जाना चाहिए.
  • NativeActivity, Android फ़्रेमवर्क का हिस्सा है और यह इसके रिलीज़ साइकल (आम तौर पर सालाना) के हिसाब से काम करता है. GameActivity, Jetpack लाइब्रेरी का हिस्सा है. इसे ज़्यादा बार रिलीज़ किया जाता है. आम तौर पर, हर दो हफ़्ते में. इसलिए, नई सुविधाएं और गड़बड़ियां ठीक करने के तरीके ज़्यादा तेज़ी से उपलब्ध हो सकते हैं.

जगह की जानकारी रिलीज़ करना

GameActivity लाइब्रेरी इन चैनलों में उपलब्ध है:

C/C++ कोड को सभी रिलीज़ चैनलों में सोर्स कोड के तौर पर उपलब्ध कराया जाता है. इसके लिए, Prefab फ़ॉर्मैट का इस्तेमाल किया जाता है. GameActivity के वर्शन 1.2.2 में, डिस्ट्रिब्यूशन के लिए एक स्टैटिक लाइब्रेरी जोड़ी गई है. इस वर्शन और इसके बाद के वर्शन से, हमारा सुझाव है कि आप सोर्स कोड के बजाय स्टैटिक लाइब्रेरी का इस्तेमाल करें.

Jetpack लाइब्रेरी का कॉन्टेंट

Jetpack लाइब्रेरी के साथ, GameActivity को एएआर के साथ रिलीज़ किया जाता है. इस एएआर में ये मुख्य कॉम्पोनेंट शामिल हैं:

  • 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/...) में एएआर को अनपैक करता है. C/C++ सोर्स कोड ढूंढने के लिए, prefab/modules/game-activity/include खोजें. इसके बाद, रिलीज़ के लिए तैयार वर्शन में जाकर, जगह की जानकारी चुनें.

Jetpack लाइब्रेरी का इस्तेमाल करके इंटिग्रेट करने के निर्देशों के लिए, GameActivity का इस्तेमाल शुरू करना लेख पढ़ें.

एओएसपी के सोर्स कोड का कॉन्टेंट

एओएसपी में हमेशा सबसे नया सोर्स कोड होता है. अपनी रिलीज़ बनाने के लिए, बिल्ड करने के निर्देशों का पालन करें या सोर्स को सीधे अपने बिल्ड एनवायरमेंट में इंटिग्रेट करें. C/C++ सोर्स कोड को Jetpack लाइब्रेरी की तरह ही फ़ाइल स्ट्रक्चर में सेव किया जाता है.

इंटिग्रेशन गाइड

अपने ऐप्लिकेशन में GameActivity को इंटिग्रेट करने के लिए, इन गाइड में दिए गए निर्देशों का पालन करें:

अन्य संसाधन

GameActivity के बारे में ज़्यादा जानने के लिए, यह लेख पढ़ें:

सुझाव/राय दें या शिकायत करें

GameActivity में गड़बड़ियों की शिकायत करने या नई सुविधाओं का अनुरोध करने के लिए, GameActivity से जुड़ी समस्या को ट्रैक करने वाले टूल का इस्तेमाल करें.