01客户端导出
| 导出 | 说明 |
|---|---|
IsPhoneOpen() | 手机界面当前处于打开状态时返回 true。 |
IsPhonePoweredOn() | 手机开机时返回 true（玩家关机后返回 false）。 |
GetPhoneData() | 返回客户端完整的 PhoneData 表（打开状态、元数据等）。 |
GetPhonePropEntity() | 返回手中手机道具的实体句柄，不可见时返回 0。 |
IsPhoneExpanded() | IsPhoneOpen() 的别名，为向后兼容而保留。 |
HasCarrierContract() | 玩家拥有有效的运营商流量套餐时返回 true。 |
GetPhoneState() | 返回汇总当前手机状态的表 { isOpen, poweredOn, syncEnabled }。 |
HasPhone() | 玩家背包中有配置的手机物品时返回 true。 |
RegisterAgencyPayPoint(id, data) | 在运行时于指定坐标注册一个 Agency Pay 终端（标记、地图图标、结账数据）。 |
RemoveAgencyPayPoint(id) | 按 id 移除之前注册的 Agency Pay 终端。 |
StartAgencyPayCheckout(data) | 必要时打开手机，并用给定的支付数据发起 Agency Pay 结账流程。 |
StartCall(contactData) | 向给定联系人发起呼出电话（{ name, number, ... }）。 |
PhoneNotification(title, text, icon, color, timeout, acceptIcon, denyIcon) | 显示带接受/拒绝按钮的通知，阻塞直到用户响应，并返回 true/false。 |
RegisterApp(config) | 把你自己资源中的应用放到手机主屏幕和 Store 中。返回 true，或返回 false 与错误信息。参见自定义应用。 |
UnregisterApp(id) | 移除通过 RegisterApp 添加的应用。注册该应用的资源停止时会自动移除。 |
GetRegisteredApps() | 返回其他资源注册的所有应用的表，以 id 为键。 |
ClosePhone() | 关闭手机，例如在打开你自己的界面之前。 |
IsPhoneRadioActive() | 返回两个值：手机电台正在播放时为 true，以及正在播放的电台。 |
StopPhoneRadio() | 停止手机电台。 |
02服务端导出
| 导出 | 说明 |
|---|---|
SendMail(identifier, mailData) | 按标识符向玩家的主邮箱发送邮件（返回是否成功）。 |
AddChirp(chirpData) | 以脚本身份在 Pulse 动态中发布一条帖子（{ identifier, firstName, lastName, message, postId }）。 |
usePhone(event, item, inventory, slot, data) | 检测到 ESX + ox_inventory 时注册的 ox_inventory 钩子；为背包持有者打开手机。 |
VerifyAgencyPayCharge(source, requestId, minAmount) | 在服务端确认该玩家在过去 60 秒内支付了此 id 的 Agency Pay 结账，金额不低于 minAmount，并将这笔付款标记为已使用，只计一次。requestId 是你传给 StartAgencyPayCheckout 的 id。返回 true 和金额，否则返回 false。请在发放商品之前调用。 |
03事件
| 名称 | 端 | 说明 |
|---|---|---|
agency-phone:client:notify | 客户端 | 显示一条手机通知（title、text、icon、color、timeout、silent）。 |
agency-phone:client:usePhoneItem | 客户端 | 使用背包中的手机物品时触发打开手机的流程。 |
agency-phone:client:openApp | 客户端 | 让手机按 id 跳转到自定义应用（供应用模块使用）。 |
agency-phone:client:newMailNotify | 客户端 | 通知客户端刚收到一封新邮件。 |
agency-phone:server:requestPhoneData | 服务端 | 为调用的玩家请求重新同步手机数据。 |
agency-phone:server:cancelCall | 服务端 | 取消或结束当前通话。 |
agency-phone:server:sendMessage | 服务端 | 发送一条短信（newMsg、targetNumber）。 |
agency-phone:server:saveSetting | 服务端 | 为玩家保存一项手机设置的键/值。 |
agency-phone:server:airdropPay | 服务端 | 执行 Agency Airdrop 向附近玩家付款的转账。 |
agency-phone:server:buyDataPlan | 服务端 | 为玩家购买运营商流量套餐（price、planName）。 |
agency-phone:dispatch:create | 服务端 | 根据紧急电话或短信创建派遣警情。 |