Agency-Notify Exports & API
Système de notification avec styles V1 Classic et V2 Ultra, paramètres en jeu, priorité intelligente AgencyAI.
01Client Exports
| Export | Description |
|---|---|
Notify(data: { title, text, type, duration, ... }) | Displays a v2 notification with optional AgencyAI smart-priority/duration/spam handling. |
02Événements
| Nom | Côté | Description |
|---|---|---|
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). |
+Bon à savoir
Cette page liste les exports et événements disponibles pour Agency-Notify, permettant à d'autres ressources de déclencher des notifications ou d'interagir avec les paramètres de notification des joueurs. Les exports et événements sont fournis uniquement côté client, car il n'y a pas d'exports côté serveur. L'intégration est simple et ne nécessite aucune dépendance obligatoire, bien que oxmysql puisse être utilisé pour le stockage persistant des paramètres si activé dans la configuration.
- Utilisation de l'export client
- L'export Notify est disponible côté client et vous permet d'afficher une notification V2 avec prise en charge des fonctionnalités AgencyAI, telles que la priorité intelligente, la durée et la protection contre le spam. Vous pouvez passer un objet data avec des champs comme title, text, type et duration pour personnaliser la notification.
- Support des événements legacy
- Agency-Notify inclut une compatibilité legacy v1 via l'événement client Agency:Notify:Send. Cet événement accepte la même charge utile que l'export Notify, facilitant la mise à jour des anciens scripts ou le maintien de la compatibilité avec un minimum de modifications.
- Événements de persistance des paramètres
- Deux événements gèrent les paramètres de notification des joueurs : Agency:Notify:LoadSettings (client) applique les préférences UI sauvegardées, tandis que Agency:Notify:SaveSettings (serveur) valide et persiste les paramètres tels que la position, la couleur, l'échelle et le style. La persistance nécessite oxmysql et doit être activée dans la configuration.
?Questions fréquentes
Y a-t-il des exports côté serveur disponibles dans Agency-Notify ?
Non, Agency-Notify ne fournit que des exports côté client. Tout le déclenchement des notifications et la gestion des paramètres sont effectués côté client, avec des événements de persistance disponibles pour sauvegarder et charger les paramètres si oxmysql est activé.
Est-ce que oxmysql est requis pour que Agency-Notify fonctionne ?
oxmysql est optionnel. Il est uniquement nécessaire si vous souhaitez activer la persistance en base de données pour les paramètres de notification des joueurs. Sans oxmysql, les notifications et les paramètres de l'interface fonctionnent normalement, mais les paramètres ne seront pas sauvegardés entre les sessions.
Comment déclencher une notification depuis une autre ressource ?
Vous pouvez utiliser l'export client Notify pour afficher une notification. Passez un objet data avec les champs souhaités (title, text, type, duration, etc.). Alternativement, utilisez l'événement client Agency:Notify:Send pour la compatibilité legacy avec la même structure de données.
Que dois-je vérifier si les notifications n'apparaissent pas ?
Assurez-vous que Agency-Notify est correctement démarré en utilisant ensure Agency-Notify dans votre server.cfg. Vérifiez que vous appelez l'export client ou l'événement avec la bonne charge utile. Si vous utilisez la persistance, vérifiez que oxmysql est installé et activé dans la configuration.