Agency-Notify Exports & API
Benachrichtigungssystem mit V1 Classic und V2 Ultra Stilen, Spieleinstellungen, AgencyAI intelligenter Priorität.
01Client Exports
| Export | Beschreibung |
|---|---|
Notify(data: { title, text, type, duration, ... }) | Displays a v2 notification with optional AgencyAI smart-priority/duration/spam handling. |
02Events
| Name | Seite | Beschreibung |
|---|---|---|
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). |
+Gut zu wissen
Diese Seite listet die verfügbaren exports und Events für Agency-Notify auf, die es anderen Ressourcen ermöglichen, Benachrichtigungen auszulösen oder mit den Benachrichtigungseinstellungen der Spieler zu interagieren. Exports und Events sind nur für die Client-Seite verfügbar, da es keine serverseitigen exports gibt. Die Integration ist unkompliziert und erfordert keine zwingenden Abhängigkeiten, obwohl oxmysql für die persistente Speicherung der Einstellungen verwendet werden kann, wenn es in der Konfiguration aktiviert ist.
- Verwendung von Client-Exports
- Der Notify-Export ist auf der Client-Seite verfügbar und ermöglicht das Anzeigen einer V2-Benachrichtigung mit Unterstützung für AgencyAI-Funktionen wie intelligente Priorität, Dauer und Spam-Schutz. Sie können ein Datenobjekt mit Feldern wie title, text, type und duration übergeben, um die Benachrichtigung anzupassen.
- Unterstützung für Legacy-Events
- Agency-Notify beinhaltet Legacy-Kompatibilität der Version 1 über das Client-Event Agency:Notify:Send. Dieses Event akzeptiert die gleiche Nutzlast wie der Notify-Export, was es einfach macht, ältere Skripte zu aktualisieren oder die Abwärtskompatibilität mit minimalen Änderungen zu gewährleisten.
- Ereignisse zur Persistenz der Einstellungen
- Zwei Events verwalten die Benachrichtigungseinstellungen der Spieler: Agency:Notify:LoadSettings (Client) wendet gespeicherte UI-Präferenzen an, während Agency:Notify:SaveSettings (Server) Einstellungen wie Position, Farbe, Skalierung und Stil validiert und speichert. Persistenz erfordert oxmysql und muss in der Konfiguration aktiviert sein.
?Häufige Fragen
Gibt es serverseitige exports in Agency-Notify?
Nein, Agency-Notify bietet nur clientseitige exports. Das Auslösen von Benachrichtigungen und die Verwaltung der Einstellungen erfolgen auf dem Client, mit Persistenz-Events zum Speichern und Laden der Einstellungen, falls oxmysql aktiviert ist.
Ist oxmysql erforderlich, damit Agency-Notify funktioniert?
oxmysql ist optional. Es wird nur benötigt, wenn Sie die Datenbankpersistenz für Benachrichtigungseinstellungen der Spieler aktivieren möchten. Ohne oxmysql funktionieren Benachrichtigungen und UI-Einstellungen wie gewohnt, aber die Einstellungen werden nicht zwischen den Sitzungen gespeichert.
Wie löse ich eine Benachrichtigung aus einer anderen Ressource aus?
Sie können den Notify Client-Export verwenden, um eine Benachrichtigung anzuzeigen. Übergeben Sie ein Datenobjekt mit den gewünschten Feldern (Titel, Text, Typ, Dauer usw.). Alternativ verwenden Sie das Client-Event Agency:Notify:Send für Legacy-Kompatibilität mit derselben Payload-Struktur.
Was sollte ich überprüfen, wenn Benachrichtigungen nicht angezeigt werden?
Stellen Sie sicher, dass Agency-Notify korrekt mit ensure Agency-Notify in Ihrer server.cfg gestartet wurde. Prüfen Sie, ob Sie den Client-Export oder das Event mit der korrekten Daten-Payload aufrufen. Wenn Sie Persistenz verwenden, vergewissern Sie sich, dass oxmysql installiert und in der Konfiguration aktiviert ist.