Darstellung
Änderungen und Kompatibilität
Änderungen seit Version 2.8, die bestehende Integrationen betreffen
Diese Seite sammelt die Änderungen seit Version 2.8, die eine bestehende Integration betreffen können: entfernte Aufrufe, geänderte Formate und neue Anforderungen. Neue Aufrufe stehen in den Versionshinweisen und in der API-Referenz.
Welche Version ein Controller hat, liefert softwareUpdateCheck im Feld versionInstalled. getVersion nennt dagegen die Versionen der einzelnen Bausteine (api, ncd, engine), nicht die des Controllers.
3.4.0
- Unbekannte Ja/Nein-Werte: Hat ein Gerät einen Ja/Nein-Wert noch nicht gemeldet, ist
valuejetztnullstattfalse. Das betrifft etwagetComponentDataund die Komponentenlisten. Prüfen Sie auffalsenur, wenn der Wert wirklich gemeldet sein muss.
3.2.0
- Events erst nach der Anmeldung: Eine Socket.io-Verbindung bekommt Events erst, wenn sie angemeldet ist. Davor erreicht sie nur
stateChangefürapp,bus,engineundsystem. - Abmelden:
logouttrennt die Verbindung, über die es kam, und jede andere Verbindung derselben Sitzung. - Geänderte Benutzer: Wird ein Benutzer gelöscht oder deaktiviert oder bekommt er ein neues Kennwort oder eine andere Gruppe, beendet der Controller seine Sitzungen und trennt seine Verbindungen, auch solche, die sich mit
authohne Sitzung angemeldet haben. Ihr Programm muss mit einer Trennung durch den Controller rechnen und sich neu verbinden. Siehe Sitzungen. - Kamerastreams über
/janus: Der Controller prüft jede Nachricht, statt sie an Janus durchzureichen. Weiter gehen nur die Anfragen, die eine Kameraansicht braucht: Sitzung und Streaming-Plugin sowiewatch,switch,start,pauseundstop.watchundswitchgelten nur für Streams von Kameras, die der Benutzer sehen darf; ein Admin darf jeden Stream ansehen. Andere Anfragen, etwa zum Anlegen oder Ändern von Mountpoints, beantwortet der Controller mit einem Janus-Fehler, auch für Admins. Ein ungültiges oder schon benutztes Token weist er mit HTTP 403 ab. - Benutzer ohne Admin-Rechte bekommen keine Zugangsdaten mehr:
getCameras, auch übergetEverything, liefert inurlnur Protokoll, Host und Port, ohne Anmeldedaten, Pfad und Parameter.getJanusConfigurationliefert keinapisecret; auf der Verbindung/janussetzt der Controller es selbst ein.getJanusOneTimeTokenantwortet mit Fehlercode 117, wenn der Benutzer keine Kamera sehen darf.getCloudStatusliefert nur den Verbindungsstatus (status,connected,connecting,enabled,registered,syncEnabled), nicht das verknüpfte Konto.getProfileMetaliefert nurenabledundstatus.getMQTTStatusliefert die Adresse des Brokers ohne Zugangsdaten.- Die Komponentenlisten enthalten bei Add-ons kein
configOverrides. getSIPClientsliefert nur die eigenen SIP-Clients und die für alle Benutzer. Das EventonSIPClientAddedenthält keinuserAgentOptions.
3.1.0
- Kennwort für Administratoren: Ein Administratorkonto braucht ein Kennwort mit mindestens 6 Zeichen. Wer eines mit kürzerem oder leerem Kennwort anlegt oder ändert, bekommt Fehlercode 106 („Administratorkonten benötigen ein Kennwort mit mindestens 6 Zeichen“; der Text folgt der Sprache der Verbindung). Bestehende Konten bleiben, wie sie sind.
- Software-Updates:
softwareUpdateCheck,getAutoSoftwareUpdateInfo,enableAutoSoftwareUpdateundinstallSoftwareUpdatesunterscheiden zwischen Sicherheits- und Funktionsupdates. Neu istpostponeSoftwareUpdate. - Node-RED: Version 5.0.7.
3.0.0
- Entfernt:
getUserAuth,enableUserAuthunddisableUserAuth. - Geändertes Format:
getSystemSerialPortsliefert Objekte mit Gerätepfad und Beschreibung der angeschlossenen Hardware statt einer Liste von Gerätepfaden. - MQTT: Der Controller verwendet nur noch seinen eigenen Broker; ein externer Broker lässt sich nicht mehr einstellen. Controller und Engine melden sich mit eigenen, automatisch verwalteten Konten an, sodass ein Umbenennen des MQTT-Benutzers ihre Verbindung nicht mehr trennt. Siehe MQTT.
- Kameras: Liste und Stream einer Kamera richten sich nach den Raumrechten des Benutzers.
- Kamera- und Coverbilder: Die Weiterleitung der Bilder verlangt eine Anmeldung. Wer keine Sitzung mitschicken kann, holt mit
getForwarderTokenein kurzlebiges Token für genau ein Bild. - Benutzer: Der Anzeigename ist auf 64 Zeichen begrenzt. Mit
setCurrentUserändert ein angemeldeter Benutzer seinen eigenen Anzeigenamen ohne Administratorrechte.
2.8.7
- Systemvariablen: Der Parameter
defaultValueentfällt beiaddSystemVariableundsetSystemVariable, in den Antworten vongetSystemVariableundgetSystemVariablesund im EventonSystemVariableAdded.
2.8.5
- MQTT: Beim Einschalten des Skills erzeugt der Controller Zugangsdaten, wenn noch keine gesetzt sind. Clients, die sich bisher ohne Anmeldung verbunden haben, brauchen danach Benutzername und Kennwort.
2.8.4
- MQTT: Sind Zugangsdaten gesetzt, sichert der Controller den eigenen Broker damit ab und weist Clients ohne Anmeldung ab. Die Sicherheitsprüfung warnt, wenn keine gesetzt sind.
- mRemote: Der Port 5500 für die mRemote-Oberfläche ist geschlossen.
2.8.2
- Socket.io v4: Aktuelle Clients verbinden sich mit Socket.io v4 über den Pfad
/socket.io-v4. Der Pfad/socket.iofür Socket.io v2 bleibt erhalten. Siehe Verbinden und Anmelden. - Dateien hochladen: Die Aufrufe
importKNXProject,importLutronProject,importAddonProfile,importBackup,importRoomImage,importFloorImage,importKeyfile,importLogoundimportUpdatenehmen Dateien direkt entgegen, als Alternative zur Bibliothek SocketIOFileUpload. - MCP: Der Controller bietet einen MCP-Server an (Beta). Siehe MCP.
- Entfernt:
setTimerPosition,setNotificationPositionund die Aufrufe für tado°. - KNX-Projekte:
downloadKNXProject,removeKNXProject,getKNXMainGroups,getKNXMiddleGroups,getKNXTopologyundgetKNXGroupAddressesnehmen den Projektnamen als Parameter und antworten mit Fehlercode 112, wenn es das Projekt nicht gibt. - Node-RED: node-red-contrib-nomos ab Version 1.5.3 braucht einen Controller ab Version 2.8.2. Siehe Node-RED.
2.8.1
- Raum- und Szenenrechte: Rechte lassen sich je Benutzer und Gruppe auf Räume und Szenen einschränken, mit den Aufrufen
getUserRoomPermission,setUserRoomPermission,getUserScenePermission,setUserScenePermissionund ihren Gegenstücken für Gruppen. Ein eingeschränkter Benutzer liest und schaltet über die API nur, was diese Rechte erlauben.
2.8.0
- Hardware: Controller mit ARM-v7-Prozessor werden nicht mehr unterstützt.