Dokumentation

Schnelleinstieg

Das folgende Kapitel zeigt anhand eines einfachen Beispiels das Funktionsprinzip von IP-Symcon.
Eine angeschlossene Hardware ist hierfür nicht notwendig, jedoch eine gültige Lizenz, eine Internetverbindung sowie eine erfolgreich abgeschlossene Installation. Diese erkennen Sie an dem neuen "IPS" Icon in der Trayleiste:

 

Sollte dies nicht der Fall sein, so können Sie das Programm "ips_tray.exe" im IP-Symcon Verzeichnis oder von der Desktop-Verknüpfung starten. Beantworten Sie die Frage, ob der Dienst gestartet werden soll, mit "JA".
Das Programm IP-Symcon besteht aus zwei Teilen: dem Dienst, der sich nicht sichtbar im Hintergrund sich um alles "kümmert" und der Konsole, die alles anzeigt und Befehle entgegen nimmt (GUI).
Einen gestarteten Dienst erkennen Sie an einem blauen Icon andernfalls ist es grau.
Die Konsole kann mit einen Doppelklick geöffnet werden.
Alternativ erhalten Sie mit der rechten Maustaste folgende Auswahlmöglichkeiten:

 

Auf einer neu geöffneten Konsole wird als erstes die "Willkommen" Seite angezeigt:

http://terraset.de/fileadmin/user_upload/images/documentation/konsole_teilansicht.png

Die meistverwendete Ansicht in IP-Symcon ist der Objektbaum. Zu ihm gelangen Sie mit einem Klick auf "Ansicht hinzufügen" und anschließend auf "Objektbaum" klicken.

Im folgenden Bild sehen Sie die für dieses Beispiel benötigten Objekte. Ein Skript und eine Instanz.

Wie Sie neue Instanzen (Geräte) und Skripte hinzufügen erfahren Sie hier

Wichtig ist, dass Sie in der MediaPlayer Instanz Ihre Soundkarte auswählen und die Eigenschaftenseite mit "OK" bestätigen.

Das erste Skript

Es soll einen Sound über die neu anzulegende "Media Player" Instanz abspielen.
Diese Instanz ist der Vermittler zwischen Hardware, also der Soundkarte und der Software, also den Skripten.

Öffnen Sie das Script mit dem Namen "Play Sound" und
geben Sie anschließend folgenden PHP-Code ein:

$id_sound = 12345;
WAC_SetVolume($id_sound, 50);
WAC_PlayFile($id_sound, "C:\\Windows\\Media\\tada.wav");

Alle Beispiele in der Dokumentation oder im Forum müssen noch angepasst werden.
Dies gilt immer für die darin verwendete ID (hier: $id_sound)
Die betreffende Instanz können Sie mit der Tastenkombination: Strg+O auswählen.

Starten Sie nun das Skript, indem Sie auf "Ausführen" klicken: "Tadaaaa" ertönt nun aus Ihren Lautsprecherboxen.

Die benutzen Befehle sind für die verschiedenen Instanzen unterschiedlich. Sie können eine Auflistung der Befehle in der Modulreferenz und der Befehlsreferenz nachsehen.