FiveM Phone Scripts के लिए कस्टम ऐप्स कैसे बनाएं

Agency Phone App Architecture

Agency Phone is designed with extensibility in mind, allowing server developers to create custom apps that integrate seamlessly with the phone interface. Each app runs as a self-contained module with its own HTML, CSS, and JavaScript, communicating with the phone framework through a well-defined API. This architecture means you can build anything from a racing app to a real estate manager to a custom dispatch system, all accessible from the phone that players already know how to use.

अपने ऐप स्ट्रक्चर को सेट अप करना

कस्टम ऐप बनाने के लिए, Agency Phone ऐप्स निर्देशिका के अंदर एक नया फ़ोल्डर बनाएं। आपके ऐप को एक app.json मैनिफेस्ट फाइल जो ऐप का नाम, आइकन, विवरण, और एंट्री पॉइंट परिभाषित करती है। मैनिफेस्ट उन परमिशन्स को भी निर्दिष्ट करता है जिनकी आपकी ऐप को आवश्यकता होती है, जैसे कि कॉन्टैक्ट्स, नोटिफिकेशन्स, या GPS डेटा तक पहुंच। मैनिफेस्ट में संदर्भित आपका मुख्य HTML फाइल बनाएं, साथ ही कोई भी CSS और JavaScript फाइलें जो आपकी ऐप को चाहिए। फोन फ्रेमवर्क स्वचालित रूप से उन ऐप्स को खोजता और रजिस्टर करता है जो इस संरचना का पालन करते हैं।

एप्लिकेशन API का उपयोग

Agency Phone एक JavaScript API प्रदान करता है जिसका आपका ऐप फोन फीचर्स के साथ इंटरैक्ट करने के लिए उपयोग कर सकता है। कॉल करें AgencyPhone.getContacts() प्लेयर संपर्क सूची तक पहुँचने के लिए, AgencyPhone.sendNotification() सूचनाएं भेजने के लिए, या AgencyPhone.getPlayerData() फ्रेमवर्क से वर्तमान खिलाड़ी जानकारी प्राप्त करने के लिए। API ऐप स्क्रीन के बीच स्विच करने के लिए नेविगेशन विधियाँ, ऐप-विशिष्ट डेटा को स्थायी बनाने के लिए स्टोरेज API, और जीवनचक्र प्रबंधन के लिए इवेंट हुक प्रदान करता है जैसे जब आपका ऐप खुलता है, मिनिमाइज़ होता है, या बंद होता है।

सर्वर-साइड लॉजिक से कनेक्ट करना

अधिकांश कस्टम ऐप्स को डेटा स्थिरता और सुरक्षित संचालन के लिए सर्वर-साइड स्क्रिप्ट्स के साथ संवाद करना पड़ता है। अपने ऐप JavaScript से Lua सर्वर स्क्रिप्ट को अनुरोध भेजने के लिए फोन NUI कॉलबैक सिस्टम का उपयोग करें। अपने सर्वर-साइड हैंडलर्स को एक कॉम्पेनियन रिसोर्स में पंजीकृत करें जो Agency Phone पर निर्भर करता है, उचित सत्यापन के साथ अनुरोधों को संसाधित करें, और परिणाम लौटाएं। यह पृथक्करण सुनिश्चित करता है कि आपका ऐप लॉजिक सर्वर पर सुरक्षित रूप से चलता है जबकि UI क्लाइंट पर प्रतिक्रियाशील रहता है।

अपने ऐप को स्टाइल करना

Agency Phone provides CSS variables and utility classes that match the phone theme, so your custom app can look consistent with built-in apps. Use the provided color variables for backgrounds, text, and accents to ensure your app adapts to light and dark themes automatically. The phone container handles scrolling, sizing, and safe area insets, so focus your CSS on the content layout within the app viewport. Test your app across different phone frame sizes to ensure it looks good on all resolutions.

प्रकाशन और वितरण

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