كيفية إنشاء تطبيقات مخصصة لسكربتات هواتف FiveM
دليل خطوة بخطوة لإنشاء تطبيقات مخصصة لسكربتات هواتف FiveM. تعرّف على البنية والأحداث ودمج الواجهة، مع أمثلة عملية لخوادم تقمص الأدوار.
Agency Scripts
المؤسس والمطور الرئيسي في Agency Scripts
Agency Phone App Architecture
صُمم Agency Phone مع مراعاة قابلية التوسّع، ما يتيح لمطوري الخوادم إنشاء تطبيقات مخصصة تتكامل بسلاسة مع واجهة الهاتف. يعمل كل تطبيق كوحدة مستقلة بذاتها، مع ملفات HTML وCSS وJavaScript خاصة به، ويتواصل مع إطار عمل الهاتف عبر API محدد جيدًا. تتيح لك هذه البنية إنشاء أي شيء، من تطبيق سباقات إلى مدير عقارات أو نظام توجيه مخصص، وكلها متاحة عبر الهاتف الذي يعرف اللاعبون بالفعل كيفية استخدامه.
إعداد هيكل تطبيقك
لإنشاء تطبيق مخصص، ابدأ بإنشاء مجلد جديد داخل دليل تطبيقات 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 متغيرات CSS وفئات مساعدة تتوافق مع سمة الهاتف، لتبدو تطبيقاتك المخصصة متناسقة مع التطبيقات المدمجة. استخدم متغيرات الألوان المتاحة للخلفيات والنصوص واللمسات، لضمان تكيف تطبيقك تلقائيًا مع السمات الفاتحة والداكنة. يتولى إطار الهاتف معالجة التمرير والتحجيم والهوامش الآمنة، لذا ركّز في CSS على تخطيط المحتوى داخل مساحة عرض التطبيق. اختبر تطبيقك على أحجام إطارات هواتف مختلفة للتأكد من ظهوره بشكل جيد على جميع درجات الدقة.
النشر والتوزيع
بمجرد اكتمال تطبيقك، حزمه كمورد مستقل يعتمد على Agency Phone. أدرج تعليمات تثبيت واضحة، خيارات التكوين، ولقطات شاشة نموذجية في وثائقك. إذا كنت تخطط لبيع تطبيقك على Tebex، تأكد من اتباع إرشادات الضمان وأدرج فيديو تجريبي يظهر التطبيق أثناء العمل. فكر في تقديم نسخة أساسية مجانية مع ميزات مميزة لجذب المزيد من مالكي الخوادم وبناء الثقة في عملك التطويري قبل الالتزام بالشراء.