SIP

Con la competenza SIP, l'app nomos risponde alle chiamate di un citofono. Sul nomos system Controller Lei crea una connessione SIP: l'account SIP con cui l'app si registra, il server presso cui lo fa e, se desidera, un apriporta. Ogni app a cui è assegnata la connessione si registra con questo account presso il server SIP. Quando qualcuno suona al posto esterno, l'app squilla; l'occupante risponde, parla con il visitatore, lo vede se il posto esterno invia video, e apre la porta con Apri.

L'app si collega da sé al server SIP, non tramite il controller. Il controller si limita a memorizzare le connessioni e a distribuirle alle app.

WARNING

Prima di iniziare: Le serve un server SIP che offra SIP tramite WebSocket (indirizzo nella forma wss://…), con un account per l'app. Il posto esterno deve chiamare questo account. L'app parla SIP esclusivamente tramite WebSocket; un server che offre SIP solo tramite UDP o TCP non può essere usato direttamente.

L'app si limita a rispondere alle chiamate; non può chiamare da sé.

Creare una connessione SIP

1. In Competenze, attivi la competenza SIP con ACCESO.
2. Clicchi su Aggiungi. Si apre Nuova connessione SIP.
3. Compili i campi:
   • Nome — come si chiama la connessione nell'elenco e nell'app, per esempio «Porta d'ingresso».
   • AOR — l'indirizzo SIP (address of record) dell'account con cui l'app si registra, nella forma utente@dominio. Può omettere il prefisso sip:; l'app lo aggiunge.
   • Server — l'indirizzo WebSocket del server SIP, per esempio wss://sip.example.com:8089/ws. Per una nuova connessione il campo è precompilato con un indirizzo sul controller (wss://<indirizzo del controller>:8089/ws); lo sostituisca con l'indirizzo del Suo server SIP.
   • Assegnazione utente — Tutti o un singolo utente. La connessione compare solo nelle app connesse con questo utente; con Tutti, in ogni app.
   • Apriporta — il componente che apre la porta (vedi Apriporta). Il campo compare solo se esiste un componente di questo tipo.
   • Attivato — l'app registra presso il server solo le connessioni attivate. Tolga la spunta per mettere fuori servizio una connessione temporaneamente, senza eliminarla.
4. In Avanzato inserisca le credenziali dell'account SIP (vedi Opzioni avanzate).
5. Clicchi su Salva.

Nome, AOR e Server sono obbligatori.

L'elenco mostra ogni connessione con Nome e Ultimo aggiornamento. Con la matita modifica una connessione (Modifica connessione SIP), con la × la elimina dopo una conferma. Finché non esiste alcuna connessione, l'elenco indica «Nessuna connessione SIP ancora configurata.»

Le app applicano le modifiche subito: ricaricano le connessioni e si registrano di nuovo presso il server.

Opzioni avanzate

In Avanzato si trovano opzioni che l'app passa invariate alla sua libreria SIP (SIP.js). Aggiunga altre opzioni tramite la selezione Aggiungi... e le rimuova con la × accanto. Il link Descrizione delle opzioni avanzate. porta alla descrizione di tutte le opzioni presso SIP.js. I nomi delle opzioni compaiono in inglese in tutte le lingue, tranne Nome utente e Password.

Una nuova connessione contiene queste opzioni:

• Nome utente e Password — le credenziali con cui l'app si registra presso il server SIP. Sono precompilati con i segnaposto «User1» e «1234»; li sostituisca con i dati dell'account SIP.
• Log Builtin Enabled, Log Configuration e Log Level — regolano solo il registro interno dell'app. Li lasci sui valori predefiniti.
• Graceful Shutdown — alla disconnessione chiude in modo ordinato le chiamate in corso e la registrazione invece di interromperle. Lasci attiva questa opzione.

Spesso utili sono inoltre:

• Display Name — il nome che l'app indica all'interlocutore.
• No Answer Timeout — dopo quanti secondi una chiamata senza risposta viene rifiutata. Senza valore, 60 secondi.
• Authorization Ha1 — al posto della password, il suo hash HA1, se il Suo server SIP lo supporta.

Apriporta

Il campo Apriporta offre tutti i componenti in grado di aprire una porta, per esempio un posto esterno che ha integrato come add-on dalla libreria online (p. es. DoorBird). Se non esiste alcun componente di questo tipo, il campo manca.

Se è scelto un apriporta, durante la chiamata l'app mostra il pulsante Apri. Questo attiva l'apertura sul componente scelto, tramite il collegamento proprio di quel componente, non tramite la connessione SIP. Senza apriporta, il pulsante manca.

Nell'app

Se una connessione è attivata e assegnata all'utente, l'app si registra presso il server SIP all'avvio. Su Android chiede a questo scopo l'accesso a fotocamera e microfono.

• In caso di chiamata, l'app mostra il nome del chiamante con Rifiuta e Rispondi.
• Durante la conversazione: Muto, Riaggancia e, con un apriporta, Apri. Se il posto esterno invia video, l'app mostra l'immagine.
• Rispondi automaticamente a questo chiamante — d'ora in poi l'app risponde da sé alle chiamate di questo interlocutore, con il microfono disattivato.
• L'app gestisce una sola chiamata alla volta. Una seconda chiamata mentre la prima è in corso non viene mostrata.

In Impostazioni → SIP l'occupante sceglie per ogni connessione la Suoneria e un intervallo Non disturbare durante il quale l'app non squilla; lì rimuove anche i chiamanti a cui l'app risponde automaticamente. Queste impostazioni valgono solo per il rispettivo dispositivo. Se nell'app è impostato un Codice di accesso, la voce SIP è raggiungibile solo con questo codice.

Risoluzione dei problemi

• La connessione viene accettata? Nell'app, in Impostazioni → SIP, ogni connessione indica Connesso o Non connesso e, sotto, in caso di problemi, Errore: con l'ultimo messaggio di errore.
• La connessione non compare nell'app: controlli Attivato e l'Assegnazione utente. L'app mostra solo le connessioni assegnate a Tutti o all'utente con cui è connessa.
• Non connesso: controlli Server — l'indirizzo deve iniziare con wss:// (o ws://) ed essere raggiungibile dal dispositivo su cui gira l'app. Poiché l'app si collega direttamente al server, questo vale anche fuori casa: se il server SIP è raggiungibile solo nella rete domestica, fuori casa l'app non squilla. Se il server usa per wss:// un certificato di cui il dispositivo non si fida (per esempio uno autofirmato), il dispositivo di norma rifiuta la connessione.
• Connesso, ma non squilla: controlli AOR, Nome utente e Password, e che il posto esterno chiami proprio questo account. Controlli nell'app se in quel momento è attivo Non disturbare.
• Squilla un solo dispositivo: tutte le app di una connessione si registrano con lo stesso account. Se squillano tutte lo decide il server SIP; deve consentire più registrazioni contemporanee per account.
• Manca il pulsante Apri: scelga un Apriporta per la connessione. Se manca il campo Apriporta, non esiste ancora alcun componente in grado di aprire una porta.