Agency Phone v2: новые функции, приложения и прирост производительности

Что нового в версии 2

Agency Phone v2 represents the biggest update since the original launch. Based on extensive community feedback and months of development, this release brings a completely redesigned interface, new applications, deeper framework integration, and further performance improvements. Every aspect of the phone has been refined to deliver a more immersive and polished experience for players.

Переработанный пользовательский интерфейс

Интерфейс v2 выполнен в современном стиле glassmorphism с более плавной анимацией и улучшенной визуальной иерархией. Главный экран теперь поддерживает настраиваемые обои и расположение иконок приложений, позволяя игрокам персонализировать телефон. Уведомления полностью переработаны с новым центром уведомлений, который группирует оповещения по приложениям и поддерживает быстрые действия прямо из уведомления. Общий вид и ощущения приближают внутриигровой телефон к тому, что игроки ожидают от настоящего смартфона.

Новые приложения

Несколько новых приложений расширяют возможности игроков с их телефоном. Специализированное приложение галереи позволяет сохранять и просматривать скриншоты из игры. Приложение заметок предоставляет простой, но эффективный способ хранения информации во время ролевой игры. Улучшенное банковское приложение с историей транзакций и возможностями перевода обеспечивает полный опыт мобильного банкинга. Приложение рынка позволяет игрокам размещать объявления о продаже предметов, создавая новый уровень экономической ролевой игры.

Улучшения производительности

Хотя Agency Phone уже поддерживал 0.00ms потребления в режиме ожидания, версия 2 дополнительно оптимизирует сценарии активного использования. Система загрузки приложений была переработана для ленивой загрузки, то есть приложения инициализируют UI компоненты только при открытии. Это снижает потребление памяти при открытом телефоне и ускоряет переключение приложений. Слой коммуникации NUI был оптимизирован для уменьшения количества событий между клиентом и интерфейсом.

Путь обновления

Существующие пользователи Agency Phone могут обновиться до версии 2 через стандартный процесс загрузки Tebex. Миграция разработана для сохранения существующих данных, включая контакты, сообщения и журналы звонков. Подробное руководство по миграции доступно в документации, а команда Agency Scripts в Discord готова помочь с любыми вопросами по обновлению. Рекомендуется тестировать обновление на тестовом сервере перед развертыванием в продакшене для обеспечения совместимости с вашими кастомными настройками.

Установка и настройка для v2

Обновление с v1 до v2 происходит стандартным способом через загрузку обновления с Tebex. Скачайте новую версию из вашей библиотеки Tebex, замените папку ресурса на сервере и перезапустите. Скрипт миграции в sql/migrate_v1_to_v2.sql обрабатывает изменения схемы, запустите один раз на вашей существующей базе данных перед перезапуском ресурса. Существующие контакты, история сообщений и журналы звонков сохраняются.

Если вы устанавливаете Agency-Phone впервые на v2, импортируйте phone.sql , поместите папку ресурса и добавьте ensure agency-phone в server.cfg. Ресурс автоматически определяет QBCore или ESX. Для standalone-настроек адаптер реализован в config.lua.

Опции конфигурации в v2

Конфиг v2 config.lua полностью обратно совместим с конфигами v1, с дополнительными опциями для новых функций:

• Библиотека обоев , укажите разрешённые URL обоев или включите конечную точку CDN для загрузки игроками.
• Макет иконки приложения , размер сетки (4x5, 4x6) и возможность игрокам менять расположение приложений.
• Поведение центра уведомлений", максимальное количество сохранённых уведомлений, порог для свайпа для удаления, кнопки быстрого действия для каждого приложения.",
• Хранилище галереи , конечная точка CDN для скриншотов и квота хранения на игрока (в МБ).
• Настройки рынка", длительность действия объявлений, требуется ли одобрение администратором и процент комиссии с транзакций.",
• Интеграция банковского приложения подключитесь к банковским системам QBCore, ESX или используйте кастомную банковскую функцию.
• Ленивая загрузка", какие приложения используют ленивую инициализацию (все по умолчанию в v2) и какие приложения предварительно загружаются при открытии телефона.

Совместимость с фреймворками в версии 2

