Agency Phone v2: Novos recursos, aplicativos e melhorias de desempenho

Novidades na v2

Agency Phone v2 é a maior atualização desde o lançamento original. Com base em um amplo feedback da comunidade e meses de desenvolvimento, esta versão traz uma interface totalmente redesenhada, novos aplicativos, integração mais profunda com frameworks e melhorias adicionais de desempenho. Todos os aspectos do telefone foram aprimorados para oferecer aos jogadores uma experiência mais imersiva e refinada.

Interface de usuário redesenhada

A interface da v2 apresenta uma linguagem visual moderna de glassmorphism, com animações mais suaves e hierarquia visual aprimorada. A tela inicial agora permite personalizar papéis de parede e a disposição dos ícones dos apps, deixando os jogadores personalizarem seus telefones. As notificações foram totalmente reformuladas com uma nova central que agrupa alertas por app e oferece ações rápidas diretamente na notificação. O visual e a experiência geral aproximam muito mais o telefone do jogo daquilo que os jogadores esperam de um smartphone real.

Novos aplicativos

Vários novos apps ampliam o que os jogadores podem fazer com o telefone. Um app de galeria dedicado permite salvar e visualizar capturas de tela feitas no jogo. O app de notas oferece uma maneira simples, mas eficiente, de guardar informações durante o roleplay. Um app de banco aprimorado, com histórico de transações e recursos de transferência, oferece aos jogadores uma experiência completa de banco pelo celular. O app de marketplace permite anúncios de itens entre jogadores, criando uma nova camada de RP econômico.

Melhorias de desempenho

Embora Agency Phone já mantivesse o uso em idle em 0.00ms, a v2 otimiza ainda mais os cenários de uso ativo. O sistema de carregamento dos apps foi reestruturado para usar carregamento sob demanda, o que significa que os apps inicializam os componentes da interface apenas quando são abertos. Isso reduz o consumo de memória com o telefone aberto e agiliza a troca entre apps. A camada de comunicação NUI foi otimizada para reduzir a quantidade de eventos disparados entre o cliente e a interface.

Processo de atualização

Quem já usa Agency Phone pode atualizar para a v2 pelo processo padrão de download da Tebex. A migração foi projetada para preservar os dados existentes, incluindo contatos, mensagens e registros de chamadas. Há um guia detalhado de migração na documentação, e a equipe do Agency Scripts no Discord está disponível para ajudar com dúvidas sobre a atualização. Recomendamos testar a atualização em um servidor de desenvolvimento antes de implantá-la em produção, para garantir a compatibilidade com suas configurações personalizadas.

Instalação e configuração da v2

A atualização da v1 para a v2 segue o processo padrão de atualização por download da Tebex. Baixe a nova versão pela sua biblioteca da Tebex, substitua a pasta do recurso no seu servidor e reinicie-o. O script de migração em sql/migrate_v1_to_v2.sql lida com as alterações de schema. Execute-o uma vez no banco de dados existente antes de reiniciar o recurso. Os contatos, o histórico de mensagens e os registros de chamadas existentes serão preservados.

Se estiver instalando Agency-Phone pela primeira vez na v2, importe phone.sql , coloque a pasta do recurso e adicione ensure agency-phone a server.cfgO recurso detecta automaticamente QBCore ou ESX. Em configurações standalone, implemente o adaptador em config.lua.

Opções de configuração na v2

O config.lua da v2 é totalmente compatível com versões anteriores das configurações da v1, com opções adicionais para os novos recursos:

• Biblioteca de papéis de parede, especifique URLs de papéis de parede permitidas ou habilite o endpoint de CDN para uploads dos jogadores.
• Layout dos ícones de aplicativos, tamanho da grade (4x5, 4x6) e se os jogadores podem reorganizar os ícones dos aplicativos.
• Comportamento da central de notificações, máximo de notificações armazenadas, limite de deslize para dispensar e botões de ação rápida por aplicativo.
• Armazenamento da galeria, endpoint de CDN para capturas de tela e cota de armazenamento por jogador (em MB).
• Configurações do marketplace, duração até o anúncio expirar, se os anúncios precisam de aprovação de um administrador e porcentagem da taxa de transação.
• Integração com o aplicativo bancário, conecte ao sistema bancário do QBCore, do ESX ou a uma função bancária personalizada.
• Carregamento sob demanda, quais aplicativos usam inicialização sob demanda (todos por padrão na v2) e se aplicativos específicos devem ser pré-carregados quando o telefone é aberto.

Compatibilidade com frameworks na v2

