👨🏽‍🤝‍👨🏼 🏅 🤦 यूनिटी 3 डी में बाहरी संसाधनों के साथ काम करना 👩‍🏭 🤟🏿 🕒

परिचय

नमस्कार प्रिय पाठकों, आज हम एकता 3 डी वातावरण में बाहरी संसाधनों के साथ काम करने के बारे में बात करेंगे।

परंपरा से, शुरू करने के लिए, हम यह निर्धारित करेंगे कि यह क्या है और हमें इसकी आवश्यकता क्यों है। तो, वास्तव में ये बाहरी संसाधन क्या हैं। खेल के विकास के हिस्से के रूप में, ऐसे संसाधन सब कुछ हो सकते हैं जो आवेदन के कार्य के लिए आवश्यक हैं और परियोजना के अंतिम निर्माण में संग्रहीत नहीं होने चाहिए। बाहरी संसाधन उपयोगकर्ता के कंप्यूटर की हार्ड डिस्क और बाहरी वेब सर्वर दोनों पर स्थित हो सकते हैं। सामान्य स्थिति में, ऐसे संसाधन किसी भी फ़ाइल या डेटा सेट हैं जिन्हें हम अपने पहले से चल रहे एप्लिकेशन में लोड करते हैं। एकता 3 डी के ढांचे में बोलते हुए, फिर वे हो सकते हैं:

पाठ फ़ाइल
बनावट फ़ाइल
ऑडियो फ़ाइल
बाइट सरणी
AssetBundle (एकता 3 डी परियोजना की संपत्ति के साथ संग्रह)

नीचे, हम यूनिटी 3 डी में मौजूद इन संसाधनों के साथ काम करने के लिए और अधिक विस्तार से जांच करेंगे, साथ ही वेब सर्वर के साथ बातचीत करने और एप्लिकेशन में संसाधनों को लोड करने के लिए सरल प्रबंधकों को भी लिखेंगे।

नोट : इस लेख के बाकी सी # 7+ का उपयोग करते हुए कोड का उपयोग करता है और इसे 2018.3+ संस्करणों में यूनिटी 3 डी में उपयोग किए गए रोजलिन कंपाइलर के लिए डिज़ाइन किया गया है।

एकता 3 डी की विशेषताएं

2017 एकता संस्करण से पहले, एक तंत्र (स्व-वर्णित को छोड़कर) का उपयोग सर्वर डेटा और बाहरी संसाधनों के साथ काम करने के लिए किया गया था, जिसे इंजन में शामिल किया गया था - यह डब्ल्यूडब्ल्यूडब्ल्यू वर्ग है। इस वर्ग ने विभिन्न http कमांड (गेट, पोस्ट, पुट इत्यादि) के समकालिक या अतुल्यकालिक रूप (कोरआउट के माध्यम से) के उपयोग की अनुमति दी। इस वर्ग के साथ काम करना काफी सरल और सीधा था।

IEnumerator LoadFromServer(string url) { var www = new WWW(url); yield return www; Debug.Log(www.text); }

इसी तरह, आप न केवल पाठ डेटा, बल्कि अन्य भी प्राप्त कर सकते हैं:

बाइट ऐरे - www.bytes
बनावट - www.texture
ऑडियो - www.GetAudioClip ()
एसेट - www.assetBundle

हालांकि, 2017 के संस्करण से शुरू, यूनिटी में एक नया सर्वर सिस्टम है जो यूनिटीवेबसेंस्ट क्लास द्वारा शुरू किया गया है, जो नेटवर्किंग नाम में स्थित है। एकता 2018 तक, यह डब्ल्यूडब्ल्यूडब्ल्यू के साथ मौजूद था, लेकिन डब्ल्यूडब्ल्यूडब्ल्यू इंजन के नवीनतम संस्करण में यह अनुशंसित नहीं हुआ, और भविष्य में इसे पूरी तरह से हटा दिया जाएगा। इसलिए, आगे हम केवल UnityWebRequest (इसके बाद UWR) पर ध्यान केंद्रित करेंगे।

समग्र रूप से UWR के साथ काम करना इसके मूल में WWW के समान है, लेकिन इसमें अंतर हैं, जिन पर बाद में चर्चा की जाएगी। नीचे लोडिंग टेक्स्ट का एक समान उदाहरण है।

 IEnumerator LoadFromServer(string url) { var request = new UnityWebRequest(url); yield return request.SendWebRequest(); Debug.Log(request.downloadHandler.text); request.Dispose(); }

नए यूडब्ल्यूआर सिस्टम ने जो मुख्य बदलाव पेश किए हैं (अंदर काम करने के सिद्धांत में बदलाव के अलावा) सर्वर से डेटा अपलोड करने और डाउनलोड करने के लिए हैंडलर को असाइन करने की क्षमता है, अधिक विवरण यहां मिल सकते हैं । डिफ़ॉल्ट रूप से, ये अपलोड अपलोडहैंडलर और डाउनलोडहैंडलर हैं । एकता स्वयं इन वर्गों को विभिन्न आंकड़ों, जैसे कि ऑडियो, बनावट, संपत्ति, आदि के साथ काम करने के लिए एक्सटेंशन प्रदान करती है। आइए उनके साथ अधिक विस्तार से काम करने पर विचार करें।

संसाधनों के साथ काम करें

टेक्स्ट

