Vorsicht

Dies ist die Dokumentation des aktuellen Entwicklungszweigs der CometVisu. Es besteht daher die Möglichkeit, dass einige der hier beschriebenen Features mit dem aktuellsten Release der CometVisu nicht genutzt werden können.

Widgets in der CometVisu

Widgets sind die einzelnen Elemente aus denen eine CometVisu-Site zusammengebaut wird. Diese können entweder fest in der CometVisu eingebaut sein oder per Plugin-Schnittstelle integriert werden. Die Widgets lassen sich durch den Editor hinzufügen. (Rechtsklick auf das Element, welches ein Widget aufnehmen soll z.B. eine Page oder eine Gruppe (group). Durch Auswahl des Widget aus dem Drop-Down Menü und anschließendem Klick auf das + - Zeichen ist das Widget eingefügt und kann wie folgt konfiguriert werden;

Bedienbare Widgets

Diese Widgets können in irgendeiner Weise bedient werden um so Daten an das Backend zu senden oder andere Aktionen auszulösen, z.B. kann man mit einem Switch durch anklicken einen Lampe schalten, oder mit einem Pagejump kann innerhalb der Visu navigiert werden.

Widget	Beschreibung
Audio	Mit diesem Widget kann in die Visu eine Audio-Datei eingebunden werden, die sich über eine Adresse abspielen lässt.
ColorChooser	Farb-Auswahl-Rad für RGB-Beleuchtung
Designtoggle	Fügt der Visu eine Schaltfläche hinzu, mit der das Design gewechselt werden kann.
ImageTrigger	Fügt der Visu ein klickbares Bild hinzu. Dies kann z.B. für Erinnerungen wie Geburtstage oder Müllabfuhr verwendet werden.
InfoAction	Ermöglicht die Kombination eines darstellenden und bedienbaren Widgets.
InfoTrigger	Fügt der Visu ein Element hinzu, dass zwei Schaltflächen und eine Wertanzeige für Rückmeldungen vom BUS enthält. Z.B. für Multimediasteuerungen.
Multitrigger	Fügt der Visu ein Widget mit 4 Schaltflächen hinzu. Damit kann z.B. die Betriebsart der Heizung umgestellt (Komfort -> Nacht -> Abwesend -> Frostschutz) oder ein Szenenabruf realisiert werden.
Pagejump	Mit dem Widget pagejump lassen sich Seiten der Visu zusätzlich verknüpfen. Von der Funktion ist das vergleichbar mit Hyperlinks.
PushButton	Fügt der Visu eine Schaltfläche hinzu, mit der beim Drücken und Loslassen jeweils ein definierter Wert an den BUS gesendet wird. Z.B. beim Drücken eine 1 und beim Loslassen eine 0. Damit ist es z.B. möglich einen Taster zu simulieren um ein Garagentor, Rollläden oder Raffstores zu öffnen und zu schließen.
Refresh	Mit dem Widget refresh lassen sich die angezeigten Daten der Visu neu abrufen.
Reload	Mit dem Widget reload wird die Visu Seite komplett neu geladen.
Slide	Fügt der Visu einen horizontalen Schieberegler hinzu. Mit diesem kann z.B. gedimmt oder eine Temperatur eingestellt werden.
Switch	Fügt der Visu eine Schaltfläche hinzu, mit der z.B. Schaltaktionen ausgelöst werden können. Der Switch wird typisch für EIN/AUS Aktionen benutzt, wie Licht, Steckdosen, etc.
Toggle	Das toggle Widget ist ähnlich wie der Switch, kann aber mehr als zwei Zustände annehmen - dies kann z.B. für die Umschaltung von Betriebsarten der Heizung genutzt werden. Bei jedem Druck nimmt der Toggle den nächsten möglichen Zustand an.
Trigger	Fügt der Visu eine Schaltfläche hinzu, mit der genau ein definierter Wert für einen kurzen, sowie optional ein definierter Wert für einen langen Tastendruck an den BUS gesendet werden kann, z.B. für das Abrufen und Abspeichern von Szenen oder dem Fahren von Rollos. (kurz = stopp, lang = fahren). Die Adresse für Kurz und Langzeit können unterschiedlich sein.
URL-Trigger	Das UrlTrigger Widget fügt der Visualisierung eine Schaltfläche hinzu, die im Hintergrund eine URL aufruft um dadurch Aktionen auszuführen, z.B. um ein IFTTT Rezept aufzurufen.
Badge	Das NotificationCenterBadge Widget zeigt die aktuelle Anzahl der Nachrichten in der Benachrichtigungszentrale an und öffnet diese, wenn es angeklickt wird.

Darstellende Widgets

Diese Widgets haben eine rein informative Funktion, eine Bedienung ist nicht möglich.

Widget	Beschreibung
Image	Fügt der Visu ein statisches Bild oder ein Kamerabild hinzu.
Info	Fügt der Visu ein dynamisches Feld hinzu, dass Werte vom BUS darstellen kann. Z.B. 14-Byte-Text oder Zählerstände.
Line	Fügt der Visu eine horizontale Linie hinzu, um die Visuseite in einzelne Bereiche zu unterteilen.
RGB	Mit dem RGB-Widget kann man eine Farbe in der Visu anzeigen.
Roundbar	Mit dem Widget roundbar wir ein oder mehrere Indikatoren für einen Wert angezeigt.
Text	Fügt der Visu ein statisches Textfeld hinzu.
Video	Fügt der Visu ein Video oder einen Livestream hinzu. Wird derzeit allerdings von den meisten Quellen noch nicht unterstützt.
Web	Fügt der Visu ein Fläche hinzu, in der externe Webseiten dargestellt werden können.
WG_Plugin_Info	Fügt der Visu ein dynamisches Feld hinzu mit dem Daten aus WireGate Plugins dargestellt werden können.

Sonstige Widgets

Widget	Beschreibung
Break	Fügt der Visu einen Zeilenumbruch hinzu.
Group	Mit group können Widgets in einem Rahmen als Gruppe zusammengefasst werden. Die Größe der Gruppe kann über „layout“ eingestellt werden.
Include	Ermöglicht es, die visu_config.xml in mehrere Dateien aufzuteilen und die Teile über include wieder zusammenzuführen.
Navbar	Mit dem Widget navbar kann der gesamten Visu ein Navigationsmenü hinzu gefügt werden. Das Menü lässt sich an einer Seite (oben, unten, link, rechts) darstellen. Die Navigation durch die Visu lässt sich damit strukturieren.
Page	Erstellt eine neue Visuseite und fügt der aktuellen Seite einen entsprechenden Link hinzu.

Widgets die per Plugin eingebunden werden können

Diese müssen im „meta“ Bereich der visu_config.xml eingebunden werden bevor sie genutzt werden können.

also z.B.:

<plugins>
  <plugin name="diagram"/>
  <plugin name="strftime"/>
</plugins>

Widget	Beschreibung
Clock	Plugin zum Darstellen der Uhrzeit von einer Adresse.
Diagram	RRD-basierte Diagramme
Diagram_Info	Informations-Anzeige, die beim Klick ein Diagramm öffnet
Gauge	Zeigerinstrument
Link	Fügt der Visu einen einfachen anklickbaren Link hinzu
openHAB	Verbesserte Integration mit dem openHAB Backend
OpenweatherMap	Wettervorhersage
PowerSpectrum	Darstellung des Strom-Spektrums
RSS	RSS
RSSlog	Interaktive Log-Meldungen basierend auf RSS-Technologie
Speech	Sprachausgabe (Text-to-speech)
Strftime	Darstellung der Uhrzeit in Textform
SVG	Demo Plugin zur Anzeige einer interaktiv animierten SVG Datei
Timeout	Wechselt nach gewisser Zeit der Inaktivität auf eine andere Seite
tr064	Router Informationen, wie Anruflisten der Fritz!Box, über TR-064.
UPNPController	UPNP-Controller

Hinweis

Das CalendarList-Plugin steht nicht mehr zur Verfügung, da es auf eine Schnittstelle des Google-Kalenders zugegriffen hat, die nicht mehr verfügbar ist.

weitere Plugins befinden sich in der Entwicklung.