Architecture d'application Agency Phone
Agency Phone est conçu dans un souci d'extensibilité, permettant aux développeurs de serveurs de créer des applications personnalisées qui s'intègrent parfaitement à l'interface du téléphone. Chaque application fonctionne comme un module autonome avec ses propres HTML, CSS et JavaScript, communiquant avec le framework du téléphone via un API bien défini. Cette architecture signifie que tu peux créer n'importe quoi, depuis une application de course jusqu'à un gestionnaire immobilier en passant par un système de répartition personnalisé, le tout accessible depuis le téléphone que les joueurs savent déjà utiliser.
Configuration de la structure de ton application
Pour créer une application personnalisée, commencez par créer un nouveau dossier dans le répertoire des applications Agency Phone. Ton application a besoin d'un app.json fichier manifeste qui définit le nom de l’application, l’icône, la description et le point d’entrée. Le manifeste spécifie également les autorisations requises par ton application, telles que l'accès aux contacts, aux notifications ou aux données GPS. Créez ton fichier HTML principal référencé dans le manifeste, ainsi que tous les fichiers CSS et JavaScript dont ton application a besoin. Le framework téléphonique découvre et enregistre automatiquement les applications qui suivent cette structure.
Utilisation de l'application API
Le Agency Phone expose un JavaScript API que ton application peut utiliser pour interagir avec les fonctionnalités du téléphone. Appel AgencyPhone.getContacts() pour accéder à la liste de contacts des joueurs, AgencyPhone.sendNotification() pour pousser les notifications, ou AgencyPhone.getPlayerData() pour récupérer les informations actuelles du joueur à partir du framework. Le API fournit également des méthodes de navigation pour basculer entre les écrans d'application, un API de stockage pour les données persistantes spécifiques à l'application et des hooks d'événements pour la gestion du cycle de vie, comme lorsque ton application est ouverte, réduite ou fermée.
Connexion à la logique côté serveur
La plupart des applications personnalisées doivent communiquer avec des scripts côté serveur pour assurer la persistance des données et sécuriser les opérations. Utilisez le système de rappel du téléphone NUI pour envoyer des requêtes de ton application JavaScript à un script de serveur Lua. Enregistrez tes gestionnaires côté serveur dans une ressource compagnon qui dépend de Agency Phone, traitez les demandes avec une validation appropriée et renvoyez les résultats. Cette séparation garantit que la logique de ton application s'exécute en toute sécurité sur le serveur tandis que l'interface utilisateur reste réactive sur le client.
Styliser ton application
Agency Phone fournit des variables CSS et des classes utilitaires qui correspondent au thème du téléphone, afin que ton application personnalisée puisse paraître cohérente avec les applications intégrées. Utilisez les variables de couleur fournies pour les arrière-plans, le texte et les accents afin de garantir que ton application s'adapte automatiquement aux thèmes clairs et sombres. Le conteneur du téléphone gère le défilement, le dimensionnement et les encarts de zone de sécurité, concentrez donc ton CSS sur la disposition du contenu dans la fenêtre d'affichage de l'application. Testez ton application sur différentes tailles de cadre de téléphone pour tu assurer qu'elle s'affiche correctement dans toutes les résolutions.
Édition et distribution
Une fois ton application terminée, conditionnez-la en tant que ressource autonome dépendant de Agency Phone. Incluez des instructions d'installation claires, des options de configuration et des exemples de captures d'écran dans ton documentation. Si tu envisages de vendre ton application sur Tebex, assurez-tu qu'elle respecte les directives de dépôt et incluez une vidéo de démonstration montrant l'application en action. Pensez à proposer une version de base gratuite avec des fonctionnalités premium pour attirer davantage de propriétaires de serveurs et renforcer la confiance dans ton travail de développement avant de tu engager dans un achat.