Pushbenachrichtigungen mit IPSv4.x

Als erstes müssen wir dem IP-Symcon Server ein wenig Basiswissen über die App beibringen 🙂

  • zur “Logischen Baumansicht” wechseln
  • zu “Kern Instanzen” navigieren
  • Modules öffnen
  • „hinzufügen“ klicken
  • das Modulerepository „git://github.com/Seb0815/ips4Windows“ hinzufügen
  • „übernehmen“ klicken
  • dann im Objektbaum unter „Kern Instanzen“ eine neue Instanz vom Typ „ips4WinDeviceRegistration“ hinzufügen

Nun können wir in der App in den Einstellungen in den Reiter „Interaktionen“ wechseln.

settings5.PNG

Dort aktivieren wir jetzt IPS V4.x und die Pushbenachrichtigungen. Hat alles funktioniert, werden jetzt unter der Instanz „ips4WinDeviceRegistration“ die Geräte gelistet.

Es gibt drei Arten von Benachrichtigungen welche man nutzen kann.

  1. „Toastbenachrichtigungen“ – jedem bekannt von WhatsApp und Co. Man findet Sie im Benachrichtigungsfenster
  2. „Bagdebenachrichtigungen“ – jedem bekannt von der Mailkachel, man kann dort z.B. eine Zahl zwischen 0 und 99+ darstellen (z.B. Anzahl der offenen Fenster im Haus) oder spezifische Symbole (diese findet man in dieser Tabelle)
  3. „Tilebenachrichtigungen“ – das sind Einträge die direkt auf der Kachel dargestellt werden

Wie sende ich eine Benachrichtigungen?

Grundsätzlich kann man  Benachrichtigungen entweder an alle Geräte oder an ein Gerät versenden. Dazu ein Beispiel mit den Toastbenachrichtigungen welches man z.B. in einem Script nutzt:
  • Nachricht an alle Geräte: ips4WNS_sendToastNotification(0,null,“text1″,“text2″);
  • Nachricht an ein Gerät: ips4WNS_sendToastNotification(0,“Seb Windows Phone“,“text1″,“text2″); – „Seb Windows Phone“ (Gerätname) findet man in der Instanz „ips4WinDeviceRegistration“ unter „deviceName“

Toastbenachrichtigungen (Einfach):

  • ips4WNS_sendToastNotification(0,“Gerät“, „Text1″,“Text2“)
  • erster Parameter bleibt immer 0
  • zweiter Parameter entweder ’null‘ (ohne Hochkomma) für alle oder den jeweiligen Gerätenamen („deviceName“ unter der Instanz „ips4WinDeviceRegistration“)
  • dritter Parameter ist die Überschrift der Nachricht
  • vierter Parameter ist der eigentliche Text
Toastbenachrichtigungen (Erweitert):
  • ips4WNS_sendToastNotificationXML(0,null,“XML Text“) bietet die Möglichkeit, Toasts vollkommen anzupassen. Dabei gibt es kaum Einschränkungen, erfordert aber das man sich an die geforderte Syntax hält!
  • am einfachsten geht das mit der App Notifications Visualizer , diese erzeugt die notwendige XML Struktur und man kann das einfach in eine Script kopieren

Bagdebenachrichtigungen:

  • ips4WNS_sendBagdeNotification(0,“Gerät“, „10“)
  • erster Parameter bleibt immer 0
  • zweiter Parameter entweder ’null‘ (ohne Hochkomma) für alle oder den jeweiligen Gerätenamen („deviceName“ unter der Instanz „ips4WinDeviceRegistration“)
  • dritter Parameter ist die Zahl welche Dargestellt werden soll (0 – 99+) oder spezifisches Symbole (findet man in dieser Tabelle)
  • z.B. ips4WNS_sendBagdeNotification(0,null,“attention“)
  • zum löschen Benachrichtigung kann man ips4WNS_sendBagdeNotification(0,null,“none“) senden

 

Tilebenachrichtigungen (Einfach):

  • ips4WNS_sendTileNotification(0,“Gerät“,“text1″,“text2″,“text3″,“text4″);
  • erster Parameter bleibt immer 0
  • zweiter Parameter entweder ’null‘ (ohne Hochkomma) für alle oder den jeweiligen Gerätenamen („deviceName“ unter der Instanz „ips4WinDeviceRegistration“)
  • Parameter drei – sechs stellen einzelne Zeilen auf dem Tile da. Abhängig von der Größe des Tile werden aber nur einzelnen Zeilen dargestellt.
  • zum löschen Benachrichtigung kann man ips4WNS_sendBagdeNotification(0,null,“none“) senden
Tilebenachrichtigungen (Erweitert):
  • ips4WNS_sendTileNotificationXML(0,null,“XML Text“) bietet die Möglichkeit, Tiles vollkommen anzupassen. Dabei gibt es kaum Einschränkungen, erfordert aber das man sich an die geforderte Syntax hält!
  • am einfachsten geht das mit der App Notifications Visualizer , diese erzeugt die notwendige XML Struktur und man kann das einfach in eine Script kopieren
Bilden von Benachrichtigungsgruppen:
  • mit dem Funktionsaufruf „ips4WNS_SetWNSTileTag(0,“Nr1“) kann man Gruppen definieren, welche dann nacheinander auf dem Tile durchlaufen (weiterführende Erklärung findet man hier unter „X-WNS-Group“)
  • der erste Parameter bleibt wie immer 0
  • der zweite Parameter bildet den Gruppennamen
  • z.B.:
    • ips4WNS_SetWNSTileTag(0,“Nr1″);
    • ips4WNS_sendTileNotification(0,null,“text1″,“text2″,“text3″,“text4″);
    • ips4WNS_SetWNSTileTag(0,“Nr2″);
    • ips4WNS_sendTileNotification(0,null,“text1-2″,“text2-2″,“text3-2″,“text4-4″);
  • SetWNSTileTag kann sowohl für Toast- als auch für Tilebenachrichtigungen genutzt werden. Es lassen sich dadurch z.B. auch Nachrichten einer Gruppe wieder überschreiben wenn z.B. ein Ereignis nicht mehr vorhanden ist

 

Änderungshistorie:

  • 27.03.2016:
    • Funktion für erweiterte Tiledarstellung korrigiert (richtig muss es ips4WNS_sendTileNotificationXML sein, war fälschlicher weise ips4WNS_sendRawNotification )
    • Funktion für erweiterte Toastdarstellung ergänzt (erfordert Modul Update in IPS)

 

Hinterlasse einen Kommentar