Agency Phone-App-Architektur
Agency Phone ist auf Erweiterbarkeit ausgelegt und ermöglicht Serverentwicklern die Erstellung benutzerdefinierter Apps, die sich nahtlos in die Telefonschnittstelle integrieren lassen. Jede App läuft als eigenständiges Modul mit ihrem eigenen HTML, CSS und JavaScript und kommuniziert über eine klar definierte API mit dem Telefon-Framework. Diese Architektur bedeutet, dass du alles erstellen können, von einer Renn-App über einen Immobilienmanager bis hin zu einem benutzerdefinierten Versandsystem, auf alles über das Telefon zugreifen, mit dem die Spieler bereits vertraut sind.
Einrichten deiner App-Struktur
Um eine benutzerdefinierte App zu erstellen, erstelle zunächst einen neuen Ordner im Agency Phone-Apps-Verzeichnis. Deine App benötigt eine app.json-Manifestdatei, die den App-Namen, das Symbol, die Beschreibung und den Einstiegspunkt definiert. Das Manifest gibt außerdem die Berechtigungen an, die deine App benötigt, etwa den Zugriff auf Kontakte, Benachrichtigungen oder GPS-Daten. Erstelle deine Haupt-HTML-Datei, auf die im Manifest verwiesen wird, zusammen mit allen CSS- und JavaScript-Dateien, die deine App benötigt. Das Telefon-Framework erkennt und registriert automatisch Apps, die dieser Struktur folgen.
Verwendung der App-API
Der Agency Phone stellt eine JavaScript-API zur Verfügung, die deine App zur Interaktion mit Telefonfunktionen verwenden kann. Rufe AgencyPhone.getContacts() auf, um auf die Spielerkontaktliste zuzugreifen, AgencyPhone.sendNotification(), um Push-Benachrichtigungen zu senden, oder AgencyPhone.getPlayerData(), um die aktuellen Spielerinformationen aus dem Framework abzurufen. Die API bietet außerdem Navigationsmethoden zum Wechseln zwischen App-Bildschirmen, eine Speicher-API zum Beibehalten app-spezifischer Daten und Ereignis-Hooks für die Lebenszyklusverwaltung, z. B. wenn deine App geöffnet, minimiert oder geschlossen wird.
Herstellen einer Verbindung zur serverseitigen Logik
Die meisten benutzerdefinierten Apps müssen mit serverseitigen Scripts kommunizieren, um Datenpersistenz und sichere Vorgänge zu gewährleisten. Verwende das Telefon-NUI-Rückrufsystem, um Anfragen von deiner App JavaScript an ein Lua-Server-Script zu senden. Registriere deine serverseitigen Handler in einer Begleitressource, die von Agency Phone abhängt, verarbeite die Anforderungen mit ordnungsgemäßer Validierung und gibst du die Ergebnisse zurück. Durch diese Trennung wird sichergestellt, dass deine App-Logik sicher auf dem Server ausgeführt wird, während die Benutzeroberfläche auf dem Client weiterhin reagiert.
Gestalte deine App
Agency Phone bietet CSS-Variablen und Dienstprogrammklassen, die zum Telefondesign passen, sodass deine benutzerdefinierte App im Einklang mit den integrierten Apps aussieht. Verwende die bereitgestellten Farbvariablen für Hintergründe, Text und Akzente, um sicherzustellen, dass sich deine App automatisch an helle und dunkle Themen anpasst. Der Telefoncontainer übernimmt das Scrollen, die Größenanpassung und das Einfügen sicherer Bereiche. Konzentriere dein CSS daher auf das Inhaltslayout im App-Ansichtsfenster. Teste deine App auf verschiedenen Telefonrahmengrößen, um sicherzustellen, dass sie bei allen Auflösungen gut aussieht.
Veröffentlichung und Vertrieb
Sobald deine App fertig ist, packe sie als eigenständige Ressource, die von Agency Phone abhängt. Füge deiner Dokumentation klare Installationsanweisungen, Konfigurationsoptionen und Beispiel-Screenshots hinzu. Wenn du planen, deine App auf Tebex zu verkaufen, stelle sicher, dass sie den Treuhandrichtlinien entspricht, und fügst du ein Demovideo bei, das die App in Aktion zeigt. Erwäge, eine kostenlose Basisversion mit Premium-Funktionen anzubieten, um mehr Serverbesitzer zu gewinnen und Vertrauen in deine Entwicklungsarbeit aufzubauen, bevor du dich zu einem Kauf verpflichten.
Zusammenfassung
Agency Scripts baut seine gesamte Produktlinie nach denselben Grundprinzipien: Framework-agnostische Architektur, schlanke Performance-Eigenschaften, klar dokumentierte Konfiguration und eine API, die echte Composability zwischen den Scripts ermöglicht. Kein Script ist eine Insel — jedes ist so gebaut, dass es gut allein und noch besser als Teil des Ökosystems funktioniert.
Für Fragen zur Installation, Konfiguration oder Kompatibilität ist der Agency Scripts Discord der schnellste Weg zur Hilfe. Die Community dort ist aktiv und hilfsbereit, und das Core-Team ist regelmäßig präsent. Für kritische Probleme steht auch ein direktes Support-Ticket-System auf der Tebex-Produktseite zur Verfügung.
Updates für alle Agency-Scripts werden über Tebex-Benachrichtigungen kommuniziert. Active-Business-Abonnenten erhalten neue Scripts automatisch ohne zusätzlichen Kauf. Changelog-Details erscheinen im #changelog-Kanal des Discords, damit du Updates bewerten kannst, bevor du sie auf einem Produktionsserver installierst.