SIP

Met de skill SIP neemt de nomos app oproepen van een deurintercom aan. Op de nomos system Controller maakt u een SIP-verbinding aan: het SIP-account waarmee de app zich aanmeldt, de server waarbij ze dat doet en, desgewenst, een deuropener. Elke app waaraan de verbinding is toegewezen, meldt zich met dit account aan bij de SIP-server. Belt er iemand aan bij de intercompost, dan gaat de app over; de bewoner neemt op, spreekt met de bezoeker, ziet hem als de intercompost video verstuurt, en opent de deur met Openen.

De app maakt daarbij zelf verbinding met de SIP-server, niet via de controller. De controller slaat alleen de verbindingen op en verdeelt ze over de apps.

WARNING

Voordat u begint: u hebt een SIP-server nodig die SIP via WebSocket aanbiedt (adres in de vorm wss://…), met daarop een account voor de app. De intercompost moet dit account bellen. De app spreekt SIP uitsluitend via WebSocket; een server die SIP alleen via UDP of TCP aanbiedt, kan niet rechtstreeks worden gebruikt.

De app neemt alleen oproepen aan; zelf bellen kan ze niet.

SIP-verbinding aanmaken

1. Schakel onder Skills de skill SIP in met AAN.
2. Klik op Toevoegen. Nieuwe SIP-verbinding wordt geopend.
3. Vul de velden in:
   • Naam — hoe de verbinding in de lijst en in de app heet, bijvoorbeeld „Voordeur”.
   • AOR — het SIP-adres (address of record) van het account waarmee de app zich aanmeldt, in de vorm gebruikersnaam@domein. Het voorvoegsel sip: mag u weglaten; de app vult het aan.
   • Server — het WebSocket-adres van de SIP-server, bijvoorbeeld wss://sip.example.com:8089/ws. Bij een nieuwe verbinding is het veld vooraf ingevuld met een adres op de controller (wss://<adres van de controller>:8089/ws); vervang het door het adres van uw SIP-server.
   • Gebruikerstoewijzing — Iedereen of één gebruiker. De verbinding verschijnt alleen in de apps die met deze gebruiker zijn aangemeld; bij Iedereen in elke app.
   • Opener — de component die de deur opent (zie Deuropener). Het veld verschijnt alleen als er zo'n component bestaat.
   • Geactiveerd — de app meldt alleen geactiveerde verbindingen aan bij de server. Haal het vinkje weg om een verbinding tijdelijk buiten gebruik te stellen zonder haar te verwijderen.
4. Vul onder Geavanceerd de aanmeldgegevens van het SIP-account in (zie Geavanceerde opties).
5. Klik op Opslaan.

Naam, AOR en Server zijn verplicht.

De lijst toont elke verbinding met Naam en Laatste update. Met het potlood bewerkt u een verbinding (SIP-verbinding bewerken), met het × verwijdert u haar na een bevestiging. Zolang er geen verbinding is, staat er „Nog geen SIP-verbinding ingesteld.”

Wijzigingen nemen de apps meteen over: ze laden de verbindingen opnieuw en melden zich opnieuw aan bij de server.

Geavanceerde opties

Onder Geavanceerd staan opties die de app ongewijzigd doorgeeft aan haar SIP-bibliotheek (SIP.js). Verdere opties voegt u toe via de keuzelijst Toevoegen... en verwijdert u met het × ernaast. De link Beschrijving van de geavanceerde opties. leidt naar de beschrijving van alle opties bij SIP.js. De namen van de opties verschijnen in alle talen in het Engels, behalve Gebruikersnaam en Wachtwoord.

Een nieuwe verbinding heeft deze opties:

• Gebruikersnaam en Wachtwoord — de aanmeldgegevens waarmee de app zich aanmeldt bij de SIP-server. Vooraf ingevuld zijn de plaatshouders „User1” en „1234”; vervang ze door de gegevens van het SIP-account.
• Log Builtin Enabled, Log Configuration en Log Level — regelen alleen het interne logboek van de app. Laat ze op de standaardwaarden staan.
• Graceful Shutdown — beëindigt bij het verbreken van de verbinding lopende gesprekken en de aanmelding netjes in plaats van ze af te breken. Laat deze optie ingeschakeld.

Vaak nuttig zijn bovendien:

• Display Name — de naam die de app aan de andere partij doorgeeft.
• No Answer Timeout — na hoeveel seconden een niet-beantwoorde oproep wordt geweigerd. Zonder waarde is dat 60 seconden.
• Authorization Ha1 — in plaats van het wachtwoord de HA1-hash ervan, als uw SIP-server dat ondersteunt.

Deuropener

Bij Opener staan alle componenten die een deur kunnen openen, bijvoorbeeld een deurstation dat u als add-on uit de online bibliotheek hebt toegevoegd (bijv. DoorBird). Is er geen zo'n component, dan ontbreekt het veld.

Is er een opener gekozen, dan toont de app tijdens het gesprek de knop Openen. Die activeert het openen bij de gekozen component, via de eigen koppeling van die component, niet via de SIP-verbinding. Zonder opener ontbreekt de knop.

In de app

Is een verbinding geactiveerd en aan de gebruiker toegewezen, dan meldt de app zich bij het starten aan bij de SIP-server. Op Android vraagt ze daarvoor toegang tot camera en microfoon.

• Bij een oproep toont de app de naam van de beller met Weigeren en Beantwoorden.
• Tijdens het gesprek: Dempen, Ophangen en, met een opener, Openen. Verstuurt de intercompost video, dan toont de app het beeld.
• Deze beller automatisch beantwoorden — de app neemt oproepen van deze beller voortaan zelf aan, met gedempte microfoon.
• De app voert altijd maar één gesprek. Een tweede oproep tijdens een lopend gesprek wordt niet getoond.

Onder Instellingen → SIP kiest de bewoner per verbinding de Beltoon en een periode Niet storen waarin de app niet overgaat; daar verwijdert hij ook bellers die automatisch worden beantwoord. Deze instellingen gelden alleen voor het betreffende apparaat. Is in de app een Toegangscode ingesteld, dan is de vermelding SIP alleen met deze code bereikbaar.

Probleemoplossing

• Wordt de verbinding geaccepteerd? In de app onder Instellingen → SIP staat bij elke verbinding Verbonden of Niet verbonden, en daaronder bij een probleem Fout: met de laatste foutmelding.
• De verbinding verschijnt niet in de app: controleer Geactiveerd en de Gebruikerstoewijzing. De app toont alleen verbindingen die aan Iedereen zijn toegewezen of aan de gebruiker waarmee ze is aangemeld.
• Niet verbonden: controleer Server — het adres moet met wss:// (of ws://) beginnen en bereikbaar zijn vanaf het apparaat waarop de app draait. Omdat de app rechtstreeks verbinding maakt met de server, geldt dat ook onderweg: is de SIP-server alleen in het thuisnetwerk bereikbaar, dan gaat de app onderweg niet over. Gebruikt de server voor wss:// een certificaat dat het apparaat niet vertrouwt (bijvoorbeeld een zelfondertekend certificaat), dan weigert het apparaat de verbinding doorgaans.
• Verbonden, maar er gaat niets over: controleer AOR, Gebruikersnaam en Wachtwoord, en of de intercompost precies dit account belt. Controleer in de app of Niet storen op dit moment actief is.
• Slechts één apparaat gaat over: alle apps van een verbinding melden zich met hetzelfde account aan. Of ze allemaal overgaan, bepaalt de SIP-server; hij moet meerdere gelijktijdige aanmeldingen per account toestaan.
• De knop Openen ontbreekt: kies bij de verbinding een Opener. Ontbreekt het veld Opener, dan is er nog geen component die een deur kan openen.