Agency Phone v2: nuevas funciones, aplicaciones y mejor rendimiento

Novedades de v2

Agency Phone v2 es la actualización más importante desde el lanzamiento original. Basada en amplios comentarios de la comunidad y meses de desarrollo, esta versión incluye una interfaz completamente rediseñada, nuevas aplicaciones, una integración más profunda con los frameworks y mejoras adicionales de rendimiento. Hemos perfeccionado todos los aspectos del teléfono para ofrecer a los jugadores una experiencia más inmersiva y pulida.

Interfaz de usuario rediseñada

La interfaz de v2 presenta un lenguaje de diseño moderno con efecto glassmorphism, animaciones más fluidas y una jerarquía visual mejorada. La pantalla de inicio ahora admite fondos de pantalla personalizados y permite organizar los iconos de las aplicaciones, para que los jugadores puedan personalizar su teléfono. Hemos rediseñado por completo las notificaciones con un nuevo centro que agrupa las alertas por aplicación y permite realizar acciones rápidas directamente desde cada notificación. El aspecto y la experiencia general acercan mucho más el teléfono del juego a lo que los jugadores esperan de un smartphone real.

Nuevas aplicaciones

Varias aplicaciones nuevas amplían lo que los jugadores pueden hacer con su teléfono. Una aplicación de galería permite guardar y ver capturas de pantalla del juego. La aplicación de notas ofrece una forma sencilla pero eficaz de guardar información durante el roleplay. Una aplicación bancaria mejorada, con historial de transacciones y opciones para hacer transferencias, ofrece a los jugadores una experiencia completa de banca móvil. La aplicación de mercado permite publicar anuncios de artículos entre jugadores, lo que añade una nueva dimensión al roleplay económico.

Mejoras de rendimiento

Aunque Agency Phone ya mantenía un consumo de 0.00ms en reposo, v2 optimiza aún más los escenarios de uso activo. Hemos reestructurado el sistema de carga de aplicaciones para usar carga diferida, lo que significa que las aplicaciones solo inicializan sus componentes de interfaz cuando se abren. Esto reduce el uso de memoria cuando el teléfono está abierto y permite cambiar de aplicación más rápido. También hemos optimizado la capa de comunicación NUI para reducir la cantidad de eventos que se envían entre el cliente y la interfaz.

Proceso de actualización

Los usuarios actuales de Agency Phone pueden actualizar a v2 mediante el proceso habitual de descarga de Tebex. La migración está diseñada para conservar los datos existentes, incluidos los contactos, los mensajes y el historial de llamadas. La documentación incluye una guía detallada de migración, y el equipo de Agency Scripts en Discord está disponible para responder cualquier pregunta sobre la actualización. Recomendamos probarla en un servidor de desarrollo antes de implementarla en producción para comprobar que sea compatible con tus configuraciones personalizadas.

Instalación y configuración de v2

La actualización de v1 a v2 sigue el proceso habitual de descarga de una actualización en Tebex. Descarga la nueva versión desde tu biblioteca de Tebex, sustituye la carpeta del recurso en tu servidor y reinícialo. El script de migración en sql/migrate_v1_to_v2.sql gestiona los cambios del esquema. Ejecútalo una vez en tu base de datos existente antes de reiniciar el recurso. Se conservarán los contactos, el historial de mensajes y el historial de llamadas existentes.

Si instalas Agency-Phone por primera vez con v2, importa phone.sql, copia la carpeta del recurso y añade ensure agency-phone a server.cfg. El recurso detecta QBCore o ESX automáticamente. En las configuraciones standalone, implementa el adaptador en config.lua.

Opciones de configuración en v2

El archivo config.lua de v2 es totalmente compatible con las configuraciones de v1 e incluye opciones adicionales para las nuevas funciones:

• Biblioteca de fondos de pantalla, especifica las URL de fondos de pantalla permitidas o habilita el endpoint CDN para que los jugadores puedan subir sus propios fondos.
• Distribución de los iconos de las aplicaciones, tamaño de la cuadrícula (4x5, 4x6) y opción para que los jugadores reorganicen las aplicaciones.
• Comportamiento del centro de notificaciones, cantidad máxima de notificaciones guardadas, umbral para descartarlas deslizando y botones de acción rápida por aplicación.
• Almacenamiento de la galería, endpoint CDN para capturas de pantalla y cuota de almacenamiento por jugador (en MB).
• Configuración del mercado, duración antes de que caduquen los anuncios, opción para exigir la aprobación de un administrador y porcentaje de la tarifa por transacción.
• Integración de la aplicación bancariaconéctalo a QBCore banking, ESX banking o una función bancaria personalizada.
• Carga diferida, qué apps usan inicialización diferida (todas por defecto en v2) y si se deben precargar apps específicas al abrir el teléfono.

