Agency Phone v2 : nouvelles fonctionnalités, applications et gains de performance

Nouveautés de la v2

Agency Phone v2 est la plus grande mise à jour depuis le lancement initial. Fondée sur de nombreux retours de la communauté et plusieurs mois de développement, cette version apporte une interface entièrement repensée, de nouvelles applications, une intégration plus poussée aux frameworks et des améliorations supplémentaires des performances. Chaque aspect du téléphone a été peaufiné pour offrir aux joueurs une expérience plus immersive et plus aboutie.

Interface utilisateur repensée

L’interface de la v2 adopte un design moderne de type glassmorphism, avec des animations plus fluides et une hiérarchie visuelle améliorée. L’écran d’accueil prend désormais en charge les fonds d’écran personnalisables et la disposition des icônes d’application, afin que les joueurs puissent personnaliser leur téléphone. Le système de notifications a été entièrement repensé : le nouveau centre de notifications regroupe les alertes par application et propose des actions rapides directement depuis les notifications. L’apparence générale rapproche le téléphone en jeu de ce que les joueurs attendent d’un vrai smartphone.

Nouvelles applications

Plusieurs nouvelles applications élargissent les possibilités du téléphone. Une application galerie dédiée permet aux joueurs d’enregistrer et de consulter des captures d’écran prises en jeu. L’application de notes offre un moyen simple, mais efficace, de conserver des informations pendant le roleplay. Une application bancaire améliorée, avec un historique des transactions et la possibilité d’effectuer des virements, offre une expérience complète de banque mobile. L’application de marketplace permet aux joueurs de publier des annonces d’objets entre eux, ajoutant une nouvelle dimension au roleplay économique.

Améliorations des performances

Agency Phone maintenait déjà une consommation au repos de 0.00ms, mais la v2 optimise encore davantage les scénarios d’utilisation active. Le système de chargement des applications a été repensé pour utiliser le chargement différé : les applications n’initialisent leurs composants d’interface que lorsqu’elles sont effectivement ouvertes. Cela réduit l’empreinte mémoire quand le téléphone est ouvert et accélère le passage d’une application à l’autre. La couche de communication NUI a été simplifiée afin de réduire le nombre d’événements échangés entre le client et l’interface.

Procédure de mise à niveau

Les utilisateurs actuels d’Agency Phone peuvent passer à la v2 via le processus de téléchargement standard de Tebex. La migration est conçue pour préserver les données existantes, notamment les contacts, les messages et l’historique des appels. Un guide de migration détaillé est disponible dans la documentation, et l’équipe Agency Scripts sur Discord est là pour répondre à toutes tes questions concernant la mise à jour. Nous te recommandons de tester la mise à jour sur un serveur de développement avant le déploiement en production, afin de vérifier la compatibilité avec tes configurations personnalisées.

Installation et configuration de la v2

La mise à niveau de la v1 vers la v2 se fait via une mise à jour standard par téléchargement sur Tebex. Récupère la nouvelle version dans ta bibliothèque Tebex, remplace le dossier de la ressource sur ton serveur, puis redémarre. Le script de migration situé dans sql/migrate_v1_to_v2.sql gère les modifications de schéma. Exécute-le une fois sur ta base de données existante avant de redémarrer la ressource. Les contacts, l’historique des messages et les journaux d’appels existants sont préservés.

Si tu installes Agency-Phone pour la première fois avec la v2, importe phone.sql, dépose le dossier de la ressource et ajoute ensure agency-phone à server.cfg. La ressource détecte automatiquement QBCore ou ESX. Pour une configuration standalone, implémente l’adaptateur dans config.lua.

Options de configuration de la v2

Le config.lua de la v2 est entièrement rétrocompatible avec les configurations de la v1, et propose des options supplémentaires pour les nouvelles fonctionnalités :

• Bibliothèque de fonds d’écran, indique les URL de fonds d’écran autorisées ou active le point de terminaison CDN pour les téléversements des joueurs.
• Disposition des icônes d’applications, taille de la grille (4x5, 4x6) et possibilité pour les joueurs de réorganiser les icônes d’applications.
• Fonctionnement du centre de notifications, nombre maximal de notifications stockées, seuil de balayage pour les fermer et boutons d’action rapide par application.
• Stockage de la galerie, point de terminaison CDN pour les captures d’écran et quota de stockage par joueur (en MB).
• Paramètres de la marketplace, durée d’expiration des annonces, approbation obligatoire ou non par un administrateur et pourcentage des frais de transaction.
• Intégration de l’application bancaire, connexion aux systèmes bancaires de QBCore ou ESX, ou à une fonction bancaire personnalisée.
• Chargement différé, applications utilisant l’initialisation différée (toutes par défaut dans la v2) et possibilité de précharger certaines applications à l’ouverture du téléphone.

Compatibilité avec les frameworks dans la v2

