如何为FiveM电话脚本创建自定义应用

Agency Phone App Architecture

Agency Phone is designed with extensibility in mind, allowing server developers to create custom apps that integrate seamlessly with the phone interface. Each app runs as a self-contained module with its own HTML, CSS, and JavaScript, communicating with the phone framework through a well-defined API. This architecture means you can build anything from a racing app to a real estate manager to a custom dispatch system, all accessible from the phone that players already know how to use.

设置您的应用结构

要创建自定义应用，首先在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 provides CSS variables and utility classes that match the phone theme, so your custom app can look consistent with built-in apps. Use the provided color variables for backgrounds, text, and accents to ensure your app adapts to light and dark themes automatically. The phone container handles scrolling, sizing, and safe area insets, so focus your CSS on the content layout within the app viewport. Test your app across different phone frame sizes to ensure it looks good on all resolutions.

发布与分发

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