SIP

Mit dem Skill SIP nimmt die nomos App Anrufe einer Türsprechanlage entgegen. Sie legen auf dem nomos system Controller eine SIP-Verbindung an: das SIP-Konto, unter dem die App sich anmeldet, den Server, an dem sie es tut, und auf Wunsch einen Türöffner. Jede App, der die Verbindung zugeordnet ist, meldet sich mit diesem Konto am SIP-Server an. Klingelt jemand an der Sprechstelle, klingelt die App; der Bewohner nimmt an, spricht mit dem Besucher, sieht ihn, wenn die Sprechstelle Video sendet, und öffnet mit Öffnen die Tür.

Die App verbindet sich dabei selbst mit dem SIP-Server, nicht über den Controller. Der Controller speichert nur die Verbindungen und verteilt sie an die Apps.

WARNING

Bevor Sie beginnen: Sie brauchen einen SIP-Server, der SIP über WebSocket anbietet (Adresse in der Form wss://…), und darauf ein Konto für die App. Die Sprechstelle muss dieses Konto anrufen. Die App spricht SIP ausschließlich über WebSocket; ein Server, der nur SIP über UDP oder TCP anbietet, lässt sich nicht direkt verwenden.

Die App nimmt Anrufe nur entgegen; selbst anrufen kann sie nicht.

SIP-Verbindung anlegen

1. Schalten Sie unter Skills den Skill SIP mit EIN ein.
2. Klicken Sie auf Hinzufügen. Es öffnet sich Neue SIP-Verbindung.
3. Füllen Sie die Felder aus:
   • Name — wie die Verbindung in der Liste und in der App heißt, etwa „Haustür“.
   • AOR — die SIP-Adresse (Address of Record) des Kontos, unter dem sich die App anmeldet, in der Form benutzername@domain. Das vorangestellte sip: dürfen Sie weglassen; die App ergänzt es.
   • Server — die WebSocket-Adresse des SIP-Servers, etwa wss://sip.example.com:8089/ws. Das Feld ist bei einer neuen Verbindung mit einer Adresse auf dem Controller vorbelegt (wss://<Adresse des Controllers>:8089/ws); ersetzen Sie sie durch die Adresse Ihres SIP-Servers.
   • Benutzerzuordnung — Alle oder ein einzelner Benutzer. Die Verbindung erscheint nur in den Apps, die mit diesem Benutzer angemeldet sind; bei Alle in jeder App.
   • Öffner — die Komponente, die die Tür öffnet (siehe Türöffner). Das Feld erscheint nur, wenn es eine solche Komponente gibt.
   • Aktiviert — nur aktivierte Verbindungen meldet die App am Server an. Schalten Sie das Häkchen aus, um eine Verbindung vorübergehend stillzulegen, ohne sie zu löschen.
4. Tragen Sie unter Erweitert die Zugangsdaten des SIP-Kontos ein (siehe Erweiterte Optionen).
5. Klicken Sie auf Speichern.

Name, AOR und Server sind Pflichtfelder.

Die Liste zeigt jede Verbindung mit Name und Zuletzt geändert. Mit dem Stift bearbeiten Sie eine Verbindung (SIP-Verbindung bearbeiten), mit dem × löschen Sie sie nach einer Rückfrage. Gibt es noch keine Verbindung, steht dort „Noch keine SIP-Verbindung angelegt.“

Änderungen übernehmen die Apps sofort: Sie laden die Verbindungen neu und melden sich erneut am Server an.

Erweiterte Optionen

Unter Erweitert stehen Optionen, die die App unverändert an ihre SIP-Bibliothek (SIP.js) weitergibt. Weitere Optionen fügen Sie über die Auswahl Hinzufügen... hinzu, entfernen sie mit dem × daneben. Der Link Beschreibung der erweiterten Optionen. führt zur Beschreibung aller Optionen bei SIP.js. Die Namen der Optionen erscheinen in allen Sprachen englisch, bis auf Benutzername und Kennwort.

Eine neue Verbindung bringt diese Optionen mit:

• Benutzername und Kennwort — die Zugangsdaten, mit denen sich die App am SIP-Server anmeldet. Vorbelegt sind die Platzhalter „User1“ und „1234“; ersetzen Sie sie durch die Daten des SIP-Kontos.
• Log Builtin Enabled, Log Configuration und Log Level — steuern nur das interne Protokoll der App. Lassen Sie sie auf den Vorgaben.
• Graceful Shutdown — beendet beim Trennen offene Gespräche und die Anmeldung ordentlich, statt sie abzubrechen. Lassen Sie die Option eingeschaltet.

Häufig nützlich sind außerdem:

• Display Name — der Name, den die App gegenüber der Gegenstelle angibt.
• No Answer Timeout — nach wie vielen Sekunden ein nicht angenommener Anruf abgewiesen wird. Ohne Angabe sind es 60 Sekunden.
• Authorization Ha1 — statt des Kennworts dessen HA1-Hash, sofern Ihr SIP-Server das unterstützt.

Türöffner

Als Öffner stehen alle Komponenten zur Auswahl, die eine Tür öffnen können, etwa eine Türstation, die Sie als Add-on aus der Online-Bibliothek eingebunden haben (z. B. DoorBird). Gibt es keine solche Komponente, fehlt das Feld.

Ist ein Öffner gewählt, zeigt die App während des Gesprächs die Taste Öffnen. Sie löst an der gewählten Komponente das Öffnen aus, über deren eigene Anbindung, nicht über die SIP-Verbindung. Ohne Öffner fehlt die Taste.

In der App

Ist eine Verbindung aktiviert und dem Benutzer zugeordnet, meldet sich die App beim Start am SIP-Server an. Auf Android fragt sie dafür nach dem Zugriff auf Kamera und Mikrofon.

• Bei einem Anruf zeigt die App den Namen des Anrufers mit Ablehnen und Annehmen.
• Während des Gesprächs: Stumm, Auflegen und, mit Öffner, Öffnen. Sendet die Sprechstelle Video, zeigt die App das Bild.
• Diesen Anrufer automatisch annehmen — die App nimmt Anrufe dieser Gegenstelle künftig selbst an, mit stummgeschaltetem Mikrofon.
• Die App führt immer nur ein Gespräch. Ein zweiter Anruf, während das erste läuft, wird nicht angezeigt.

Unter Einstellungen → SIP wählt der Bewohner je Verbindung den Klingelton und eine Zeitspanne Bitte nicht stören, in der die App nicht klingelt; dort entfernt er auch Anrufer, die automatisch angenommen werden. Diese Einstellungen gelten nur für das jeweilige Gerät. Ist in der App ein Zugangscode gesetzt, ist der Eintrag SIP nur über diesen Code erreichbar.

Fehlersuche

• Wird die Verbindung angenommen? In der App unter Einstellungen → SIP steht bei jeder Verbindung Verbunden oder Nicht verbunden, darunter bei einem Problem Fehler: mit der letzten Fehlermeldung.
• Die Verbindung erscheint nicht in der App: Prüfen Sie Aktiviert und die Benutzerzuordnung. Die App zeigt nur Verbindungen, die Alle oder dem Benutzer zugeordnet sind, mit dem sie angemeldet ist.
• Nicht verbunden: Prüfen Sie Server — die Adresse muss mit wss:// (oder ws://) beginnen und vom Gerät aus erreichbar sein, auf dem die App läuft. Da die App sich direkt mit dem Server verbindet, gilt das auch unterwegs: Ist der SIP-Server nur im Heimnetz erreichbar, klingelt die App unterwegs nicht. Verwendet der Server für wss:// ein Zertifikat, dem das Gerät nicht vertraut (etwa ein selbst signiertes), lehnt das Gerät die Verbindung in der Regel ab.
• Verbunden, aber es klingelt nicht: Prüfen Sie AOR, Benutzername und Kennwort und ob die Sprechstelle genau dieses Konto anruft. Prüfen Sie in der App, ob gerade Bitte nicht stören gilt.
• Nur ein Gerät klingelt: Alle Apps einer Verbindung melden sich mit demselben Konto an. Ob dann alle klingeln, entscheidet der SIP-Server; er muss mehrere gleichzeitige Anmeldungen pro Konto zulassen.
• Die Taste Öffnen fehlt: Wählen Sie bei der Verbindung einen Öffner. Fehlt das Feld Öffner, gibt es noch keine Komponente, die eine Tür öffnen kann.