पाठ के साथ काम करना सबसे आसान विकल्पों में से एक है। इसे डाउनलोड करने की विधि पहले ही ऊपर वर्णित की गई है। हम इसे डायरेक्ट http गेट रिक्वेस्ट बनाने के उपयोग के साथ फिर से लिखते हैं।

 IEnumerator LoadTextFromServer(string url, Action<string> response) { var request = UnityWebRequest.Get(url); yield return request.SendWebRequest(); if (!request.isHttpError && !request.isNetworkError) { response(uwr.downloadHandler.text); } else { Debug.LogErrorFormat("error request [{0}, {1}]", url, request.error); response(null); } request.Dispose(); }

जैसा कि आप कोड से देख सकते हैं, डिफ़ॉल्ट डाउनलोडहैंडलर का उपयोग यहां किया जाता है। टेक्स्ट प्रॉपर्टी एक गेट्टर है जो बाइट सरणी को UTF8 एनकोडेड टेक्स्ट में परिवर्तित करता है। सर्वर से लोडिंग टेक्स्ट का मुख्य उपयोग एक जोंस फाइल (टेक्स्ट फॉर्म में डेटा का क्रमिक प्रतिनिधित्व) प्राप्त करना है। आप एकता JsonUtility वर्ग का उपयोग करके यह डेटा प्राप्त कर सकते हैं।

 var data = JsonUtility.FromJson<T>(value); // T  ,    .

ऑडियो

ऑडियो के साथ काम करने के लिए, आपको UnityWebRequestMultimedia.GetAudioClip अनुरोध बनाने की विशेष विधि का उपयोग करना होगा, और यूनिटी में काम करने के लिए आवश्यक रूप में डेटा प्रतिनिधित्व प्राप्त करने के लिए, आपको DownloadHandler -udioClip का उपयोग करना होगा। इसके अलावा, एक अनुरोध बनाते समय, आपको ऑडियो टाइप संलयन द्वारा प्रस्तुत ऑडियो डेटा के प्रकार को निर्दिष्ट करना होगा, जो प्रारूप (wav, aiff, oggvorbis, आदि) सेट करता है।

 IEnumerator LoadAudioFromServer(string url, AudioType audioType, Action<AudioClip> response) { var request = UnityWebRequestMultimedia.GetAudioClip(url, audioType); yield return request.SendWebRequest(); if (!request.isHttpError && !request.isNetworkError) { response(DownloadHandlerAudioClip.GetContent(request)); } else { Debug.LogErrorFormat("error request [{0}, {1}]", url, request.error); response(null); } request.Dispose(); }

बनावट

ऑडियो फ़ाइलों के लिए डाउनलोडिंग बनावट समान है। अनुरोध UnityWebRequestTexture.GetTexture का उपयोग करके बनाया गया है । एकता के लिए आवश्यक रूप में डेटा प्राप्त करने के लिए, DownloadHandlerTexture का उपयोग किया जाता है।

 IEnumerator LoadTextureFromServer(string url, Action<Texture2D> response) { var request = UnityWebRequestTexture.GetTexture(url); yield return request.SendWebRequest(); if (!request.isHttpError && !request.isNetworkError) { response(DownloadHandlerTexture.GetContent(request)); } else { Debug.LogErrorFormat("error request [{0}, {1}]", url, request.error); response(null); } request.Dispose(); }

एसेट बंडल

जैसा कि पहले उल्लेख किया गया है, बंडल वास्तव में, एकता संसाधनों वाला एक संग्रह है जिसका उपयोग पहले से चल रहे खेल में किया जा सकता है। ये संसाधन दृश्य सहित किसी भी परियोजना की संपत्ति हो सकते हैं। अपवाद सी # स्क्रिप्ट है, वे पारित नहीं किया जा सकता है। AssetBundle को लोड करने के लिए, एक क्वेरी का उपयोग किया जाता है जो UnityWebRequestAssetBundle.GetAssetBundle का उपयोग करके बनाई गई है । DownloadHandlerAssetBundle का उपयोग एकता के लिए आवश्यक रूप में डेटा प्राप्त करने के लिए किया जाता है।

 IEnumerator LoadBundleFromServer(string url, Action<AssetBundle> response) { var request = UnityWebRequestAssetBundle.GetAssetBundle(url); yield return request.SendWebRequest(); if (!request.isHttpError && !request.isNetworkError) { response(DownloadHandlerAssetBundle.GetContent(request)); } else { Debug.LogErrorFormat("error request [{0}, {1}]", url, request.error); response(null); } request.Dispose(); }

वेब सर्वर और बाहरी डेटा के साथ काम करते समय मुख्य समस्याएं और समाधान

विभिन्न संसाधनों को लोड करने के संबंध में एप्लिकेशन और सर्वर के बीच बातचीत के सरल तरीके ऊपर वर्णित किए गए हैं। हालांकि, व्यवहार में, चीजें बहुत अधिक जटिल हैं। डेवलपर्स के साथ आने वाली मुख्य समस्याओं पर विचार करें और उन्हें हल करने के तरीकों पर ध्यान दें।

पर्याप्त खाली जगह नहीं

