如何为FiveM手机脚本创建自定义应用

Agency Phone App Architecture

Agency Phone 的设计充分考虑了扩展性，服务器开发者可以创建与手机界面无缝集成的自定义应用。每个应用都是独立模块，拥有自己的 HTML、CSS 和 JavaScript，并通过定义完善的 API 与手机框架通信。因此，你可以构建各种功能，从赛车应用、房地产管理器到自定义调度系统，玩家都能在熟悉的手机上使用这些应用。

设置您的应用结构

要创建自定义应用，首先在Agency Phone应用目录内创建一个新文件夹。您的应用需要一个 app.json 定义应用名称、图标、描述和入口点的清单文件。清单还指定应用所需权限，如访问联系人、通知或GPS数据。创建清单中引用的主HTML文件，以及应用所需的CSS和JavaScript文件。电话框架会自动发现并注册遵循此结构的应用。

使用 App API

Agency Phone提供JavaScript API，供你的应用与手机功能交互。调用 AgencyPhone.getContacts() 访问玩家联系人列表， AgencyPhone.sendNotification() 推送通知，或 AgencyPhone.getPlayerData() 检索框架中的当前玩家信息。API还提供导航方法以在应用屏幕之间切换、用于持久化应用特定数据的存储API，以及生命周期管理的事件钩子，如应用打开、最小化或关闭时。

连接到服务器端逻辑

大多数自定义应用需与服务器端脚本通信以实现数据持久化和安全操作。使用手机 NUI 回调系统从应用 JavaScript 向 Lua 服务器脚本发送请求。在依赖 Agency Phone 的 companion 资源中注册服务器端处理程序，进行适当验证处理请求并返回结果。此分离确保应用逻辑安全运行于服务器，UI 保持客户端响应。

应用样式

Agency Phone 提供与手机主题相匹配的 CSS 变量和实用类，让你的自定义应用与内置应用保持一致。使用提供的背景、文本和强调色变量，确保应用能够自动适配浅色和深色主题。手机容器会处理滚动、尺寸和安全区域内边距，因此你只需专注于应用视口内的内容布局。请在不同手机框架尺寸下测试应用，确保它在各种分辨率上都能正常显示。

发布与分发

应用完成后，将其打包为依赖Agency Phone的独立资源。文档中包含清晰的安装说明、配置选项和示例截图。如果计划在Tebex销售，确保遵守托管指南并附上演示视频展示应用功能。考虑提供免费基础版本和高级功能，吸引更多服务器所有者并在购买前建立信任。