Agency-Notify V2 Eksporty & API
System powiadomień ze stylami V1 Classic i V2 Ultra, ustawieniami w grze, inteligentnym priorytetem AgencyAI, ochroną.
01Eksporty klienta
| Eksport | Opis |
|---|---|
Notify(data: { title, text, type, duration, ... }) | Displays a v2 notification with optional Smart Mode priority/duration/spam handling. |
02Eventy
| Nazwa | Strona | Opis |
|---|---|---|
Agency:Notify:Send | Klient | Punkt wejścia Legacy v1 do wyświetlania powiadomienia z takim samym payloadem jak export. |
Agency:Notify:LoadSettings | Klient | Stosuje zapisane ustawienia UI gracza (pozycję, kolor, skalę, styl) z serwera. |
Agency:Notify:SaveSettings | Serwer | Weryfikuje i zapisuje ustawienia powiadomień gracza (pozycja, akcent, skala, styl). |
+Warto wiedzieć
Ta strona zawiera listę dostępnych exportów i eventów dla Agency-Notify, umożliwiając innym zasobom wywoływanie powiadomień lub wchodzenie w interakcję z ustawieniami powiadomień gracza. Exporty i eventy są przeznaczone wyłącznie do użytku po stronie client-side, ponieważ nie ma exportów po stronie server-side. Integracja jest prosta i nie wymaga żadnych obowiązkowych zależności, chociaż oxmysql może być użyty do trwałego zapisywania ustawień, jeśli włączono go w konfiguracji.
- Użycie eksportów klienta
- Eksport Notify jest dostępny po stronie klienta i pozwala wyświetlić powiadomienie V2 z obsługą funkcji Smart Mode, takich jak inteligentny priorytet, czas trwania i ochrona przed spamem. Możesz przekazać obiekt data z polami takimi jak title, text, type i duration, aby dostosować powiadomienie.
- Wsparcie Legacy Event
- Agency-Notify zawiera kompatybilność ze starszą wersją v1 poprzez event kliencki Agency:Notify:Send. Ten event przyjmuje taki sam payload jak export Notify, co ułatwia aktualizację starszych skryptów i zachowanie kompatybilności wstecznej przy minimalnych zmianach.
- Zdarzenia trwałości ustawień
- Dwa eventy zarządzają ustawieniami powiadomień gracza: Agency:Notify:LoadSettings (client) stosuje zapisane preferencje UI, natomiast Agency:Notify:SaveSettings (server) waliduje i zapisuje na stałe ustawienia, takie jak pozycja, kolor, skala i styl. Zapisywanie wymaga oxmysql i musi być włączone w pliku config.
?Często zadawane pytania
Czy w Agency-Notify dostępne są eksporty po stronie serwera?
Nie, Agency-Notify udostępnia tylko exporty po stronie klienta. Całe wywoływanie powiadomień i zarządzanie ustawieniami odbywa się na kliencie, a zdarzenia zapisu są dostępne do zapisywania i wczytywania ustawień, jeśli włączony jest oxmysql.
Czy oxmysql jest wymagany do działania Agency-Notify?
oxmysql jest opcjonalny. Jest potrzebny tylko wtedy, gdy chcesz włączyć trwały zapis ustawień powiadomień graczy w bazie danych. Bez oxmysql powiadomienia i ustawienia UI działają normalnie, ale ustawienia nie będą zapisywane między sesjami.
Jak wywołać powiadomienie z poziomu innego resource?
Możesz użyć client exportu Notify, aby wyświetlić powiadomienie. Przekaż obiekt data z wymaganymi polami (title, text, type, duration itd.). Alternatywnie użyj client eventu Agency:Notify:Send dla zachowania kompatybilności wstecznej z tą samą strukturą payloadu.
Co sprawdzić, jeśli powiadomienia się nie pojawiają?
Upewnij się, że Agency-Notify uruchamia się poprawnie za pomocą ensure Agency-Notify w server.cfg. Sprawdź, czy wywołujesz export lub event klienta z prawidłowymi danymi. Jeśli korzystasz z trwałości danych (persistence), upewnij się, że oxmysql jest zainstalowany i włączony w konfiguracji.