सर्वर से डेटा डाउनलोड करते समय पहली समस्याओं में से एक डिवाइस पर मुक्त स्थान की संभावित कमी है। अक्सर ऐसा होता है कि उपयोगकर्ता गेम के लिए पुराने उपकरणों (विशेष रूप से एंड्रॉइड पर) का उपयोग करता है, साथ ही डाउनलोड की गई फ़ाइलों का आकार भी काफी बड़ा (हैलो पीसी) हो सकता है। किसी भी स्थिति में, इस स्थिति को सही ढंग से संसाधित किया जाना चाहिए और खिलाड़ी को पहले से सूचित किया जाना चाहिए कि पर्याप्त स्थान और कितना नहीं है। यह कैसे करना है? पहली चीज़ जो आपको जानने की आवश्यकता है वह डाउनलोड की गई फ़ाइल का आकार है, यह यूनिटीवेबर्सपेस्ट.हेड () अनुरोध के माध्यम से किया जाता है। नीचे आकार प्राप्त करने के लिए कोड है।

 IEnumerator GetConntentLength(string url, Action<int> response) { var request = UnityWebRequest.Head(url); yield return request.SendWebRequest(); if (!request.isHttpError && !request.isNetworkError) { var contentLength = request.GetResponseHeader("Content-Length"); if (int.TryParse(contentLength, out int returnValue)) { response(returnValue); } else { response(-1); } } else { Debug.LogErrorFormat("error request [{0}, {1}]", url, request.error); response(-1); } }

यहां एक बात पर ध्यान देना महत्वपूर्ण है, सही तरीके से काम करने के अनुरोध के लिए, सर्वर को सामग्री के आकार को वापस करने में सक्षम होना चाहिए, अन्यथा (जैसा कि वास्तव में, प्रगति प्रदर्शित करने के लिए), गलत मान वापस आ जाएगा।

डाउनलोड किए गए डेटा का आकार प्राप्त करने के बाद, हम इसे मुक्त डिस्क स्थान के आकार के साथ तुलना कर सकते हैं। उत्तरार्द्ध प्राप्त करने के लिए, मैं एसेट स्टोर से मुफ्त प्लगइन का उपयोग करता हूं।

नोट : आप कैश क्लास का उपयोग यूनिटी 3 डी में कर सकते हैं, यह मुफ्त और उपयोग किए गए कैश स्थान दिखा सकता है। हालांकि, यह इस बिंदु पर विचार करने के लायक है कि ये डेटा सापेक्ष हैं। उनकी गणना कैश के आकार के आधार पर की जाती है, डिफ़ॉल्ट रूप से यह 4GB है। यदि उपयोगकर्ता के पास कैश के आकार से अधिक खाली स्थान है, तो कोई समस्या नहीं होगी, हालांकि यदि ऐसा नहीं है, तो मान उन मूल्यों को ले सकते हैं जो वास्तविक मामलों की स्थिति के सापेक्ष गलत हैं।

इंटरनेट का उपयोग जाँच

बहुत बार, सर्वर से कुछ भी डाउनलोड करने से पहले, इंटरनेट एक्सेस की कमी की स्थिति को संभालना आवश्यक है। ऐसा करने के कई तरीके हैं: एक पते को पिंग करने से लेकर google.ru पर GET के अनुरोध तक। हालाँकि, मेरी राय में, सबसे सही और तेज़ और स्थिर परिणाम आपके स्वयं के सर्वर से डाउनलोड हो रहा है (वही जहाँ से फ़ाइलें डाउनलोड की जाएँगी) एक छोटी फ़ाइल। यह कैसे करना है यह ऊपर पाठ के साथ काम करने वाले अनुभाग में वर्णित है।
इंटरनेट एक्सेस होने के तथ्य की जांच करने के अलावा, इसके प्रकार (मोबाइल या वाईफाई) को निर्धारित करना भी आवश्यक है, क्योंकि यह संभावना नहीं है कि एक खिलाड़ी मोबाइल ट्रैफ़िक पर कई सौ मेगाबाइट डाउनलोड करना चाहेगा। यह Application.internetReachability प्रॉपर्टी के जरिए किया जा सकता है।

कैशिंग

अगला, और सबसे महत्वपूर्ण मुद्दों में से एक, डाउनलोड की गई फ़ाइलों का कैशिंग है। यह कैशिंग किस लिए है?

ट्रैफ़िक सहेजें (पहले से डाउनलोड किए गए डेटा को डाउनलोड न करें)
इंटरनेट की अनुपस्थिति में काम सुनिश्चित करना (आप कैश से डेटा दिखा सकते हैं)।

कैश्ड होने की क्या जरूरत है? इस प्रश्न का उत्तर सब कुछ है, आपके द्वारा डाउनलोड की जाने वाली सभी फाइलें कैश होनी चाहिए। ऐसा कैसे करें, नीचे विचार करें, और सरल पाठ फ़ाइलों के साथ शुरू करें।
दुर्भाग्य से, एकता में पाठ को कैशिंग, साथ ही साथ बनावट और ऑडियो फ़ाइलों के लिए एक अंतर्निहित तंत्र नहीं है। इसलिए, इन संसाधनों के लिए, आपको अपने सिस्टम को लिखना चाहिए, या प्रोजेक्ट की जरूरतों के आधार पर नहीं लिखना चाहिए। सरलतम मामले में, हम केवल फ़ाइल को कैश में लिखते हैं और, इंटरनेट की अनुपस्थिति में, हम फ़ाइल को इससे लेते हैं। थोड़े अधिक जटिल संस्करण में (मैं परियोजनाओं में इसका उपयोग करता हूं), हम सर्वर को एक अनुरोध भेजते हैं, जो सर्वर पर संग्रहीत फ़ाइलों के संस्करणों को इंगित करते हुए जसन देता है। आप फ़ाइल वर्ग के C # वर्ग का उपयोग करके या अपनी टीम द्वारा सुविधाजनक और स्वीकृत किसी अन्य तरीके से कैश से फाइलें लिख और पढ़ सकते हैं।

 private void CacheText(string fileName, string data) { var cacheFilePath = Path.Combine("CachePath", "{0}.text".Fmt(fileName)); File.WriteAllText(cacheFilePath, data); } private void CacheTexture(string fileName, byte[] data) { var cacheFilePath = Path.Combine("CachePath", "{0}.texture".Fmt(fileName)); File.WriteAllBytes(cacheFilePath, data); }

