Game Controller Library   Android Game Development Kit का हिस्सा.

गेम कंट्रोलर लाइब्रेरी को Paddleboat भी कहा जाता है. इसकी मदद से, गेम कंट्रोलर के लिए बेहतर सपोर्ट लागू किया जा सकता है. लाइब्रेरी में ये सुविधाएं मिलती हैं:

  • कंट्रोलर के कनेक्ट और डिसकनेक्ट होने का पता लगाने के लिए कॉलबैक
  • कंट्रोलर डिवाइस की जानकारी. इसमें बटन का स्टाइल और लेआउट शामिल है
  • कंट्रोलर से मिले इनपुट डेटा को स्टैंडर्ड बनाया गया है, ताकि इसे आधुनिक ड्यूअल-स्टिक कंट्रोलर के डिज़ाइन के हिसाब से इस्तेमाल किया जा सके
  • सपोर्ट किए गए कंट्रोलर पर ज़्यादा सुविधाएं. जैसे, वाइब्रेशन, लाइटें, मोशन ऐक्सिस का डेटा, और बैटरी का स्टेटस
  • वर्चुअल और फ़िज़िकल माउस डिवाइसों से इनपुट पढ़ने की सुविधा
  • कुछ डिवाइसों के लिए, कंट्रोलर मैपिंग का कस्टम डेटा तय करने की सुविधा

वर्शन के साथ काम करने से जुड़ी ज़रूरी शर्तें

गेम कंट्रोलर लाइब्रेरी के लिए, ये ज़रूरी शर्तें पूरी होनी चाहिए:

  • Android 4.4 (एपीआई लेवल 19) या इसके बाद के वर्शन
  • Android NDK का 21 या इसके बाद का वर्शन

इंटिग्रेट करें

Game Controller लाइब्रेरी को दो फ़ॉर्मैट में डिस्ट्रिब्यूट किया जाता है: Gradle पर आधारित बिल्ड सिस्टम (इसमें Android Studio भी शामिल है) का इस्तेमाल करने वाले गेम के लिए, Jetpack लाइब्रेरी के तौर पर और कस्टम बिल्ड सिस्टम का इस्तेमाल करने वाले गेम के लिए, अलग-अलग फ़ाइलों के तौर पर.

गेम कंट्रोलर लाइब्रेरी को इंटिग्रेट करने वाले सैंपल के लिए, games-samples रिपॉज़िटरी देखें.

Jetpack लाइब्रेरी

Jetpack Android Games पेज पर, गेम कंट्रोलर लाइब्रेरी की डिपेंडेंसी को अपने गेम की build.gradle फ़ाइल में जोड़ने के लिए इंटिग्रेशन के निर्देश दिए गए हैं.

गेम कंट्रोलर की Jetpack लाइब्रेरी रिलीज़, एक स्टैटिक लाइब्रेरी है. इसे C++ रनटाइम शेयर की गई लाइब्रेरी के हिसाब से बनाया गया है.

अपनी build.gradle फ़ाइल अपडेट करने के बाद, आपको अपने गेम की मुख्य CMakeLists.txt फ़ाइल में यह लाइन जोड़नी होगी:

find_package(games-controller REQUIRED CONFIG)

आपको अपने गेम की मुख्य शेयर की गई लाइब्रेरी के target_link_libraries कमांड में, लाइब्रेरी की सूची में यह एंट्री भी जोड़नी होगी:

games-controller::paddleboat_static

डिस्क्रीट फ़ाइलें

Android Game Development Kit के .zip संग्रह में, Game Controller library के लिए हेडर और लाइब्रेरी फ़ाइलें शामिल होती हैं. गेम कंट्रोलर लाइब्रेरी का इस्तेमाल करने के लिए, आपके प्रोजेक्ट में ये फ़ाइलें शामिल होनी चाहिए:

  • classes.jar फ़ाइल में, Game Controller लाइब्रेरी के Dalvik bytecode के हिस्से शामिल होते हैं. यह फ़ाइल libs/classes.jar पर मौजूद है
  • paddleboat.h इंटरफ़ेस हेडर फ़ाइल. यह फ़ाइल यहां मौजूद है include/paddleboat/paddleboat.h
  • libpaddleboat.so शेयर की गई लाइब्रेरी फ़ाइल या libpaddleboat-static.a स्टैटिक लाइब्रेरी फ़ाइल. ये फ़ाइलें, libs डायरेक्ट्री में मौजूद बिल्ड कॉन्फ़िगरेशन सबडायरेक्ट्री में मिलती हैं.

रूट libs डायरेक्ट्री में मौजूद, बिल्ड कॉन्फ़िगरेशन की सबडायरेक्ट्री को इन आधार पर कैटगरी में बांटा जाता है:

  • एबीआई आर्किटेक्चर
  • कम से कम Android एपीआई लेवल
  • Android NDK का वर्शन
  • C++ रनटाइम लाइब्रेरी का वर्शन
  • रिलीज़ या डीबग बिल्ड कॉन्फ़िगरेशन

उदाहरण के लिए, arm64-v8a_API16_NDK21_cpp_shared_Release सबडायरेक्ट्री में इन फ़ाइलों के लिए लाइब्रेरी फ़ाइलें होती हैं:

  • ARM 64-बिट ABI
  • कम से कम एपीआई लेवल 16
  • NDK के वर्शन 21 के साथ बनाया गया
  • C++ रनटाइम के शेयर की गई लाइब्रेरी वर्शन के हिसाब से बनाया गया
  • रिलीज़ बिल्ड कॉन्फ़िगरेशन

libpaddleboat_static.a फ़ाइल, सीधे तौर पर सबडायरेक्ट्री में मौजूद होती है. libpaddleboat.so फ़ाइल, सबडायरेक्ट्री में lib/paddleboat/ पर मौजूद है.

अगले चरण

गेम कंट्रोलर लाइब्रेरी को अपने गेम में इंटिग्रेट करने के लिए, यहां दी गई गाइड देखें: