👩🏽‍🏭 🙅🏼 🆙 इवेंट यूनिटी 3 डी के लिए इवेंट एग्रीगेटर 🕴️ 🤛🏽 🔤

यूनिटी 3 डी के लिए अपने स्वयं के विस्तारित इवेंट एग्रीगेटर को लिखने का विचार लंबे समय से है। इस विषय पर कई लेखों को पढ़ने के बाद, मैंने महसूस किया कि पर्याप्त "सही" (यूनिटी 3 डी के भीतर) नहीं है और एग्रीगेटर जो मेरे लिए आवश्यक है, सभी समाधान छीन लिए गए हैं और आवश्यक कार्यक्षमता नहीं है।

आवश्यक कार्यशीलता:

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

इसे कहां लगाना है

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

कमजोर अंक

मृत ग्राहकों और चेक पर चेक के कारण (मैं बाद में प्रकट करूँगा) कोड समान समाधानों की तुलना में धीमा है
क्लास / स्ट्रक्चर का उपयोग ईवेंट के मूल के रूप में किया जाता है, ताकि मेमोरी + शीर्ष समस्या का आवंटन न हो, इसे अपडेट में स्पैम ईवेंट के लिए अनुशंसित नहीं किया जाता है)

सामान्य विचारधारा

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

मेरे मामले में ईवेंट बॉडी / डेटा पैकेट कैसा दिखता है:

घटना शरीर उदाहरण

public struct ClickOnButtonEvent   {     public int ButtonID; //     enum    }

ईवेंट सदस्यता कैसी दिखती है:

