संदर्भ दायरा#
सूची में ज्ञात सार्वजनिक X4 मॉडिंग इंटरफ़ेस का वर्णन किया गया है। एक पहचान नाम अपने पूरे अनुबंध को स्थापित नहीं करता है या खेल में निष्पादन का प्रमाण नहीं देता है। मॉड फ़ाइलें, आंतरिक दस्तावेज और पूर्ण स्रोत फ़ाइलें वितरित नहीं की जाती हैं।
प्रमाण प्रकार#
| साक्ष्य | स्थापित करता है | अभी भी सत्यापन की आवश्यकता है |
|---|---|---|
| C घोषणा | पैरामीटर क्रम, प्रकार C और प्रकार C रिटर्न | निर्यात, एबीआई, संदर्भ, स्मृति स्वामित्व और जीवनकाल |
| X4 XSD | विशेषता नाम, अभिव्यक्ति प्रकार और आवश्यक विशेषताएं | मूल्यांकन किए गए प्रकार, घटनाओं के उपयोगिता भार और खेल प्रभाव |
| Lua 5.1 / LuaJIT | मानक पुस्तकालय अनुबंध | वर्तमान X4 वातावरण में उपलब्धता और विस्तार |
| विशिष्ट इवेंट का दस्तावेज़ | कॉलबैक तर्क और फ़ील्ड अर्थ | संस्करण, पंजीकरण समय और वस्तु जीवनकाल |
expression स्कीमा प्रकार MD एक्सप्रेशन बताता है, गणना के बाद मिलने वाले मान का प्रकार नहीं। फ़िल्टर एट्रिब्यूट event.param के प्रकार घोषित नहीं करते। परिणाम का उपयोग न होना none, void या nil का प्रमाण नहीं है।
पढ़ने के परिणाम#
Lua कई मानों को वापस कर सकता है। आर्कटिक परिणाम स्थानों को अलग करता है; एक ऊर्ध्वाधर पट्टी विकल्पों को अलग करती है। अज्ञात का अर्थ है एक अस्थिर अनुबंध, जबकि कोई भी संदर्भ पर निर्भर करता है। कोई भी और शून्य प्रत्यक्ष रिटर्न का संकेत नहीं देता है, लेकिन प्रभाव और आउटपुट बफर अभी भी मौजूद हो सकते हैं।
C प्रकार हमेशा अपने Lua प्रतिनिधित्व से मेल नहीं खाते हैं। एक पॉइंटर cdata है; जब मेमोरी लाइफटाइम स्थापित होता है तो ffi.string एक C स्ट्रिंग को Lua स्ट्रिंग में कॉपी करता है। सटीकता के नुकसान के साथ आईडी को परिवर्तित न करें। देखिये प्रकार और विधि, पहचानकर्ता और cdata.
इवेंट और सदस्यताएँ#
| तंत्र | उपयोग |
|---|---|
| Lua इवेंट | उपयुक्त UI संदर्भ में सटीक नाम और कॉलबैक के साथ RegisterEvent |
| एमडी से UI | सीईओ की स्थिति में event_ui_triggered |
| MD इंजन इवेंट | इसकी घटना_* स्थिति और सटीक फ़िल्टर |
इन मार्गों के अलग-अलग अनुबंध हैं। RegisterEvent के साथ MD घटना नाम का स्वचालित रूप से उपयोग नहीं किया जा सकता है। संदर्भ के अनुसार एक बार पंजीकृत करें; सटीक प्रेषक के लिए कॉलबैक प्रकार और गणना निर्धारित करें। इन Lua / MD पुल एक स्वतंत्र शिक्षा उदाहरण प्रदान करता है।
उदाहरण और सत्यापन#
सीखने के टुकड़ों को संदर्भ, चर और जीवन चक्र की आवश्यकता होती है। यह दावा नहीं किया जाता है कि वे बिना दस्तावेज किए प्रयोग के खेल में भाग गए हैं। अधूरे अनुबंध स्पष्ट सीमाओं को बनाए रखते हैं; बफर आकार या उपयोगिता भार के आकार का आविष्कार न करें।
शुरू करें एपीआई सूचकांक. मुक़द्दमाएक अनुबंध में सुधार के लिए, खेल संस्करण, एक प्राथमिक सार्वजनिक स्रोत और एक छोटे से स्वतंत्र उदाहरण प्रदान करें योगदान.