इसी तरह, कैश से डेटा प्राप्त करना।

 private string GetTextFromCache(string fileName) { var cacheFilePath = Path.Combine(Utils.Path.Cache, "{0}.text".Fmt(fileName)); if (File.Exists(cacheFilePath)) { return File.ReadAllText(cacheFilePath); } return null; } private Texture2D GetTextureFromCache(string fileName) { var cacheFilePath = Path.Combine(Utils.Path.Cache, "{0}.texture".Fmt(fileName)); Texture2D texture = null; if (File.Exists(cacheFilePath)) { var data = File.ReadAllBytes(cacheFilePath); texture = new Texture2D(1, 1); texture.LoadImage(data, true); } return texture; }

नोट : एक ही UWR फॉर्म फाइल के url के साथ: // का उपयोग बनावट लोड करने के लिए नहीं किया जाता है फिलहाल, इसके साथ समस्याएं हैं, फ़ाइल बस लोड नहीं करती है, इसलिए मुझे वर्कअराउंड ढूंढना पड़ा।

नोट : मैं परियोजनाओं में ऑडियोक्लिप के सीधे लोडिंग का उपयोग नहीं करता हूं, मैं एसेटबंडल में ऐसे सभी डेटा संग्रहीत करता हूं। हालाँकि, यदि आवश्यक हो, तो यह आसानी से ऑडियोक्लिप क्लास गेटडाटा और सेटडाटा के कार्यों का उपयोग करके किया जा सकता है।

असिटबंडल के लिए एकता के सरल संसाधन, एकता में एक अंतर्निहित कैशिंग तंत्र है। आइए इसे और अधिक विस्तार से विचार करें।

असल में, यह तंत्र दो तरीकों का उपयोग कर सकता है:

सीआरसी और संस्करण संख्या का उपयोग करना
हैश वैल्यू का उपयोग करना

सिद्धांत रूप में, आप उनमें से किसी का भी उपयोग कर सकते हैं, लेकिन मैंने खुद के लिए फैसला किया कि हैश सबसे स्वीकार्य है, क्योंकि मेरे पास अपना स्वयं का संस्करण सिस्टम है और यह न केवल AssetBundle संस्करण को ध्यान में रखता है , बल्कि एप्लिकेशन का संस्करण भी है, क्योंकि अक्सर बंडल संस्करण के साथ संगत नहीं हो सकता है; दुकानों में प्रस्तुत किया।

तो, कैशिंग कैसे किया जाता है:

हम मैनिफ़ेस्ट सर्वर से एक बंडल फ़ाइल का अनुरोध करते हैं (यह फ़ाइल तब बनाई जाती है जब इसे बनाया जाता है और इसमें शामिल परिसंपत्तियों का विवरण होता है, साथ ही हैश, crc, size, आदि)। फ़ाइल में बंडल प्लस .manifest एक्सटेंशन के समान नाम है।
प्रकट से hash128 मान प्राप्त करें
हम सर्वर से एक एसेटबंडल प्राप्त करने के लिए अनुरोध करते हैं, जहां यूआरएल के अलावा, प्राप्त हैश128 मान निर्दिष्ट करें