Compatibilidad con frameworks en v2

v2 mantiene el mismo patrón de adaptador de framework que v1. Si personalizaste el adaptador en v1, tus cambios se mantienen, la interfaz del adaptador no ha cambiado. Las nuevas apps añadidas en v2 (galería, notas, marketplace) usan las mismas funciones del adaptador. No se necesitan nuevas implementaciones específicas para cada framework para las nuevas funciones.

Por qué el rediseño de v2 importa para el roleplay

El teléfono v1 ya era el teléfono para FiveM con mejor rendimiento del mercado. El rediseño de v2 aborda un problema distinto: la diferencia entre el aspecto del teléfono y la sensación de usar un smartphone real. La pantalla de inicio rediseñada, con fondos de pantalla personalizables e iconos de apps que puedes reorganizar, es el primer cambio que notan los jugadores, pero lo que realmente consigue es que sientan que el teléfono refleja su personalidad. Un teléfono que se siente personal es un objeto en el que los jugadores invierten como parte de su personaje.

El rediseño del centro de notificaciones tiene el mayor impacto práctico en el juego diario. En v1, las notificaciones aparecían como avisos emergentes y desaparecían. En v2, se acumulan en un centro con acciones rápidas: aceptar o rechazar una llamada desde la notificación, responder a un mensaje sin abrir la app de SMS, aprobar una transacción del marketplace. La menor fricción, gracias a que hay que abrir menos menús por acción, se acumula durante una sesión y hace que usar el teléfono sea notablemente más fluido.

La app de marketplace abre toda una capa económica que antes requería coordinarse fuera de personaje. Los jugadores que quieren vender artículos a otros jugadores los publican en el marketplace, y quienes compran pueden explorarlo y realizar compras sin salir del teléfono. La negociación se lleva a cabo por mensajes directos. La coordinación para recoger los artículos se hace por SMS. Toda la transacción ocurre dentro del personaje, y eso es lo que convierte una transacción en RP.

Qué no cambió en v2

Las características principales de rendimiento no cambiaron porque no hacía falta. El uso de 0.00ms en reposo, el patrón de adaptador independiente del framework y la arquitectura de carga diferida son los cimientos sobre los que se construyó la interfaz de v2. Añadimos las nuevas apps de galería, notas y marketplace sin tocar la capa de rendimiento. v2 tiene más funciones, no más consumo de recursos.

Las apps de contactos, SMS y llamadas tienen un aspecto renovado en v2, pero su funcionamiento es idéntico. Los jugadores que dependían de comportamientos específicos de v1, como los hilos de mensajes, los SMS grupales y el registro de llamadas, encontrarán esos mismos comportamientos en v2 con una presentación visual mejorada. La migración es sencilla para las comunidades consolidadas, precisamente porque no cambiamos lo que ya funcionaba.

Preguntas frecuentes sobre v2

¿Puedo volver a v1 si v2 causa problemas en mi servidor?

Sí, las descargas de v1 siguen disponibles en tu biblioteca de Tebex. El esquema de la base de datos de v1 es compatible, y el SQL de migración solo añade tablas, no modifica las existentes. Para volver atrás, cambia a la carpeta del recurso de v1 e ignora las nuevas tablas. No es lo ideal, pero es seguro si surge un problema grave de compatibilidad durante los primeros días de una implementación de v2.

¿La app de marketplace requiere una configuración especial del backend?

El marketplace usa la base de datos oxmysql existente. No hace falta ningún backend adicional. Los anuncios se guardan en una nueva phone_marketplace tabla creada por el SQL de migración. El marketplace funciona completamente dentro del servidor y no depende de API externas.

¿Los administradores pueden moderar los anuncios del marketplace?

Sí. Activa el modo de aprobación en config.lua y los nuevos anuncios aparecerán en una cola de moderación, accesible desde Agency-Admin o desde el panel de administración del propio teléfono (disponible para jugadores con la marca de administrador). Se recomienda para servidores donde los jugadores podrían intentar publicar artículos prohibidos o eludir las restricciones de la economía del juego mediante el marketplace.

¿El almacenamiento de la galería se comparte entre personajes de la misma cuenta?

Por defecto, el almacenamiento de la galería es por personaje, no por cuenta. Las capturas de pantalla se asocian al personaje que las hizo. En sistemas mult personaje donde los jugadores quieren compartir capturas de pantalla entre sus personajes, configura Config.GalleryByAccount = true para usar el identificador del jugador en lugar del identificador del personaje como clave de almacenamiento.

Requisitos

• Servidor FiveM (QBCore, ESX o standalone)
• oxmysql
• cuenta de cfx.re con una licencia válida de Agency-Phone
• Endpoint de CDN de fotos para la función de galería (opcional, si no se configura, solo se usan URL)