Как создавать кастомные приложения для скриптов FiveM Phone

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 файлы, необходимые вашему приложению. Фреймворк телефона автоматически обнаруживает и регистрирует приложения, которые следуют этой структуре.

Использование App API

Agency Phone предоставляет JavaScript API, который ваше приложение может использовать для взаимодействия с функциями телефона. Вызовите AgencyPhone.getContacts() для доступа к списку контактов игроков, AgencyPhone.sendNotification() для отправки push-уведомлений, или AgencyPhone.getPlayerData() для получения текущей информации об игроке из фреймворка. API также предоставляет методы навигации для переключения между экранами приложений, API хранения для сохранения данных, специфичных для приложения, и хуки событий для управления жизненным циклом, таких как открытие, сворачивание или закрытие вашего приложения.

Подключение к серверной логике

Большинство кастомных приложений должны взаимодействовать с серверными скриптами для сохранения данных и безопасных операций. Используйте систему обратных вызовов NUI телефона для отправки запросов из JavaScript вашего приложения в Lua-скрипт сервера. Регистрируйте обработчики на стороне сервера в companion-ресурсе, который зависит от 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.

Публикация и распространение

После завершения разработки вашего приложения упакуйте его как standalone-ресурс, зависящий от Agency Phone. Включите чёткие инструкции по установке, опции конфигурации и примерные скриншоты в документацию. Если планируете продавать приложение на Tebex, убедитесь, что оно соответствует требованиям эскроу, и добавьте демонстрационное видео с работой приложения. Рассмотрите возможность предложения бесплатной базовой версии с премиум-функциями, чтобы привлечь больше владельцев серверов и завоевать доверие к вашей разработке перед покупкой.