ऊपर वर्णित एल्गोरिथ्म के लिए कोड:

 IEnumerator LoadAssetBundleFromServerWithCache(string url, Action<AssetBundle> response) { // ,    while (!Caching.ready) { yield return null; } //     var request = UnityWebRequest.Get(url + ".manifest"); yield return request.SendWebRequest(); if (!request.isHttpError && !request.isNetworkError) { Hash128 hash = default; // hash var hashRow = request.downloadHandler.text.ToString().Split("\n".ToCharArray())[5]; hash = Hash128.Parse(hashRow.Split(':')[1].Trim()); if (hash.isValid == true) { request.Dispose(); request = UnityWebRequestAssetBundle.GetAssetBundle(url, hash, 0); yield return request.SendWebRequest(); if (!request.isHttpError && !request.isNetworkError) { response(DownloadHandlerAssetBundle.GetContent(request)); } else { response(null); } } else { response(null); } } else { response(null); } request.Dispose(); }

उपरोक्त उदाहरण में, सर्वर के अनुरोध पर, एकता, पहले यह देखना चाहती है कि निर्दिष्ट हैश128 मूल्य के साथ कैश में कोई फ़ाइल है, यदि यह है, तो इसे वापस कर दिया जाएगा; यदि नहीं, तो अद्यतन फ़ाइल डाउनलोड की जाएगी। एकता में सभी कैश फ़ाइलों को प्रबंधित करने के लिए, एक कैशिंग क्लास है, जिसके साथ हम यह पता लगा सकते हैं कि क्या कैश में कोई फ़ाइल है, सभी कैश्ड संस्करण प्राप्त करें, साथ ही अनावश्यक लोगों को हटा दें, या इसे पूरी तरह से हटा दें।

नोट : हैश वैल्यू पाने का इतना अजीब तरीका क्यों? यह इस तथ्य के कारण है कि दस्तावेज़ीकरण में वर्णित तरीके से hash128 प्राप्त करने के लिए पूरे बंडल को लोड करने की आवश्यकता होती है, और उसके बाद और इससे पहले से ही हैश मानों से AssetBundleManifest संपत्ति प्राप्त करना आवश्यक है । इस दृष्टिकोण के नकारात्मक पक्ष यह है कि संपूर्ण एसेटबंडल स्विंग हो रहा है, लेकिन हमें सिर्फ यह नहीं होना चाहिए। इसलिए, हम पहले सर्वर से केवल मेनिफ़ेस्ट फ़ाइल डाउनलोड करते हैं, उसमें से हैश128 लेते हैं, और उसके बाद ही, यदि आवश्यक हो, तो बंडल फ़ाइल डाउनलोड करें, और हैश128 मान को लाइनों की व्याख्या के माध्यम से निकाला जाना चाहिए।

संपादक मोड में संसाधनों के साथ काम करें

अंतिम समस्या, या बल्कि डिबगिंग और विकास सुविधा का मुद्दा, संपादक मोड में डाउनलोड करने योग्य संसाधनों के साथ काम कर रहा है, अगर नियमित फ़ाइलों के साथ कोई समस्या नहीं है, तो बंडल के साथ चीजें इतनी सरल नहीं हैं। बेशक, आप हर बार उनके निर्माण का निर्माण कर सकते हैं, इसे सर्वर पर अपलोड कर सकते हैं और एकता संपादक में एप्लिकेशन लॉन्च कर सकते हैं और देख सकते हैं कि सब कुछ कैसे काम करता है, लेकिन यहां तक कि यह विवरण "बैसाखी" जैसा लगता है। इसके साथ कुछ करने की आवश्यकता है और इसके लिए एसेटडाटबेस वर्ग हमारी मदद करेगा।

बंडलों के साथ काम को एकजुट करने के लिए मैंने एक विशेष आवरण बनाया:

 public class AssetBundleWrapper { private readonly AssetBundle _assetBundle; public AssetBundleWrapper(AssetBundle assetBundle) { _assetBundle = assetBundle; } }

अब हमें संपत्ति के साथ काम करने के दो तरीके जोड़ने होंगे, यह इस बात पर निर्भर करता है कि हम संपादक में हैं या निर्माण में। बिल्ड के लिए, हम एसेटबंडल क्लास के फंक्शन्स के लिए रैपर का उपयोग करते हैं, और एडिटर के लिए हम ऊपर बताए गए एसेटडाटबेस का उपयोग करते हैं।

इस प्रकार, हम निम्नलिखित कोड प्राप्त करते हैं:

 public class AssetBundleWrapper { #if UNITY_EDITOR private readonly List<string> _assets; public AssetBundleWrapper(string url) { var uri = new Uri(url); var bundleName = Path.GetFileNameWithoutExtension(uri.LocalPath); _assets = new List<string>(AssetDatabase.GetAssetPathsFromAssetBundle(bundleName)); } public T LoadAsset<T>(string name) where T : UnityEngine.Object { var assetPath = _assets.Find(item => { var assetName = Path.GetFileNameWithoutExtension(item); return string.CompareOrdinal(name, assetName) == 0; }); if (!string.IsNullOrEmpty(assetPath)) { return AssetDatabase.LoadAssetAtPath<T>(assetPath); } else { return default; } } public T[] LoadAssets<T>() where T : UnityEngine.Object { var returnedValues = new List<T>(); foreach(var assetPath in _assets) { returnedValues.Add(AssetDatabase.LoadAssetAtPath<T>(assetPath)); } return returnedValues.ToArray(); } public void LoadAssetAsync<T>(string name, Action<T> result) where T : UnityEngine.Object { result(LoadAsset<T>(name)); } public void LoadAssetsAsync<T>(Action<T[]> result) where T : UnityEngine.Object { result(LoadAssets<T>()); } public string[] GetAllScenePaths() { return _assets.ToArray(); } public void Unload(bool includeAllLoadedAssets = false) { _assets.Clear(); } #else private readonly AssetBundle _assetBundle; public AssetBundleWrapper(AssetBundle assetBundle) { _assetBundle = assetBundle; } public T LoadAsset<T>(string name) where T : UnityEngine.Object { return _assetBundle.LoadAsset<T>(name); } public T[] LoadAssets<T>() where T : UnityEngine.Object { return _assetBundle.LoadAllAssets<T>(); } public void LoadAssetAsync<T>(string name, Action<T> result) where T : UnityEngine.Object { var request = _assetBundle.LoadAssetAsync<T>(name); TaskManager.Task.Create(request) .Subscribe(() => { result(request.asset as T); Unload(false); }) .Start(); } public void LoadAssetsAsync<T>(Action<T[]> result) where T : UnityEngine.Object { var request = _assetBundle.LoadAllAssetsAsync<T>(); TaskManager.Task.Create(request) .Subscribe(() => { var assets = new T[request.allAssets.Length]; for (var i = 0; i < request.allAssets.Length; i++) { assets[i] = request.allAssets[i] as T; } result(assets); Unload(false); }) .Start(); } public string[] GetAllScenePaths() { return _assetBundle.GetAllScenePaths(); } public void Unload(bool includeAllLoadedAssets = false) { _assetBundle.Unload(includeAllLoadedAssets); } #endif }

नोट : कोड टास्कमैनगर क्लास का उपयोग करता है, यह नीचे चर्चा की जाएगी, संक्षेप में, यह कोरटाइन के साथ काम करने के लिए एक आवरण है।

उपरोक्त के अलावा, यह विकास के दौरान भी उपयोगी है कि हमने क्या डाउनलोड किया और वर्तमान में कैश में क्या है। इस उद्देश्य के लिए, आप अपने स्वयं के फ़ोल्डर को सेट करने की क्षमता का लाभ उठा सकते हैं, जिसका उपयोग कैशिंग के लिए किया जाएगा (आप उसी फ़ोल्डर में डाउनलोड किए गए पाठ और अन्य फाइलें भी लिख सकते हैं):

 #if UNITY_EDITOR var path = Path.Combine(Directory.GetParent(Application.dataPath).FullName, "_EditorCache"); #else var path = Path.Combine(Application.persistentDataPath, "_AppCache"); #endif Caching.currentCacheForWriting = Caching.AddCache(path);

हम एक नेटवर्क अनुरोध प्रबंधक लिखते हैं या वेब सर्वर के साथ काम करते हैं

ऊपर हमने एकता में बाहरी संसाधनों के साथ काम करने के मुख्य पहलुओं की जांच की, अब मैं एपीआई के कार्यान्वयन पर ध्यान देना चाहूंगा, जो उपरोक्त सभी को सामान्य और एकीकृत करता है। और पहले, चलो नेटवर्क क्वेरी मैनेजर पर रहते हैं।

ध्यान दें : इसके बाद, हम टास्कमैन क्लास के रूप में कोराउटिन पर रैपर का उपयोग करते हैं। मैंने एक अन्य लेख में इस आवरण के बारे में लिखा है ।

चलो इसी वर्ग प्राप्त करें:

 public class Network { public enum NetworkTypeEnum { None, Mobile, WiFi } public static NetworkTypeEnum NetworkType; private readonly TaskManager _taskManager = new TaskManager(); }

NetworkType स्थैतिक क्षेत्र को इंटरनेट कनेक्शन के प्रकार के बारे में जानकारी प्राप्त करने के लिए आवेदन की आवश्यकता होती है। सिद्धांत रूप में, यह मूल्य कहीं भी संग्रहीत किया जा सकता है, मैंने फैसला किया कि यह नेटवर्क वर्ग में जगह है।

सर्वर से अनुरोध भेजने का मूल कार्य जोड़ें:

 private IEnumerator WebRequest(UnityWebRequest request, Action<float> progress, Action<UnityWebRequest> response) { while (!Caching.ready) { yield return null; } if (progress != null) { request.SendWebRequest(); _currentRequests.Add(request); while (!request.isDone) { progress(request.downloadProgress); yield return null; } progress(1f); } else { yield return request.SendWebRequest(); } response(request); if (_currentRequests.Contains(request)) { _currentRequests.Remove(request); } request.Dispose(); }

जैसा कि आप कोड से देख सकते हैं, पिछले अनुभागों में कोड की तुलना में अनुरोध को पूरा करने की प्रक्रिया को बदलने की विधि बदल गई है। यह डेटा लोडिंग की प्रगति दिखाने के लिए है। इसके अलावा, भेजे गए सभी अनुरोधों को एक सूची में संग्रहीत किया जाता है ताकि, यदि आवश्यक हो, तो उन्हें रद्द किया जा सके।

AssetBundle के लिए लिंक-आधारित क्वेरी निर्माण फ़ंक्शन जोड़ें:

 private IEnumerator WebRequestBundle(string url, Hash128 hash, Action<float> progress, Action<UnityWebRequest> response) { var request = UnityWebRequestAssetBundle.GetAssetBundle(url, hash, 0); return WebRequest(request, progress, response); }

इसी तरह, बनावट, ऑडियो, पाठ, बाइट सरणी के लिए फ़ंक्शन बनाए जाते हैं।

अब आपको यह सुनिश्चित करने की आवश्यकता है कि सर्वर पोस्ट कमांड के माध्यम से डेटा भेजता है। अक्सर आपको सर्वर से कुछ पारित करने की आवश्यकता होती है, और वास्तव में क्या होता है, इसके आधार पर, एक उत्तर प्राप्त करें उपयुक्त कार्य जोड़ें।

कुंजी-मूल्य सेट के रूप में डेटा भेजना:

 private IEnumerator WebRequestPost(string url, Dictionary<string, string> formFields, Action<float> progress, Action<UnityWebRequest> response) { var request = UnityWebRequest.Post(url, formFields); return WebRequest(request, progress, response); }

डेटा को json के रूप में भेजना:

 private IEnumerator WebRequestPost(string url, string data, Action<float> progress, Action<UnityWebRequest> response) { var request = new UnityWebRequest(url, UnityWebRequest.kHttpVerbPOST) { uploadHandler = new UploadHandlerRaw(Encoding.UTF8.GetBytes(data)), downloadHandler = new DownloadHandlerBuffer() }; request.uploadHandler.contentType = "application/json"; return WebRequest(request, progress, response); }

अब हम सार्वजनिक तरीकों को जोड़ेंगे, जिसके साथ हम विशेष रूप से AssetBundle में डेटा लोड करेंगे

 public void Request(string url, Hash128 hash, Action<float> progress, Action<AssetBundle> response, TaskManager.TaskPriorityEnum priority = TaskManager.TaskPriorityEnum.Default) { _taskManager.AddTask(WebRequestBundle(url, hash, progress, (uwr) => { if (!uwr.isHttpError && !uwr.isNetworkError) { response(DownloadHandlerAssetBundle.GetContent(uwr)); } else { Debug.LogWarningFormat("[Netowrk]: error request [{0}]", uwr.error); response(null); } }), priority); }

इसी तरह, बनावट, ऑडियो फ़ाइल, पाठ आदि के लिए तरीके जोड़े जाते हैं।

और अंत में, हम डाउनलोड किए गए फ़ाइल के आकार को प्राप्त करने और सभी बनाए गए अनुरोधों को रोकने के लिए सफाई फ़ंक्शन को जोड़ते हैं।

 public void Request(string url, Action<int> response, TaskManager.TaskPriorityEnum priority = TaskManager.TaskPriorityEnum.Default) { var request = UnityWebRequest.Head(url); _taskManager.AddTask(WebRequest(request, null, uwr => { var contentLength = uwr.GetResponseHeader("Content-Length"); if (int.TryParse(contentLength, out int returnValue)) { response(returnValue); } else { response(-1); } }), priority); } public void Clear() { _taskManager.Clear(); foreach (var request in _currentRequests) { request.Abort(); request.Dispose(); } _currentRequests.Clear(); }

इस पर, नेटवर्क अनुरोधों के साथ काम करने के लिए हमारा प्रबंधक पूरा हो गया है। यदि आवश्यक हो, तो गेम के प्रत्येक सबसिस्टम को सर्वर के साथ काम करने की आवश्यकता होती है जो कक्षा के अपने स्वयं के उदाहरण बना सकते हैं।

हम बाहरी संसाधनों को लोड करने के प्रबंधक को लिखते हैं

ऊपर वर्णित वर्ग के अलावा, बाहरी डेटा के साथ पूरी तरह से काम करने के लिए, हमें एक अलग प्रबंधक की आवश्यकता है जो न केवल डेटा को डाउनलोड करेगा, बल्कि लोडिंग, पूर्णता, प्रगति, खाली स्थान की कमी, और कैशिंग मुद्दों से निपटने के बारे में भी एप्लिकेशन को सूचित करेगा।

हम इसी वर्ग को शुरू करते हैं, जो मेरे मामले में एक सिंगलटन है

 public class ExternalResourceManager { public enum ResourceEnumType { Text, Texture, AssetBundle } private readonly Network _network = new Network(); public void ExternalResourceManager() { #if UNITY_EDITOR var path = Path.Combine(Directory.GetParent(Application.dataPath).FullName, "_EditorCache"); #else var path = Path.Combine(Application.persistentDataPath, "_AppCache"); #endif if (!System.IO.Directory.Exists(path)) { System.IO.Directory.CreateDirectory(path); #if UNITY_IOS UnityEngine.iOS.Device.SetNoBackupFlag(path); #endif } Caching.currentCacheForWriting = Caching.AddCache(path); } }

जैसा कि आप देख सकते हैं, डिजाइनर कैशिंग के लिए फ़ोल्डर सेट करता है, इस पर निर्भर करता है कि हम संपादक में हैं या नहीं। इसके अलावा, हमने नेटवर्क क्लास के उदाहरण के लिए एक निजी फ़ील्ड सेट किया है, जिसे हमने पहले वर्णित किया था।

अब हम कैश के साथ काम करने के लिए सहायक कार्यों को जोड़ेंगे, साथ ही डाउनलोड की गई फ़ाइल का आकार निर्धारित करेंगे और इसके लिए खाली स्थान की जांच करेंगे। इसके अलावा और नीचे, कोड AssetBundle के साथ काम करने के एक उदाहरण पर दिया गया है, बाकी संसाधनों के लिए सब कुछ सादृश्य द्वारा किया जाता है।

हेल्पर फंक्शन कोड

 public void ClearAssetBundleCache(string url) { var fileName = GetFileNameFromUrl(url); Caching.ClearAllCachedVersions(fileName); } public void ClearAllRequest() { _network.Clear(); } public void AssetBundleIsCached(string url, Action<bool> result) { var manifestFileUrl = "{0}.manifest".Fmt(url); _network.Request(manifestFileUrl, null, (string manifest) => { var hash = string.IsNullOrEmpty(manifest) ? default : GetHashFromManifest(manifest); result(Caching.IsVersionCached(url, hash)); } , TaskManager.TaskPriorityEnum.RunOutQueue); } public void CheckFreeSpace(string url, Action<bool, float> result) { GetSize(url, lengthInMb => { #if UNITY_EDITOR_WIN var logicalDrive = Path.GetPathRoot(Utils.Path.Cache); var availableSpace = SimpleDiskUtils.DiskUtils.CheckAvailableSpace(logicalDrive); #elif UNITY_EDITOR_OSX var availableSpace = SimpleDiskUtils.DiskUtils.CheckAvailableSpace(); #elif UNITY_IOS var availableSpace = SimpleDiskUtils.DiskUtils.CheckAvailableSpace(); #elif UNITY_ANDROID var availableSpace = SimpleDiskUtils.DiskUtils.CheckAvailableSpace(true); #endif result(availableSpace > lengthInMb, lengthInMb); }); } public void GetSize(string url, Action<float> result) { _network.Request(url, length => result(length / 1048576f)); } private string GetFileNameFromUrl(string url) { var uri = new Uri(url); var fileName = Path.GetFileNameWithoutExtension(uri.LocalPath); return fileName; } private Hash128 GetHashFromManifest(string manifest) { var hashRow = manifest.Split("\n".ToCharArray())[5]; var hash = Hash128.Parse(hashRow.Split(':')[1].Trim()); return hash; }

अब AssetBundle उदाहरण का उपयोग करके डेटा लोडिंग फ़ंक्शन जोड़ें।

 public void GetAssetBundle(string url, Action start, Action<float> progress, Action stop, Action<AssetBundleWrapper> result, TaskManager.TaskPriorityEnum taskPriority = TaskManager.TaskPriorityEnum.Default) { #if DONT_USE_SERVER_IN_EDITOR start?.Invoke(); result(new AssetBundleWrapper(url)); stop?.Invoke(); #else void loadAssetBundle(Hash128 bundleHash) { start?.Invoke(); _network.Request(url, bundleHash, progress, (AssetBundle value) => { if(value != null) { _externalResourcesStorage.SetCachedHash(url, bundleHash); } result(new AssetBundleWrapper(value)); stop?.Invoke(); }, taskPriority); }; var manifestFileUrl = "{0}.manifest".Fmt(url); _network.Request(manifestFileUrl, null, (string manifest) => { var hash = string.IsNullOrEmpty(manifest) ? default : GetHashFromManifest(manifest); if (!hash.isValid || hash == default) { hash = _externalResourcesStorage.GetCachedHash(url); if (!hash.isValid || hash == default) { result(new AssetBundleWrapper(null)); } else { loadAssetBundle(hash); } } else { if (Caching.IsVersionCached(url, hash)) { loadAssetBundle(hash); } else { CheckFreeSpace(url, (spaceAvailable, length) => { if (spaceAvailable) { loadAssetBundle(hash); } else { result(new AssetBundleWrapper(null)); NotEnoughDiskSpace.Call(); } }); } } #endif }

तो इस फ़ंक्शन में क्या होता है:

Precompilation निर्देश DONT_USE_SERVER_IN_EDITOR सर्वर से बंडलों के वास्तविक लोडिंग को अक्षम करने के लिए उपयोग किया जाता है।
बंडल के लिए प्रकट फ़ाइल प्राप्त करने के लिए सर्वर से अनुरोध करने के लिए पहला कदम है
- , , - ( _externalResourcesStorage ) , , ( , ), , null
, Caching , , ( )
, , , , - ( ). , ( )

नोट : यह समझना महत्वपूर्ण है कि हैश मान अलग से क्यों संग्रहीत किया जाता है। इस मामले के लिए आवश्यक है जब कोई इंटरनेट नहीं है, या कनेक्शन अस्थिर है, या किसी प्रकार की नेटवर्क त्रुटि थी और हम सर्वर से बंडल डाउनलोड नहीं कर सके, इस मामले में हम कैश से बंडल डाउनलोड करने की गारंटी देते हैं यदि यह वहां मौजूद है ।

इसी तरह, ऊपर वर्णित विधि में, प्रबंधक में, आपको डेटा के साथ काम करने के लिए अन्य कार्यों को प्राप्त करने की आवश्यकता हो सकती है: GetJson, GetTexture, GetText, GetAudio, आदि।

और अंत में, आपको एक विधि प्राप्त करने की आवश्यकता है जो आपको संसाधन सेट डाउनलोड करने की अनुमति देता है। यह विधि उपयोगी होगी यदि हमें एप्लिकेशन के प्रारंभ में कुछ डाउनलोड या अपडेट करने की आवश्यकता है।

 public void GetPack(Dictionary<string, ResourceEnumType> urls, Action start, Action<float> progress, Action stop, Action<string, object, bool> result) { var commonProgress = (float)urls.Count; var currentProgress = 0f; var completeCounter = 0; void progressHandler(float value) { currentProgress += value; progress?.Invoke(currentProgress / commonProgress); }; void completeHandler() { completeCounter++; if (completeCounter == urls.Count) { stop?.Invoke(); } }; start?.Invoke(); foreach (var url in urls.Keys) { var resourceType = urls[url]; switch (resourceType) { case ResourceEnumType.Text: { GetText(url, null, progressHandler, completeHandler, (value, isCached) => { result(url, value, isCached); }); } break; case ResourceEnumType.Texture: { GetTexture(url, null, progressHandler, completeHandler, (value, isCached) => { result(url, value, isCached); }); } break; case ResourceEnumType.AssetBundle: { GetAssetBundle(url, null, progressHandler, completeHandler, (value) => { result(url, value, false); }); } break; } } }

यहां यह टास्कमैनगर की ख़ासियत को समझने के लायक है , जो नेटवर्क अनुरोध प्रबंधक में डिफ़ॉल्ट रूप से काम करता है, बारी-बारी से सभी कार्यों का प्रदर्शन करता है। इसलिए, फ़ाइलों का डाउनलोड तदनुसार होगा।

नोट : उन लोगों के लिए जो कॉरटीन पसंद नहीं करते हैं , सब कुछ आसानी से async / इंतजार में अनुवाद किया जा सकता है , लेकिन इस मामले में, लेख में, मैंने शुरुआती लोगों के लिए एक और अधिक समझने योग्य विकल्प का उपयोग करने का फैसला किया (जैसा कि यह मुझे लगता है)।

निष्कर्ष

इस लेख में, मैंने गेमिंग एप्लिकेशन के बाहरी संसाधनों के साथ यथासंभव कॉम्पैक्ट रूप से काम करने का वर्णन करने का प्रयास किया। यह दृष्टिकोण और कोड उन परियोजनाओं में उपयोग किया जाता है जो जारी किए गए हैं और मेरी भागीदारी के साथ विकसित किए जा रहे हैं। यह काफी सरल और सरल गेमों में लागू होता है, जहां सर्वर (MMO और अन्य जटिल f2p गेम्स) के साथ कोई निरंतर संचार नहीं होता है, लेकिन यह काम को बहुत सुविधाजनक बनाता है यदि हमें अतिरिक्त सामग्री, भाषाओं को डाउनलोड करने, सर्वर-साइड सत्यापन को खरीदने और अन्य कार्यों को लागू करने की आवश्यकता है एक बार या नहीं भी अक्सर आवेदन में इस्तेमाल किया।

लेख में दिए गए लिंक :
परिसंपत्ति
भंडार ।unity.com / packages/ tools / simple- disk- utils- 59382 habr.com/post/352296
habr.com/post/282524

यूनिटी 3 डी में बाहरी संसाधनों के साथ काम करना