Arquitetura do aplicativo de telefone da agência
O Agency Phone foi projetado pensando na extensibilidade, permitindo que os desenvolvedores de servidores criem aplicativos personalizados que se integram perfeitamente à interface do telefone. Cada aplicativo é executado como um módulo independente com seu próprio HTML, CSS e JavaScript, comunicando-se com a estrutura do telefone por meio de uma API bem definida. Essa arquitetura significa que você pode criar qualquer coisa, desde um aplicativo de corrida até um gerenciador de imóveis e um sistema de despacho personalizado, tudo acessível a partir do telefone que os jogadores já sabem usar.
Configurando a estrutura do seu aplicativo
Para criar um aplicativo personalizado, comece criando uma nova pasta dentro do diretório de aplicativos do Agency Phone. Seu aplicativo precisa de um arquivo de manifesto app.json que defina o nome, o ícone, a descrição e o ponto de entrada do aplicativo. O manifesto também especifica as permissões exigidas pelo seu aplicativo, como acesso a contatos, notificações ou dados de GPS. Crie seu arquivo HTML principal referenciado no manifesto, junto com quaisquer arquivos CSS e JavaScript que seu aplicativo precise. A estrutura do telefone descobre e registra automaticamente aplicativos que seguem essa estrutura.
Usando a API do aplicativo
O telefone da agência expõe uma API JavaScript que seu aplicativo pode usar para interagir com recursos do telefone. Chame AgencyPhone.getContacts() para acessar a lista de contatos do jogador, AgencyPhone.sendNotification() para notificações push ou AgencyPhone.getPlayerData() para recuperar as informações atuais do jogador da estrutura. A API também fornece métodos de navegação para alternar entre telas de aplicativos, uma API de armazenamento para persistir dados específicos do aplicativo e ganchos de eventos para gerenciamento do ciclo de vida, como quando seu aplicativo é aberto, minimizado ou fechado.
Conectando-se à lógica do lado do servidor
A maioria dos aplicativos personalizados precisa se comunicar com scripts do lado do servidor para persistência de dados e operações seguras. Use o sistema de retorno de chamada NUI do telefone para enviar solicitações do JavaScript do seu aplicativo para um script do servidor Lua. Registre seus manipuladores do lado do servidor em um recurso complementar que depende do Telefone da Agência, processe as solicitações com a devida validação e retorne os resultados. Essa separação garante que a lógica do seu aplicativo seja executada com segurança no servidor enquanto a IU permanece responsiva no cliente.
Estilizando seu aplicativo
O Agency Phone fornece variáveis CSS e classes utilitárias que correspondem ao tema do telefone, para que seu aplicativo personalizado possa parecer consistente com os aplicativos integrados. Use as variáveis de cores fornecidas para planos de fundo, texto e destaques para garantir que seu aplicativo se adapte automaticamente a temas claros e escuros. O contêiner do telefone lida com rolagem, dimensionamento e inserções de área segura, portanto, concentre seu CSS no layout do conteúdo na janela de visualização do aplicativo. Teste seu app em diferentes tamanhos de moldura de telefone para garantir que ele fique bem em todas as resoluções.
Publicação e distribuição
Depois que seu aplicativo estiver concluído, empacote-o como um recurso independente que depende do telefone da agência. Inclua instruções claras de instalação, opções de configuração e exemplos de capturas de tela em sua documentação. Se você planeja vender seu aplicativo no Tebex, certifique-se de que ele siga as diretrizes de garantia e inclua um vídeo de demonstração mostrando o aplicativo em ação. Considere oferecer uma versão básica gratuita com recursos premium para atrair mais proprietários de servidores e construir confiança em seu trabalho de desenvolvimento antes de se comprometer com uma compra.