01Client Exports
| 导出 | 说明 |
|---|---|
Notify(data: { title, text, type, duration, ... }) | Displays a v2 notification with optional AgencyAI smart-priority/duration/spam handling. |
02事件
| 名称 | 端 | 说明 |
|---|---|---|
Agency:Notify:Send | Client | Legacy v1 entry point to display a notification with the same payload as the export. |
Agency:Notify:LoadSettings | Client | Applies per-player saved UI settings (position, color, scale, style) from the server. |
Agency:Notify:SaveSettings | Server | Validates and persists the player's notify settings (position, accent, scale, style). |
+值得了解
本页列出了 Agency-Notify 的可用导出和事件，允许其他资源触发通知或与玩家通知设置交互。导出和事件仅用于客户端，因为没有服务器端导出。集成简单，不需要强制依赖，但如果在配置中启用，oxmysql 可用于持久化设置存储。
- 客户端导出用法
- Notify 导出可在客户端使用，允许您显示支持 AgencyAI 功能的 V2 通知，如智能优先级、持续时间和防刷屏保护。您可以传递包含 title、text、type 和 duration 等字段的数据对象来自定义通知。
- 旧版事件支持
- Agency-Notify 通过 Agency:Notify:Send 客户端事件包含了对旧版 v1 的兼容性。该事件接受与 Notify 导出相同的负载，使更新旧脚本或保持向后兼容变得简单，且只需最小更改。
- 设置持久化事件
- 两个事件管理玩家通知设置：Agency:Notify:LoadSettings（客户端）应用已保存的 UI 偏好设置，Agency:Notify:SaveSettings（服务器端）验证并持久化位置、颜色、缩放和样式等设置。持久化需要 oxmysql 并且必须在配置中启用。
?常见问题
Agency-Notify 有服务器端导出吗？
没有，Agency-Notify 仅提供客户端导出。所有通知触发和设置管理均在客户端处理，如果启用了 oxmysql，则提供持久化事件用于保存和加载设置。
Agency-Notify 需要 oxmysql 才能运行吗？
oxmysql是可选的。只有当您想启用玩家通知设置的数据库持久化时才需要它。没有oxmysql，通知和UI设置照常工作，但设置不会在会话之间保存。
我如何从另一个资源触发通知？
您可以使用Notify客户端导出显示通知。传递包含所需字段（标题、文本、类型、持续时间等）的数据对象。或者，使用Agency:Notify:Send客户端事件以相同的负载结构实现旧版兼容。
如果通知没有出现，我应该检查什么？
确保在 server.cfg 中使用 ensure Agency-Notify 正确启动 Agency-Notify。检查您是否使用正确的数据负载调用客户端导出或事件。如果使用持久化，请确认已安装并在配置中启用 oxmysql。