v2 сохраняет тот же шаблон адаптера фреймворка, что и v1. Если вы настраивали адаптер в v1, ваши изменения сохраняются, интерфейс адаптера не изменился. Новые приложения, добавленные в v2 (галерея, заметки, маркетплейс), все работают через те же функции адаптера. Для новых функций не требуется новых реализаций, специфичных для фреймворка.

Почему редизайн v2 важен для ролевой игры

Телефон версии v1 уже был лучшим по производительности телефоном FiveM на рынке. Редизайн v2 решает другую проблему: разрыв между тем, как телефон выглядит, и тем, как ощущается настоящий смартфон. Переработанный главный экран с настраиваемыми обоями и переставляемыми иконками приложений , первое, что замечают игроки, но на самом деле это дает игрокам возможность владеть индивидуальностью своего телефона. Телефон, который ощущается личным, становится реквизитом, в который игроки вкладываются как часть своего персонажа.

Редизайн центра уведомлений оказывает самое практическое влияние на ежедневный игровой процесс. В версии 1 уведомления появлялись как тосты и исчезали. В версии 2 они накапливаются в центре с быстрыми действиями: принять/отклонить звонок из уведомления, ответить на сообщение без открытия SMS-приложения, одобрить сделку на маркетплейсе. Снижение количества открытий меню на действие заметно улучшает использование телефона в течение сессии.

Приложение marketplace открывает целый экономический слой, который ранее требовал внеигровой координации. Игроки, желающие продать предметы другим игрокам, выставляют их на marketplace; покупатели просматривают и покупают, не покидая телефон. Переговоры проходят в личных сообщениях. Координация передачи , в SMS. Вся сделка происходит в игровом мире, что превращает транзакцию в RP.

Что не изменилось в версии 2

Основные характеристики производительности не изменились, потому что в этом не было необходимости. 0.00ms в режиме ожидания, фреймворк-агностичный паттерн адаптера, архитектура ленивой загрузки , это основы, на которых построен UI версии 2. Мы добавили новые приложения галереи, заметок и маркетплейса, не трогая слой производительности. Версия 2 богаче по функциям, а не по потреблению ресурсов.

Приложения контактов, SMS и звонков визуально обновлены в версии 2, но функционально идентичны. Игроки, которые полагались на определённые функции в версии 1, такие как ветвление, групповые SMS, журналы звонков, найдут те же функции в версии 2 с улучшенной визуальной подачей. Миграция проходит гладко для устоявшихся сообществ именно потому, что мы не изменили то, что уже работало.

Часто задаваемые вопросы о версии 2

Могу ли я откатиться к v1, если v2 вызывает проблемы на моём сервере?

Да, загрузки версии v1 остаются в вашей библиотеке Tebex. Ваша схема базы данных v1 совместима, миграционный SQL только добавляет таблицы, не изменяя существующие. Откат означает возврат к папке ресурса v1 и игнорирование новых таблиц. Не идеально, но безопасно, если в первые дни развертывания v2 возникнут критические проблемы совместимости.

Требует ли приложение маркетплейса специальной настройки бэкенда?

Marketplace использует существующую базу данных oxmysql. Дополнительный бэкенд не требуется. Объявления хранятся в новой phone_marketplace таблица, созданная миграционным SQL. Маркетплейс полностью содержится на сервере без внешних API-зависимостей.

Могут ли администраторы модерировать объявления на маркетплейсе?

Да. Включите режим одобрения в config.lua, и новые объявления появятся в очереди модерации, доступной через Agency-Admin или через собственную панель администратора телефона (доступна игрокам с флагом администратора). Это рекомендуется для серверов, где игроки могут пытаться разместить запрещённые предметы или обойти ограничения внутриигровой экономики через маркетплейс.

Общее ли хранилище галереи для всех персонажей на одном аккаунте?

По умолчанию хранилище галереи привязано к персонажу, а не к аккаунту. Скриншоты связаны с персонажем, который их сделал. Для систем с несколькими персонажами, где игроки хотят делиться скриншотами между персонажами, установите Config.GalleryByAccount = true для использования идентификатора игрока вместо идентификатора персонажа в качестве ключа хранения.

Требования

• Сервер FiveM (QBCore, ESX или standalone)
• oxmysql
• аккаунт cfx.re с действующей лицензией Agency-Phone
• Конечная точка CDN для фотографий в галерее (опционально, при отсутствии настройки используется только URL)