Diese Dokumentation beschreibt immer die neueste Version des Moduls, aktuell 2.0 im Kanal Beta. Im Kanal Stable liegt noch die Version 1.3.1. Dort können Funktionen fehlen, die hier beschrieben sind.
Mit dieser Bibliothek lassen sich Android-Tablets, auf denen die App Fully Kiosk Browser läuft, aus IP-Symcon überwachen und fernsteuern.
Inhaltsverzeichnis
1. Voraussetzungen
- mindestens IPS Version 9.0
- Fully Kiosk Browser mit PLUS-Lizenz auf dem Tablet
- In Fully Kiosk Browser aktivierter Remote Admin (Zugriff aus dem lokalen Netz) mit gesetztem Passwort
- Optional für den Empfang von Status und Ereignissen per MQTT: die MQTT-Integration in Fully Kiosk Browser (PLUS, Android 7 oder neuer) und ein MQTT-Server oder MQTT-Client in IP-Symcon
2. Funktionsumfang
- Anzeige des Gerätezustands in Variablen (Akku, Netzwerk, Speicher, Standort, Version, Bildschirm- und Kioskstatus und weitere)
- Steuerung von Bildschirm, Helligkeit, Bildschirmschoner, Kiosk- und Wartungsmodus
- Laden von Webseiten, Tabs und JavaScript im Fully Kiosk Browser
- Starten von Apps auf dem Tablet
- Sprachausgabe, Töne und Videos auf dem Tablet
- Screenshot und Kamerabild als Medienobjekt
- Lesen und Ändern der Einstellungen von Fully Kiosk Browser
- Optional: Status und Ereignisse kommen per MQTT vom Tablet, statt dass IP-Symcon es abfragt
Die einzelnen Funktionen stehen bei den Instanzen unter “Enthaltene Module” und in der README des jeweiligen Moduls.
3. Enthaltene Module
- FKBDevice
- Steuert und überwacht ein Tablet mit Fully Kiosk Browser.
- Fragt das Tablet über die REST-Schnittstelle ab oder nimmt Status und Ereignisse per MQTT entgegen.
- Die Variablen lassen sich einzeln aktivieren, die Befehle stehen als Funktionen für Skripte bereit.
4. Installation
Die Installation erfolgt über den IP-Symcon Module Store.
5. Konfiguration in IP-Symcon
Die Geräteinstanz für das FKB Device muss per Hand im Objektbaum erzeugt werden. Dort werden Host, Port und Passwort des Tablets eingetragen. Mit dem Button “Verbindung testen” lässt sich die Verbindung prüfen.
Für MQTT wird in der Instanz ein MQTT-Server oder MQTT-Client als übergeordnete Instanz ausgewählt. Ohne übergeordnete Instanz zeigt IP-Symcon den Hinweis, dass die Instanz eine übergeordnete Instanz benötigt. Die Instanz arbeitet dann trotzdem über die REST-Schnittstelle.
Die weitere Dokumentation bitte den einzelnen Modulen entnehmen.
6. Spenden
Dieses Modul ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:
7. Lizenz
Changelog
Alle Versionen dieses Moduls, die neueste oben.
Version 2.0
- Neu: Optionaler MQTT-Parent (MQTT-Server oder -Client): Das Tablet meldet Status und Ereignisse selbst, die Abfrage per REST dient dann nur noch als Rückfallebene.
- Neu: Neue Variablen "Letztes Ereignis", "Daten des letzten Ereignisses" und "Zeit des letzten Ereignisses" (aus den Fully-Ereignissen per MQTT, die Daten enthalten zum Beispiel die neue URL).
- Neu: Neue Variablen für Lautstärke (Musik bedienbar), Datenzähler, letzte Benutzereingabe, Standortgenauigkeit, Hotspot, Anzeigestatus und weitere Werte des Tablets.
- Neu: Die Bildschirmhelligkeit lässt sich jetzt über einen Schieberegler einstellen.
- Neu: Neue Funktionen: FKBforceSleep, FKBtriggerMotion, FKBrestartApp, FKBexitApp, FKBinjectJavascript, FKBrefreshTab, FKBfocusTab, FKBcloseTab, FKBclearCache, FKBclearWebstorage, FKBclearCookies, FKBresetWebview, FKBstopTextToSpeech, FKBstopVideo, FKBlistSettings, FKBgetScreenshot, FKBgetCamshot, FKBtestConnection.
- Neu: Neue Funktion FKBtextToSpeechEx: Text sprechen mit Sprache und Warteschlange.
- Neu: Optional HTTPS für die Verbindung zum Tablet.
- Neu: Button "Verbindung testen" im Konfigurationsformular.
- Neu: Variablen nutzen die neuen Darstellungen von Symcon 9. Achtung: Die bisherigen Profile FKB. werden nicht mehr verwendet und können nach dem Update gelöscht werden.
- Fix: Das Passwort erscheint nicht mehr im Debug-Fenster.
- Fix: Ist das Tablet nicht erreichbar, blockiert Symcon nicht mehr bis zu einer Minute. Die Instanz zeigt dann einen Fehlerstatus.
- Fix: Ist das Tablet ausgeschaltet, meldet die Konsole nicht mehr "ungültiger Statuscode 201", sondern "Tablet nicht erreichbar".
- Fix: Die Variable "In den Hintergrund" wird jetzt angelegt.
- Fix: Der Standortanbieter wird jetzt angezeigt (die Variable war bisher immer leer).
- Fix: URLs, Texte und Schalter (zum Beispiel bei playSound, playVideo und loadApkFile) werden korrekt übergeben.
- Fix: Mehrere Tablets teilen sich nicht mehr die Auswahl der Apps. (Profil wurde immer überschrieben)
- Fix: Unbekannte Werte vom Tablet erzeugen keine Warnungen mehr im Meldungsfenster.
- Fix: Funktionen melden jetzt zuverlässig Erfolg oder Fehler zurück.
- Achtung: Ohne MQTT-Parent zeigt die Instanz den Hinweis "benötigt eine übergeordnete Instanz". Die Instanz funktioniert trotzdem per REST.
Version 1.3.1
- Neu: Weiteres Debug eingebaut
Version 1.3
- Neu: loadURL
- Neu: loadStartURL
Version 1.2
- Neu: Variablen können aktiviert und deaktiviert werden.
- Neu: BSSID
- Neu: scopedStorage
Version 1.1.3
- Fix: Object with ident sensorInfo could not be found in
Version 1.1.2
- Neu: packageName hinzugefügt
Version 1.1.1
- Fix: Keine Fehler mehr durch sensorInfo
Version 1.1
- Neu: Variable externalStorageFreeSpace
- Neu: Variable externalStorageTotalSpace
- Fix: Wenn das Gerät offline ist, dann gibt es keine Fehler mehr
Version 1.0.2
- Fix: Variable Ident mqttConnected
Version 1.0.1
- Neu: Variable mqttConnected hinzugefügt
Version 1.0
- Neu: Erste Version.