Agency Phone v2: Nowe funkcje, aplikacje i wzrost wydajności

Co nowego w v2

Agency Phone v2 to największa aktualizacja od momentu premiery. W oparciu o obszerne opinie społeczności i miesiące prac programistycznych, to wydanie przynosi całkowicie przeprojektowany interfejs, nowe aplikacje, głębszą integrację z frameworkami oraz dalszą poprawę wydajności. Każdy aspekt telefonu został dopracowany, aby zapewnić graczom bardziej immersyjne i dopracowane wrażenia.

Przeprojektowany interfejs użytkownika

Interfejs v2 wyróżnia się nowoczesnym stylem glassmorphism, płynniejszymi animacjami i ulepszoną hierarchią wizualną. Ekran główny obsługuje teraz konfigurowalne tapety oraz układ ikon aplikacji, co pozwala graczom spersonalizować swój telefon. Powiadomienia zostały całkowicie przebudowane: nowe centrum powiadomień grupuje alerty według aplikacji i obsługuje szybkie akcje bezpośrednio z poziomu powiadomienia. Cały wygląd i działanie sprawiają, że telefon w grze jest znacznie bliższy temu, czego gracze oczekują od prawdziwego smartfona.

Nowe podania

Kilka nowych aplikacji rozszerza możliwości telefonu gracza. Dedykowana aplikacja galerii pozwala zapisywać i przeglądać zrzuty ekranu z gry. Aplikacja notatek zapewnia prosty, ale skuteczny sposób na zapisywanie informacji podczas roleplayu. Ulepszona aplikacja bankowa z historią transakcji i przelewami daje graczom pełne doświadczenie bankowości mobilnej. Aplikacja marketplace umożliwia wystawianie przedmiotów między graczami, tworząc nową warstwę ekonomicznego roleplayu.

Poprawki wydajności

Podczas gdy Agency Phone utrzymywał już zużycie 0.00ms w spoczynku, wersja v2 dodatkowo optymalizuje scenariusze aktywnego użytkowania. System ładowania aplikacji został przebudowany z wykorzystaniem lazy loading, co oznacza, że aplikacje inicjalizują swoje komponenty UI dopiero po ich otwarciu. Zmniejsza to zużycie pamięci przy otwartym telefonie i przyspiesza przełączanie aplikacji. Warstwa komunikacji NUI została zoptymalizowana, aby ograniczyć liczbę zdarzeń przesyłanych między klientem a interfejsem.

Ścieżka aktualizacji

Dotychczasowi użytkownicy Agency Phone mogą zaktualizować skrypt do v2 poprzez standardowy proces pobierania Tebex. Migracja została zaprojektowana tak, aby zachować istniejące dane, w tym kontakty, wiadomości i rejestry połączeń. Szczegółowy poradnik migracji jest dostępny w dokumentacji, a zespół Agency Scripts na Discordzie służy pomocą przy wszelkich pytaniach dotyczących aktualizacji. Zalecamy przetestowanie aktualizacji na serwerze deweloperskim przed wdrożeniem na serwer produkcyjny, aby zapewnić kompatybilność z własnymi konfiguracjami.

Instalacja & konfiguracja dla v2

Aktualizacja z v1 do v2 przebiega standardowo jak aktualizacja pobierania z Tebex. Pobierz nową wersję ze swojej biblioteki Tebex, podmień folder zasobu na serwerze i zrestartuj. Skrypt migracyjny w sql/migrate_v1_to_v2.sql obsługuje zmiany schematu, uruchom go raz na istniejącej bazie danych przed zrestartowaniem zasobu. Dotychczasowe kontakty, historia wiadomości i rejestry połączeń zostaną zachowane.

Jeśli instalujesz Agency-Phone po raz pierwszy na v2, zaimportuj phone.sql, przenieś folder zasobu i dodaj ensure agency-phone do server.cfg. Resource automatycznie wykrywa QBCore lub ESX. W konfiguracjach standalone adapter implementuje się w config.lua.

Opcje konfiguracji w v2

Plik config.lua w wersji v2 jest w pełni wstecznie kompatybilny z konfiguracjami v1 oraz zawiera dodatkowe opcje dla nowych funkcji:

• Biblioteka tapet, określ dozwolone adresy URL tapet lub włącz endpoint CDN do przesyłania plików przez graczy.
• Układ ikon aplikacji, rozmiar siatki (4x5, 4x6) oraz to, czy gracze mogą zmieniać układ ikon aplikacji.
• Zachowanie centrum powiadomień, maksymalna liczba zapisanych powiadomień, próg gestu przesunięcia do odrzucenia, przyciski szybkich akcji na aplikację.
• Pamięć galerii, endpoint CDN dla zrzutów ekranu i limit pamięci na gracza (w MB).
• Ustawienia rynku, czas wygaśnięcia ogłoszenia, informacja, czy ogłoszenia wymagają zatwierdzenia przez administratora, oraz procent opłaty transakcyjnej.
• Integracja z aplikacją bankową, połącz się z bankowością QBCore, bankowością ESX lub własną funkcją bankowości.
• Lazy loading, które aplikacje używają leniwej inicjalizacji (domyślnie wszystkie w v2) oraz czy wstępnie ładować określone aplikacje przy otwieraniu telefonu.

Kompatybilność z frameworkami w v2

