Compatibilité

Astral Overlay accepte les messages de notification de style XSOverlay par WebSocket et UDP historique. Il s’agit d’une compatibilité des notifications, pas d’une implémentation de l’API XSOverlay complète.

Points d’entrée pris en charge

WebSocket sur le port local 42070, avec un paramètre de requête client obligatoire.
Commande SendNotification et jsonData contenant une chaîne.
Contenus UDP historiques sur le port local 42069.
Champs communs de texte, source, délai, opacité et volume des notifications.

Limites

Les autres commandes WebSocket sont ignorées sans avertissement. Ne dépendez pas des commandes de fenêtre, thème ou statut.
Les notifications partagent une seule file limitée, quelle que soit la valeur d’index.
Les dimensions des cartes suivent le contenu plutôt que la hauteur demandée par l’émetteur.
La boucle de réception WebSocket actuelle traite les trames texte et de fermeture ; elle ne fournit pas un service WebSocket généraliste. Vérifiez le maintien de connexion du protocole et la prise en charge des messages fragmentés avec votre client avant une utilisation prolongée.
Le parseur accepte audioPath, icon et useBase64Icon, mais le moteur d’affichage actuel ne charge pas les fichiers d’icônes ou de sons personnalisés. Il utilise sa propre présentation et le son fourni. Le volume par message est lu ; la lecture actuelle utilise le volume global des notifications.

Utilisation avec XSOverlay

Les deux applications utilisent les mêmes ports de notification par défaut. Si une autre application occupe déjà un port, Astral Overlay journalise un avertissement et ne peut pas y écouter. L’autre transport peut rester disponible si son propre port est libre. Aucun transfert automatique n’existe entre les deux applications.

Testez les intégrations avec la version d’Astral Overlay que vous comptez prendre en charge.