A v2 mantém o mesmo padrão de adaptador de framework da v1. Se você personalizou o adaptador na v1, suas alterações continuam valendo, a interface do adaptador não mudou. Os novos aplicativos adicionados na v2 (galeria, notas, marketplace) usam as mesmas funções do adaptador. Não são necessárias novas implementações específicas para cada framework para os novos recursos.

Por que o redesign da v2 é importante para o roleplay

O telefone da v1 já era o telefone para FiveM com melhor desempenho do mercado. O redesign da v2 resolve outro problema: a diferença entre a aparência do telefone e a sensação de usar um smartphone de verdade. A tela inicial redesenhada, com papéis de parede personalizáveis e ícones de aplicativos que podem ser reorganizados, é a primeira mudança que os jogadores notam, mas, na prática, ela dá aos jogadores controle sobre a personalidade do telefone. Um telefone que parece pessoal se torna um objeto em que os jogadores investem como parte do personagem.

O redesign da central de notificações tem o maior impacto prático na jogabilidade diária. Na v1, as notificações apareciam como alertas temporários e desapareciam. Na v2, elas se acumulam em uma central com ações rápidas: aceitar ou recusar uma ligação pela notificação, responder a uma mensagem sem abrir o aplicativo de SMS, aprovar uma transação do marketplace. A redução de etapas, com menos aberturas de menus por ação, se acumula ao longo da sessão e torna o uso do telefone visivelmente mais fluido.

O aplicativo do marketplace abre uma camada econômica que antes exigia coordenação fora do personagem. Os jogadores que querem vender itens a outros jogadores anunciam os itens no marketplace, e os compradores pesquisam e compram sem sair do telefone. A negociação acontece por mensagens diretas. A coordenação da retirada acontece por SMS. A transação inteira ocorre dentro do personagem, e é isso que transforma uma transação em RP.

O que não mudou na v2

As características centrais de desempenho não mudaram porque não precisavam. O uso ocioso de 0.00ms, o padrão de adaptador independente de framework e a arquitetura de carregamento sob demanda são as bases sobre as quais a interface da v2 foi construída. Adicionamos os novos aplicativos de galeria, notas e marketplace sem tocar na camada de desempenho. A v2 tem mais recursos, não maior consumo de recursos.

Os aplicativos de contatos, SMS e chamadas foram atualizados visualmente na v2, mas continuam funcionalmente iguais. Os jogadores que dependiam de comportamentos específicos da v1, como conversas agrupadas, SMS em grupo e registros de chamadas, encontram os mesmos recursos na v2, com uma apresentação visual aprimorada. A migração é simples para comunidades estabelecidas justamente porque não mudamos o que já funcionava.

Perguntas frequentes sobre a v2

Posso voltar para a v1 se a v2 causar problemas no meu servidor?

Sim, os downloads da v1 continuam disponíveis na sua biblioteca do Tebex. O esquema do banco de dados da v1 é compatível, e o SQL de migração apenas adiciona tabelas, sem modificar as existentes. Para voltar, basta mudar para a pasta de recursos da v1 e ignorar as novas tabelas. Não é o ideal, mas é seguro caso surja um problema crítico de compatibilidade nos primeiros dias de implantação da v2.

O aplicativo do marketplace exige alguma configuração especial no backend?

O marketplace usa o banco de dados oxmysql existente. Não é necessário nenhum backend adicional. Os anúncios são armazenados em uma nova phone_marketplace tabela criada pelo SQL de migração. O marketplace funciona inteiramente no servidor, sem dependências de APIs externas.

Administradores podem moderar anúncios do marketplace?

Sim. Ative o modo de aprovação em config.lua e os novos anúncios aparecerão em uma fila de moderação acessível pelo Agency-Admin ou pelo próprio painel de administração do telefone, acessível a jogadores com a flag de administrador. Isso é recomendado para servidores onde os jogadores podem tentar anunciar itens proibidos ou contornar as restrições da economia do jogo pelo marketplace.

O armazenamento da galeria é compartilhado entre personagens na mesma conta?

Por padrão, o armazenamento da galeria é por personagem, não por conta. As capturas de tela ficam associadas ao personagem que as fez. Para sistemas com vários personagens, em que os jogadores querem compartilhar capturas de tela entre personagens, configure Config.GalleryByAccount = true para usar o identificador do jogador em vez do identificador do personagem como chave de armazenamento.

Requisitos

• Servidor FiveM (QBCore, ESX ou standalone)
• oxmysql
• Conta cfx.re com uma licença válida do Agency-Phone
• Endpoint de CDN de fotos para o recurso de galeria (opcional, usa apenas URLs se não estiver configurado)