Pulse Phone 文档
Pulse Phone — 快速入门
安装一个名为 phone 的资源。保留你现有的框架和受支持的脚本；Pulse 启动时会自动识别它们。
PhoneHub + Pulse 是单独的版本，有自己的授权和自带的一份这部手机。如果你购买的是那个版本，请改为按照它自己的安装指南操作：一台服务器只运行一个手机资源。
1. 检查你的服务器
| 项目 | 是否需要？ |
|---|---|
| 开启 OneSync，游戏版本 2699 或更新 | 必需 |
| 数据库：oxmysql（或 mysql-async、ghmattimysql），搭配 MariaDB 10.6+ 或 MySQL 8 | 建议。没有 SQL 资源时，手机会把数据保存在服务器的键值存储中 |
| 一个语音资源：pma-voice、mumble-voip、SaltyChat、TokoVOIP 或 YACA | 建议。没有的话，通话能接通但没有声音 |
| screenshot-basic | 建议，以便相机保存照片。标准资源即可 |
| 框架和背包 | 可选。没有的话，手机以 standalone 模式运行 |
在 Pulse 之前启动数据库、框架、背包、语音资源和 screenshot-basic。正确顺序见运行要求和你的框架。
首次启动前请备份数据库。Pulse 会创建自己的数据表。如果其他手机留下了同名表，它们会被重命名为 old_<name>（不删除任何数据）；详见运行要求。
2. 复制 phone 文件夹
从你的 Cfx.re 账户下载所购内容。把 phone 文件夹（其中包含 fxmanifest.lua）复制到服务器的 resources 中。保留其名称。你的服务器密钥必须属于拥有该资源的账户。
用 FTP 上传（托管服务器）：请使用 Binary 模式（FileZilla：Transfer > Transfer Type > Binary），或上传 zip 后在服务器上解压。Auto 模式会改动加密文件，导致手机无法启动；症状和修复方法见故障排查。你上传的文件夹必须与下表一致；启动检查会指出任何缺失或大小不对的文件。
Pulse Phone 1.4.2 下载包：
| 文件夹或文件 | 文件数 | 大小 |
|---|---|---|
ui/ |
3,932 | 78.3 MB |
stream/ |
40 | 30.5 MB |
config/ |
138 | 23.2 MB |
d6c1e95a/（锁定的代码；其名称每个版本都不同） |
7 | 5.5 MB |
data/ |
2 | 1.4 MB |
bridge/ |
55 | 0.5 MB |
guides/ |
13 | 0.2 MB |
phone.sql |
1 | 0.2 MB |
fxmanifest.lua |
1 | 6 KB |
整个 phone 文件夹 |
4,204 | 139.7 MB |
更新现有安装？请先按照更新操作，以保留设置和玩家媒体。切换到 Pulse 之前，先停止之前的手机资源。
3. 添加背包物品
打开背包，按照你所用背包的说明操作。提供的定义和图片在 config/items/ 中。把条目合并进你的背包；不要替换它的整个物品文件。
ESX 默认背包和 QBCore 可以自动注册缺失的定义。其他背包可能需要使用提供的条目。把物品图片复制到你的背包需要的位置。没有背包的 standalone 不需要物品。
4. 启动 Pulse
在 config/config.lua 中保持自动识别。第一部分包含框架、语言、背包选择、手机物品和按键。可选设置的索引见配置。
在 server.cfg 中现有依赖之后添加：
ensure phone
add_ace group.admin phone.admin allow重启服务器。SQL 连接可用时，Pulse 会创建数据表。阅读控制台中的检查结果，并按照修正说明操作。运行 phone:health 可再次检查。
5. 打开你的手机
以管理员身份进入服务器，打开 F8 并输入 phone:setup。确认识别到的框架和背包，然后完成引导式设置。按 F1 或使用 /phone 打开手机。如果你的设置要求物品，请先购买一部手机，并从背包中使用它的盒子。
在 Settings → Server 中保存的设置会覆盖文件中对应的设置。如果你想让文件中的值重新生效，请在那里重置已保存的覆盖值。
6. 可选：更轻量的 screenshot-basic
你的下载中还包含一个 screenshot-basic 文件夹。它是 CitizenFX 的 screenshot-basic（MIT 许可），只改了一处：原版即使没人拍照，也会每帧为其截图层重绘游戏画面，而这个版本只在拍照时才绘制。资源名称、导出函数（requestScreenshot、requestScreenshotUpload、requestClientScreenshot）和事件都没有变，而且已预先构建好，首次启动时无需自行构建。改动的文件列在 screenshot-basic/ZERODEV-CHANGES.md 中。
Pulse 两个版本都能用，所以这一步是可选的。你服务器上的其他脚本也在使用 screenshot-basic，所以如果有测试服务器，请先在那里切换：
- 重命名你当前的
screenshot-basic文件夹（例如改为screenshot-basic.bak），并把它移出resources，以便之后放回。 - 把我们的版本复制到
resources中，使用相同的名称screenshot-basic，并保留同样的ensure screenshot-basic一行。 - 重启服务器，测试每个会截图的脚本：手机相机，以及你运行的任何举报、证据或执法记录仪工具。
- 如果有任何异常，删除我们的版本，把你原来的文件夹以
screenshot-basic放回，然后重启。
设置你要用的功能
- 通话、视频和 Live：支持的语音资源、通话控制和正式环境的视频连接设置。
- 照片和视频：内置存储、FiveManage 和其他上传选项。私密服务密钥保留在你的服务器配置中。在 Web 端口无法访问的托管服务器上，照片需要使用 FiveManage：在
server.cfg中加两行（set phone_media_provider "fivemanage"和set phone_fivemanage_token "<token>"）。 - 配置：商店、应用、配件、语言和可选功能。
- 故障排查：找到症状并按修复方法操作。
- 开发者集成：自定义脚本和进阶连接设置。
正常安装无需编辑 bridge/、ui/ 或 stream/。保持资源完整，包括其模型和地图资源文件。