كيفية إنشاء تطبيقات مخصصة لسكربتات هاتف FiveM

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 يمكن لتطبيقك استخدامها للتفاعل مع ميزات الهاتف. استدعِ AgencyPhone.getContacts() للوصول إلى قائمة جهات اتصال اللاعبين، AgencyPhone.sendNotification() لدفع الإشعارات، أو AgencyPhone.getPlayerData() لاسترجاع معلومات اللاعب الحالية من الإطار. توفر API أيضًا طرق تنقل للتبديل بين شاشات التطبيق، وAPI تخزين لحفظ بيانات التطبيق الخاصة، وروابط أحداث لإدارة دورة الحياة مثل عند فتح التطبيق أو تصغيره أو إغلاقه.

الاتصال بالمنطق على جانب الخادم

تحتاج معظم التطبيقات المخصصة إلى التواصل مع سكربتات الخادم للحفاظ على البيانات والعمليات الآمنة. استخدم نظام رد الاتصال NUI للهاتف لإرسال الطلبات من جافا سكريبت التطبيق الخاص بك إلى سكربت Lua على الخادم. سجل معالجات الخادم الخاصة بك في مورد مرافق يعتمد على Agency Phone، عالج الطلبات مع التحقق المناسب، وأعد النتائج. يضمن هذا الفصل أن منطق التطبيق يعمل بأمان على الخادم بينما تظل واجهة المستخدم مستجيبة على العميل.

تصميم تطبيقك

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.

النشر والتوزيع

بمجرد اكتمال تطبيقك، حزمه كمورد مستقل يعتمد على Agency Phone. أدرج تعليمات تثبيت واضحة، خيارات التكوين، ولقطات شاشة نموذجية في وثائقك. إذا كنت تخطط لبيع تطبيقك على Tebex، تأكد من اتباع إرشادات الضمان وأدرج فيديو تجريبي يظهر التطبيق أثناء العمل. فكر في تقديم نسخة أساسية مجانية مع ميزات مميزة لجذب المزيد من مالكي الخوادم وبناء الثقة في عملك التطويري قبل الالتزام بالشراء.