 public static void AddListener<T>(object listener, Action<T> action)

सदस्यता लेने के लिए, हमें यह निर्दिष्ट करना होगा:
एक ऑब्जेक्ट जो एक सब्सक्राइबर है (आमतौर पर यह वह वर्ग होता है जिसमें सब्सक्रिप्शन होता है, लेकिन यह आवश्यक नहीं है, सब्सक्राइबर क्लास फील्ड्स में से एक क्लास इंस्टेंसेस को निर्दिष्ट कर सकता है।
वह प्रकार / घटना जिसकी हम सदस्यता ले रहे हैं। यह इस एग्रीगेटर का प्रमुख सार है, हमारे लिए एक निश्चित प्रकार की कक्षा एक घटना है जिसे हम सुनते हैं और प्रक्रिया करते हैं।
जागो और OnEnable में सबसे अच्छी सदस्यता;

उदाहरण

 public class Example : MonoBehaviour { private void Awake() { EventAggregator.AddListener<ClickOnButtonEvent>(this, ClickButtonListener); } private void ClickButtonListener(ClickOnButtonEvent obj) { Debug.Log("  " + obj.ButtonID); } }

यह स्पष्ट करने के लिए कि चिप क्या है, अधिक जटिल मामले पर विचार करें

हमारे पास चरित्र चिह्न हैं:

जानिए वो किस किरदार से जुड़ी हैं।
मन, एचपी, ऍक्स्प और स्थिति (अचेत, अंधापन, भय, पागलपन) की मात्रा को प्रतिबिंबित करें

और यहां आप कई ईवेंट कर सकते हैं

संकेतक बदलने के लिए:

 public struct CharacterStateChanges { public Character Character; public float Hp; public float Mp; public float Xp; }

नकारात्मक स्थिति बदलने के लिए:

 public struct CharacterNegativeStatusEvent { public Character Character; public Statuses Statuses; //enum  }

हम दोनों ही मामलों में चरित्र वर्ग क्यों पास करते हैं? यहाँ घटना ग्राहक और उसके हैंडलर है:

 private void Awake() { EventAggregator.AddListener<CharacterNegativeStatusEvent> (this, CharacterNegativeStatusListener); } private void CharacterNegativeStatusListener(CharacterNegativeStatusEvent obj) { if (obj.Character != _character) return; _currentStatus = obj.Statuses; }

यह वह मार्कर है जिसके द्वारा हम घटना को संसाधित करते हैं और समझते हैं कि वास्तव में हमें इसकी क्या आवश्यकता है।
मान लीजिए कि आप सीधे वर्ण वर्ग की सदस्यता क्यों नहीं लेते? और उन्हें स्पैम करें?
पदार्पण करना कठिन होगा, वर्गों / आयोजनों के समूह के लिए बेहतर होगा कि वे अपना अलग आयोजन करें।

क्यों, फिर से, घटना के अंदर, बस चरित्र नहीं डालते हैं और इससे सब कुछ लेते हैं?
तो वैसे यह संभव है, लेकिन अक्सर कक्षाओं में दृश्यता प्रतिबंध होते हैं, और घटना के लिए आवश्यक डेटा बाहर से दिखाई नहीं दे सकता है।

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

हुड के नीचे क्या है और यह कैसे काम करता है?

सीधे एग्रीगेटर कोड

 namespace GlobalEventAggregator public delegate void EventHandler<T>(T e); { public class EventContainer<T> : IDebugable { private event EventHandler<T> _eventKeeper; private readonly Dictionary<WeakReference, EventHandler<T>> _activeListenersOfThisType = new Dictionary<WeakReference, EventHandler<T>>(); private const string Error = "null"; public bool HasDuplicates(object listener) { return _activeListenersOfThisType.Keys.Any(k => k.Target == listener); } public void AddToEvent(object listener, EventHandler<T> action) { var newAction = new WeakReference(listener); _activeListenersOfThisType.Add(newAction, action); _eventKeeper += _activeListenersOfThisType[newAction]; } public void RemoveFromEvent(object listener) { var currentEvent = _activeListenersOfThisType.Keys.FirstOrDefault(k => k.Target == listener); if (currentEvent != null) { _eventKeeper -= _activeListenersOfThisType[currentEvent]; _activeListenersOfThisType.Remove(currentEvent); } } public EventContainer(object listener, EventHandler<T> action) { _eventKeeper += action; _activeListenersOfThisType.Add(new WeakReference(listener), action); } public void Invoke(T t) { if (_activeListenersOfThisType.Keys.Any(k => k.Target.ToString() == Error)) { var failObjList = _activeListenersOfThisType.Keys.Where(k => k.Target.ToString() == Error).ToList(); foreach (var fail in failObjList) { _eventKeeper -= _activeListenersOfThisType[fail]; _activeListenersOfThisType.Remove(fail); } } if (_eventKeeper != null) _eventKeeper(t); return; } public string DebugInfo() { string info = string.Empty; foreach (var c in _activeListenersOfThisType.Keys) { info += c.Target.ToString() + "\n"; } return info; } } public static class EventAggregator { private static Dictionary<Type, object> GlobalListeners = new Dictionary<Type, object>(); static EventAggregator() { SceneManager.sceneUnloaded += ClearGlobalListeners; } private static void ClearGlobalListeners(Scene scene) { GlobalListeners.Clear(); } public static void AddListener<T>(object listener, Action<T> action) { var key = typeof(T); EventHandler<T> handler = new EventHandler<T>(action); if (GlobalListeners.ContainsKey(key)) { var lr = (EventContainer<T>)GlobalListeners[key]; if (lr.HasDuplicates(listener)) return; lr.AddToEvent(listener, handler); return; } GlobalListeners.Add(key, new EventContainer<T>(listener, handler)); } public static void Invoke<T>(T data) { var key = typeof(T); if (!GlobalListeners.ContainsKey(key)) return; var eventContainer = (EventContainer<T>)GlobalListeners[key]; eventContainer.Invoke(data); } public static void RemoveListener<T>(object listener) { var key = typeof(T); if (GlobalListeners.ContainsKey(key)) { var eventContainer = (EventContainer<T>)GlobalListeners[key]; eventContainer.RemoveFromEvent(listener); } } public static string DebugInfo() { string info = string.Empty; foreach (var listener in GlobalListeners) { info += "     " + listener.Key.ToString() + "\n"; var t = (IDebugable)listener.Value; info += t.DebugInfo() + "\n"; } return info; } } public interface IDebugable { string DebugInfo(); } }

चलो मुख्य के साथ शुरू करते हैं

यह एक शब्दकोश है जिसमें कुंजी टाइप है और मूल्य कंटेनर है

 public class EventContainer<T> : IDebugable

 private static Dictionary<Type, object> GlobalListeners = new Dictionary<Type, object>();

हम कंटेनर को ऑब्जेक्ट के रूप में क्यों स्टोर करते हैं? डिक्शनरी में जेनरिक को स्टोर करने का तरीका नहीं पता है। लेकिन कुंजी के कारण, हम ऑब्जेक्ट को उस प्रकार से जल्दी लाने में सक्षम होते हैं जिस प्रकार की हमें आवश्यकता होती है।

कंटेनर में क्या है?

 private event EventHandler<T> _eventKeeper; private readonly Dictionary<WeakReference, EventHandler<T>> _activeListenersOfThisType = new Dictionary<WeakReference, EventHandler<T>>();

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

जब एक बहु-पक्षीय को बुलाया जाता है, तो यह देखने के लिए एक चेक बनाया जाता है कि क्या मृत चाबियाँ हैं, संग्रह को लाशों से साफ किया जाता है, और फिर संबंधित ग्राहकों के साथ एक बहु-पक्षीय कार्यवाही की जाती है। इसमें समय लगता है, लेकिन फिर से, वास्तव में, यदि घटनाओं की कार्यक्षमता को अलग किया जाता है, तो एक घटना में 3-5 ग्राहक होंगे, इसलिए चेक इतना डरावना नहीं है, आराम का लाभ अधिक स्पष्ट है। नेटवर्क कहानियों के लिए जहां एक हजार या अधिक ग्राहक हो सकते हैं, इस एग्रीगेटर का उपयोग न करना बेहतर है। यद्यपि यह प्रश्न खुला है - यदि आप लाशों के लिए चेक निकालते हैं, जो तेज है - 1k से ग्राहकों की एक सरणी पर पुनरावृत्ति करना या 1k ग्राहकों से एक बहु-प्रतिनिधि को कॉल करना।

उपयोग की विशेषताएं

एक सदस्यता को जागृत में सबसे अच्छा धक्का दिया जाता है।

यदि कोई वस्तु सक्रिय रूप से चालू / बंद हो रही है, तो जाग और ऑनएनेबल की सदस्यता लेना बेहतर है, यह दो बार हस्ताक्षर नहीं करेगा, लेकिन संभावना है कि मृत के लिए एक निष्क्रिय गेम ऑबजेक्ट लिया जाएगा।

चालान की घटनाओं की शुरुआत से पहले बेहतर नहीं है, जब सभी ग्राहक बनाए जाएंगे और पंजीकृत होंगे।

एग्रीगेटर दृश्य की उतराई के समय सूची को साफ करता है। कुछ एग्रीगेटर्स में, दृश्य लोडिंग को साफ करने का सुझाव दिया जाता है - यह एक फ़ाइल है, दृश्य लोडिंग घटना जागने के बाद आती है / OnEnable, जोड़े गए ग्राहकों को हटा दिया जाएगा।

एग्रीगेटर के पास है - पब्लिक स्टैटिक स्ट्रिंग डीबगइन्फो (), आप देख सकते हैं कि किन इवेंट्स के लिए कौन से क्लास सब्सक्राइब किए गए हैं।

गिटहब भंडार

इवेंट यूनिटी 3 डी के लिए इवेंट एग्रीगेटर