इस दस्तावेज़ में, Android Performance Tuner को इंटिग्रेट करने का तरीका बताया गया है. इसे ट्यूनिंग फ़ोर्क लाइब्रेरी भी कहा जाता है. इससे नेटिव (C और C++) गेम इंजन से, फ़्रेम टाइम का डेटा रिकॉर्ड और अपलोड किया जा सकता है.
Unity गेम इंजन के लिए, Unity के लिए गाइड देखें.
बैकग्राउंड
गेम के अनुभव का एक मुख्य कॉम्पोनेंट, रेंडरिंग की परफ़ॉर्मेंस है. रेंडरिंग की परफ़ॉर्मेंस, इन दो इनपुट पर निर्भर करती है:
- फ़्रेम रेट: फ़्रेम कितनी बार ड्रॉ किया जाता है.
- ग्राफ़िक क्वालिटी की सेटिंग: फ़िडेलिटी का वह लेवल जिस पर कोई फ़्रेम दिखाया जाता है. इसमें सिम्युलेशन फ़िडेलिटी के साथ-साथ ग्राफ़िक भी शामिल हैं.
गेम के लिए, रेंडरिंग की अच्छी परफ़ॉर्मेंस का मतलब है:
- स्टेबल और एक जैसा फ़्रेम रेट डिलीवर करना. इसका मतलब है कि तय की गई फ़्रीक्वेंसी पर रेंडर होने वाले फ़्रेम का प्रतिशत.
- गेम के टाइप के हिसाब से, आम तौर पर 30 या 60 एफ़पीएस पर फ़्रेम रेंडर करना. इससे गेम की परफ़ॉर्मेंस बेहतर बनी रहती है.
- उपयोगकर्ता की स्क्रीन के साइज़ और डेंसिटी के हिसाब से, ज़्यादा से ज़्यादा जानकारी देना. साथ ही, मनमुताबिक और स्टेबल फ़्रेम रेट बनाए रखना.
Android फ़्रेम पेसिंग लाइब्रेरी, फ़्रेम टाइम में होने वाले ज़्यादातर बदलावों को सीमित करती है. इससे गेम के लिए, फ़्रेम रेट को स्थिर रखने में मदद मिलती है. फ़्रेम टाइम में बाकी का अंतर, गेमप्ले के कुछ सीन के दौरान दिखाई गई जानकारी के लेवल और डिवाइस की ग्राफ़िकल क्षमताओं की वजह से होता है. Android Performance Tuner का इस्तेमाल करके, गेमप्ले के दौरान उन समय का पता लगाया जा सकता है जब फ़्रेम टाइम आपके टारगेट से कम या ज़्यादा होता है. साथ ही, इन समस्याओं और अवसरों को इनसे जोड़ा जा सकता है:
- क्वालिटी की खास सेटिंग
- आपके गेम के खास सीन
- डिवाइस के मॉडल या डिवाइस की खास जानकारी
डेटा रिकॉर्ड और अपलोड करना
ट्यूनिंग फ़ोर्क लाइब्रेरी, अपने किसी एक टिक फ़ंक्शन पर निर्भर करती है. इसे Android फ़्रेम पेसिंग लाइब्रेरी, हर फ़्रेम के लिए कॉल करती है. लाइब्रेरी में, टिक की इस जानकारी को हिस्टोग्राम में इकट्ठा किया जाता है. इसके बाद, इसे एचटीटीपी एंडपॉइंट के ज़रिए समय-समय पर Google Play पर अपलोड किया जाता है. हर टिक को इंस्ट्रुमेंट की और एनोटेशन से जुड़ा हुआ माना जाता है. इनकी परिभाषाएं, प्रोटोकॉल बफ़र फ़ाइल में तय की जाती हैं.
इंस्ट्रुमेंट की
इंस्ट्रुमेंट की से पता चलता है कि फ़्रेम में टिक कहां से आता है. यह एक पूर्णांक होता है, जिसे हर टिक फ़ंक्शन कॉल को पास करना ज़रूरी है. Android Frame Pacing लाइब्रेरी, पहले से तय की गई इंस्ट्रुमेंट कुंजियों के सेट का इस्तेमाल करती है. इसे swappy_common.h में तय किया गया है.
अगर फ़्रेम पेसिंग लाइब्रेरी का इस्तेमाल नहीं किया जाता है, तो अपनी इंस्ट्रुमेंट की भी तय की जा सकती हैं.
टिप्पणियां
एनोटेशन से इस बारे में ज़रूरी जानकारी मिलती है कि टिक रिकॉर्ड होने पर, आपके गेम में क्या चल रहा है. उदाहरण के लिए, एनोटेशन से इनमें से किसी भी चीज़ की पहचान की जा सकती है:
- गेम का मौजूदा लेवल
- स्क्रीन पर "बिग बॉस" दिख रहा है
- गेम की स्थिति के बारे में कोई अन्य काम की जानकारी
एनोटेशन, com.google.tuningfork.Annotation प्रोटोकॉल बफ़र मैसेज से तय किए जाते हैं. मौजूदा एनोटेशन को सेट करने के लिए, आपको TuningFork_setCurrentAnnotation में तय किए गए मैसेज का सीरियलाइज़ेशन पास करना होगा. इसके बाद, टिक का सारा डेटा इस एनोटेशन से तब तक जुड़ा रहता है, जब तक कि कोई दूसरा एनोटेशन सेट नहीं किया जाता. एनोटेशन के लिए प्रोटो डेफ़िनिशन का एक उदाहरण यहां दिया गया है:
import "tuningfork.proto"
enum Level {
INVALID_LEVEL = 0;
Level_1 = 1;
Level_2 = 2;
Level_3 = 3;
}
message Annotation {
optional Level level = 1;
}
फ़िडेलिटी के पैरामीटर
फ़िडेलिटी के पैरामीटर, आपके गेम की परफ़ॉर्मेंस और ग्राफ़िक्स की क्वालिटी से जुड़ी चीज़ों पर असर डालते हैं. जैसे, मेश लेवल-ऑफ़-डिटेल, टेक्सचर रिज़ॉल्यूशन, और एंटी-एलिऐसिंग का तरीका. एनोटेशन की तरह ही, फ़िडेलिटी के पैरामीटर को com.google.tuningfork.FidelityParams प्रोटोकॉल बफ़र मैसेज का इस्तेमाल करके तय किया जाता है. यहां फ़िडेलिटी के पैरामीटर के लिए, प्रोटोकॉल बफ़र की परिभाषा का एक उदाहरण दिया गया है:
import "tuningfork.proto"
message FidelityParams {
int32 texture_quality_level = 1;
int32 shadow_resolution = 2;
float terrain_details_percent = 3;
int32 post_processing_effects_level = 4;
}
ट्यूनिंग फ़ोर्क को शुरू करते समय, गेम में इस्तेमाल किए जाने वाले पैरामीटर को सीरियलाइज़ किया जाता है. इन पैरामीटर को बदला जा सकता है. उदाहरण के लिए, अगर उपयोगकर्ता गेम रेंडरिंग की सेटिंग बदलता है और आपका अपलोड किया गया डेटा नए पैरामीटर से जुड़ा है, तो इन पैरामीटर को बदला जा सकता है.
Google Play, आपके तय किए गए एनोटेशन और फ़िडेलिटी के पैरामीटर को समझ सके, इसके लिए इन परिभाषाओं वाली प्रोटोकॉल बफ़र फ़ाइल को गेम के APK में बंडल करना होगा. साथ ही, इसमें शुरू करने की सेटिंग भी शामिल करनी होंगी. आपको अपने APK में, फ़िडेलिटी के पैरामीटर के सामान्य कॉम्बिनेशन के लिए डिफ़ॉल्ट वैल्यू भी देनी होंगी. इससे Google Play के यूज़र इंटरफ़ेस (यूआई) में, आपके डेटा को उनके हिसाब से सेगमेंट किया जा सकेगा. ज़्यादा जानकारी के लिए, क्वालिटी के लेवल तय करना लेख पढ़ें.
मेमोरी और सीपीयू ओवरहेड
ट्यूनिंग फ़ोर्क लाइब्रेरी, इस्तेमाल की जाने वाली पूरी मेमोरी को शुरू में ही असाइन कर देती है, ताकि गेमप्ले के दौरान कोई समस्या न आए. डेटा का साइज़, इंस्ट्रुमेंट की संख्या, संभावित एनोटेशन की संख्या, और हर हिस्टोग्राम में बकेट की संख्या पर निर्भर करता है. यह हर बकेट के लिए, इन सभी के चार बाइट का मल्टीपल होता है. सभी हिस्टोग्राम की दो कॉपी भी होती हैं, ताकि उन्हें डबल-बफ़र तरीके से सबमिट किया जा सके.
सबमिशन एक अलग थ्रेड पर होता है और टिक कॉल को ब्लॉक नहीं करता. अगर अपलोड करने के लिए कोई कनेक्शन उपलब्ध नहीं है, तो सबमिट किए गए डेटा को बाद में अपलोड करने के लिए सूची में डाल दिया जाता है.
टिक फ़ंक्शन को कॉल करने में, प्रोसेसिंग का थोड़ा ओवरहेड होता है: यह हिस्टोग्राम बकेट के कलेक्शन में इंडेक्स का हिसाब लगाता है और पूर्णांक की संख्या बढ़ाता है.
ट्यूनिंग फ़ोर्क लाइब्रेरी को इंटिग्रेट करना
इंटिग्रेशन की इस गाइड को दो हिस्सों में बांटा गया है. पहले हिस्से में, डेमो ऐप्लिकेशन और Google Play Console का इस्तेमाल करके, एंड-टू-एंड टेस्ट चलाने का तरीका बताया गया है. दूसरे हिस्से में, ट्यूनिंग फ़ोर्क लाइब्रेरी को टूलचेन में इंटिग्रेट करने का तरीका बताया गया है. साथ ही, लाइब्रेरी में मौजूद फ़ंक्शन इस्तेमाल करने का तरीका भी बताया गया है. शुरू करने के लिए, नीचे दिए गए आगे बढ़ें लिंक पर क्लिक करें.