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

पिछले डायग्राम में बताया गया है कि GameActivity ये काम करता है:
- Java-साइड कॉम्पोनेंट के ज़रिए, Android फ़्रेमवर्क के साथ इंटरैक्ट करना.
- ऐप्लिकेशन साइकल के कमांड, इनपुट इवेंट, और इनपुट टेक्स्ट को नेटिव साइड पर पास करना.
- C/C++ सोर्स कोड को तीन लॉजिकल कॉम्पोनेंट में मॉडल करना:
- GameActivity के जेएनआई फ़ंक्शन, जो सीधे तौर पर GameActivity के Java फ़ंक्शन के साथ काम करते हैं और इवेंट को
native_app_glueमें सूची में जोड़ते हैं. native_app_glue, जो ज़्यादातर अपने नेटिव थ्रेड में चलता है. यह ऐप्लिकेशन के मुख्य थ्रेड से अलग होता है. साथ ही, यह अपने लूपर की मदद से टास्क को पूरा करता है.- ऐप्लिकेशन का गेम कोड, जो
native_app_glueमें सूची में शामिल इवेंट को पोल और प्रोसेस करता है. साथ ही,native_app_glueथ्रेड में गेम कोड को लागू करता है.
- GameActivity के जेएनआई फ़ंक्शन, जो सीधे तौर पर GameActivity के Java फ़ंक्शन के साथ काम करते हैं और इवेंट को
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 लाइब्रेरी इन चैनलों में उपलब्ध है:
- Android Jetpack लाइब्रेरी के हिस्से के तौर पर (सुझाया गया)
- AOSP सोर्स कोड के तौर पर
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 को इंटिग्रेट करने के लिए, इन गाइड में दिए गए निर्देशों का पालन करें:
- शुरू करें
- गेम में टेक्स्ट इनपुट की सुविधा का इस्तेमाल करना
- NativeActivity को माइग्रेट करने से जुड़ी गाइड
अन्य संसाधन
GameActivity के बारे में ज़्यादा जानने के लिए, यह लेख पढ़ें:
- GameActivity और AGDK के रिलीज़ नोट.
- GameActivity में GameTextInput का इस्तेमाल करना.
- NativeActivity माइग्रेट करने से जुड़ी गाइड.
- GameActivity से जुड़ा रेफ़रंस दस्तावेज़.
- GameActivity लागू करना.
सुझाव/राय दें या शिकायत करें
GameActivity में गड़बड़ियों की शिकायत करने या नई सुविधाओं का अनुरोध करने के लिए, GameActivity से जुड़ी समस्या को ट्रैक करने वाले टूल का इस्तेमाल करें.