v2 zachowuje ten sam wzorzec adaptera frameworka co v1. Jeśli dostosowałeś adapter w v1, Twoje zmiany przechodzą dalej, interfejs adaptera pozostaje bez zmian. Nowe aplikacje dodane w v2 (galeria, notatki, marketplace) przechodzą przez te same funkcje adaptera. Nowe funkcje nie wymagają żadnych nowych implementacji specyficznych dla frameworka.

Dlaczego redesign v2 ma znaczenie dla roleplay

Telefon v1 był już najbardziej wydajnym telefonem FiveM na rynku. Przeprojektowana wersja v2 rozwiązuje inny problem: różnicę między wyglądem telefonu a wrażeniem korzystania z prawdziwego smartfona. Nowy ekran główny z konfigurowalnymi tapetami i możliwością zmiany układu ikon aplikacji to pierwsza zmiana zauważana przez graczy, ale w rzeczywistości daje im ona pełną kontrolę nad charakterem telefonu. Telefon, który sprawia wrażenie osobistego, staje się rekwizytem, w który gracze chętnie inwestują w ramach rozwoju swojej postaci.

Przebudowa centrum powiadomień ma najbardziej praktyczny wpływ na codzienną rozgrywkę. W wersji V1 powiadomienia pojawiały się jako toasty i znikały. W wersji V2 gromadzą się w centrum z szybkimi akcjami: odbierz/odrzuć połączenie z poziomu powiadomienia, odpowiedz na wiadomość bez otwierania aplikacji SMS, zatwierdź transakcję na giełdzie. Mniejsza liczba koniecznych otwarć menu przy każdej akcji przekłada się w trakcie sesji na zauważalnie płynniejsze korzystanie z telefonu.

Aplikacja marketplace otwiera całą warstwę ekonomiczną, która wcześniej wymagała koordynacji out-of-character. Gracze, którzy chcą sprzedawać przedmioty innym graczom, wystawiają je na marketplace, kupujący przeglądają i kupują bez odkładania telefonu. Negocjacje odbywają się w wiadomościach prywatnych. Koordynacja odbioru przebiega przez SMS. Cała transakcja odbywa się in-character, co przekształca zwykłą transakcję w RP.

Co nie zmieniło się w v2

Kluczowe parametry wydajności nie uległy zmianie, ponieważ nie było takiej potrzeby. Zużycie 0.00ms w spoczynku, niezależny od frameworka wzorzec adaptera, architektura lazy-loadingu: to fundamenty, na których zbudowane jest UI v2. Dodaliśmy nowe aplikacje galerii, notatek i marketplace bez naruszania warstwy wydajnościowej. Wersja v2 ma więcej funkcji, ale nie zużywa więcej zasobów.

Aplikacje kontaktów, SMS i połączeń zostały odświeżone wizualnie w v2, ale są identyczne pod względem funkcjonalnym. Gracze korzystający z konkretnych zachowań w v1, wątkowania, grupowych SMS-ów czy historii połączeń, znajdą te same funkcje w v2 w ulepszonej oprawie wizualnej. Migracja przebiega bezproblemowo dla istniejących społeczności właśnie dlatego, że nie zmienialiśmy tego, co już działało.

Często zadawane pytania dotyczące v2

Czy mogę wrócić do v1, jeśli v2 sprawia problemy na moim serwerze?

Tak, pobrania v1 pozostają w twojej bibliotece Tebex. Twój schemat bazy danych v1 jest kompatybilny, SQL migracji jedynie dodaje tabele i nie modyfikuje istniejących. Przywrócenie oznacza powrót do folderu zasobu v1 i zignorowanie nowych tabel. Nie jest to rozwiązanie idealne, ale bezpieczne, jeśli w pierwszych dniach wdrożenia v2 wystąpi krytyczny problem ze zgodnością.

Czy aplikacja marketplace wymaga specjalnej konfiguracji backendu?

Marketplace korzysta z istniejącej bazy danych oxmysql. Żaden dodatkowy backend nie jest potrzebny. Ogłoszenia są przechowywane w nowej phone_marketplace tabela utworzona przez migrację SQL. Rynek działa w całości po stronie serwera, bez żadnych zewnętrznych zależności API.

Czy administratorzy mogą moderować ogłoszenia na rynku?

Tak. Włącz tryb zatwierdzania w config.lua, a nowe ogłoszenia pojawią się w kolejce moderacji dostępnej przez Agency-Admin lub przez panel administratora samego telefonu (dostępny dla graczy z flagą admina). Jest to zalecane na serwerach, gdzie gracze mogliby próbować wystawiać zabronione przedmioty lub omijać ograniczenia ekonomii w grze za pośrednictwem rynku.

Czy pamięć galerii jest współdzielona między postaciami na tym samym koncie?

Domyślnie pamięć galerii działa dla każdej postaci osobno, a nie dla całego konta. Zrzuty ekranu są przypisywane do postaci, która je wykonała. W przypadku systemów wielu postaci, gdzie gracze chcą dzielić zrzuty ekranu między postaciami, ustaw Config.GalleryByAccount = true aby użyć identyfikatora gracza zamiast identyfikatora postaci jako klucza zapisu.

Wymagania

• Serwer FiveM (QBCore, ESX lub standalone)
• oxmysql
• konto cfx.re z ważną licencją Agency-Phone
• Endpoint CDN zdjęć dla funkcji galerii (opcjonalny, w przypadku braku konfiguracji przełącza się na sam URL)