La v2 conserve le même modèle d’adaptateur de framework que la v1. Si tu as personnalisé l’adaptateur dans la v1, tes modifications sont conservées : l’interface de l’adaptateur n’a pas changé. Les nouvelles applications ajoutées dans la v2 (galerie, notes, marketplace) passent toutes par les mêmes fonctions d’adaptateur. Aucune nouvelle implémentation spécifique aux frameworks n’est nécessaire pour les nouvelles fonctionnalités.

Pourquoi la refonte de la v2 est importante pour le roleplay

Le téléphone de la v1 était déjà le téléphone FiveM le plus performant du marché. La refonte de la v2 répond à un autre problème : l’écart entre l’apparence du téléphone et les sensations procurées par un vrai smartphone. Les joueurs remarquent d’abord le nouvel écran d’accueil, avec ses fonds d’écran personnalisables et ses icônes d’applications réorganisables. Mais surtout, il permet aux joueurs de donner à leur téléphone une personnalité qui leur est propre. Un téléphone qui semble personnel devient un accessoire auquel les joueurs s’attachent dans le cadre de leur personnage.

La refonte du centre de notifications a l’impact le plus concret sur le gameplay au quotidien. Dans la v1, les notifications apparaissaient sous forme de pop-ups, puis disparaissaient. Dans la v2, elles s’accumulent dans un centre doté d’actions rapides : accepter ou refuser un appel depuis la notification, répondre à un message sans ouvrir l’application SMS, approuver une transaction sur la marketplace. La réduction des frictions, grâce à moins d’ouvertures de menus par action, s’accumule au fil d’une session et rend l’utilisation du téléphone nettement plus fluide.

L’application marketplace ouvre toute une dimension économique qui nécessitait auparavant une coordination hors personnage. Les joueurs qui veulent vendre des objets à d’autres joueurs les mettent en vente sur la marketplace. Les acheteurs peuvent parcourir les annonces et acheter sans quitter le téléphone. Les négociations ont lieu en DM. La coordination pour récupérer les objets se fait par SMS. Toute la transaction se déroule en personnage, c’est ce qui la transforme en RP.

Ce qui n’a pas changé dans la v2

Les performances fondamentales n’ont pas changé, car elles n’avaient pas besoin de changer. L’utilisation de 0.00ms au repos, le modèle d’adaptateur indépendant du framework et l’architecture de chargement différé sont les bases sur lesquelles repose l’interface de la v2. Nous avons ajouté les nouvelles applications Galerie, Notes et Marketplace sans toucher à la couche de performance. La v2 offre davantage de fonctionnalités, pas une consommation accrue de ressources.

Les applications Contacts, SMS et Appels ont été modernisées visuellement dans la v2, mais leur fonctionnement reste identique. Les joueurs qui comptaient sur des comportements spécifiques de la v1, les fils de discussion, les SMS de groupe et les historiques d’appels, retrouvent les mêmes fonctionnalités dans la v2, avec une présentation visuelle améliorée. La migration se passe sans accroc pour les communautés établies, précisément parce que nous n’avons pas modifié ce qui fonctionnait déjà.

Questions fréquentes sur la v2

Puis-je revenir à la v1 si la v2 pose problème sur mon serveur ?

Oui, les téléchargements de la v1 restent disponibles dans ta bibliothèque Tebex. Le schéma de base de données de la v1 est compatible, le SQL de migration ajoute uniquement des tables, il ne modifie pas celles qui existent déjà. Pour revenir en arrière, repasse au dossier de ressource de la v1 et ignore les nouvelles tables. Ce n’est pas idéal, mais c’est sans risque si un problème de compatibilité critique survient dans les premiers jours du déploiement de la v2.

L’application Marketplace nécessite-t-elle une configuration backend particulière ?

Marketplace utilise la base de données oxmysql existante. Aucun backend supplémentaire n’est nécessaire. Les annonces sont stockées dans une nouvelle phone_marketplace table créée par le SQL de migration. Marketplace fonctionne entièrement sur le serveur et ne dépend d’aucune API externe.

Les admins peuvent-ils modérer les annonces de Marketplace ?

Oui. Active le mode d’approbation dans config.lua et les nouvelles annonces apparaîtront dans une file de modération accessible via Agency-Admin ou le panneau d’administration intégré au téléphone (accessible aux joueurs ayant le flag admin). Cette option est recommandée pour les serveurs où les joueurs pourraient tenter de publier des objets interdits ou de contourner les restrictions de l’économie en jeu via Marketplace.

Le stockage de la galerie est-il partagé entre les personnages d’un même compte ?

Par défaut, le stockage de la galerie est associé à chaque personnage, et non à chaque compte. Les captures d’écran sont associées au personnage qui les a prises. Pour les systèmes mult personages où les joueurs souhaitent partager des captures d’écran entre leurs personnages, configure Config.GalleryByAccount = true pour utiliser l’identifiant du joueur au lieu de celui du personnage comme clé de stockage.

Prérequis

• Serveur FiveM (QBCore, ESX ou standalone)
• oxmysql
• Compte cfx.re avec une licence Agency-Phone valide
• Endpoint CDN photo pour la fonctionnalité de galerie (facultatif, utilise uniquement les URL s’il n’est pas configuré)