L'interfaccia API (Application Programming Interface) HTTP è un software di interfaccia che consente di integrare comodamente la videocamera in un sistema di gestione centralizzato. L'interfaccia è formata da due script CGI richiamabili con parametri e valori tramite i comandi HTTP. Grazie a questi script è possibile modificare le impostazioni dei sottomenu di Impostazione ed eseguire determinate funzioni della videocamera.
Modifica delle impostazioni del menu SetupIl comando HTTP http://31.47.87.165/control/control
consente di modificare le impostazioni del menu Setup.
Esecuzione delle funzioni della videocamera
Il comando HTTP http://31.47.87.165/control/rcontrol
permette di eseguire alcune funzioni della videocamera.
Importante: |
alcune funzioni di salvataggio e ripristino della configurazione possono essere eseguite solo da utenti con livello di accesso amministratore. In tal caso occorre un altro comando HTTP per richiamare lo script rcontrol, e precisamente:http://31.47.87.165/admin/rcontrol
|
---|
Per utilizzare l'istruzione list
con il comando control
, è necessario separare l'istruzione dal comando con un punto interrogativo ?:
http://31.47.87.165/control/control?list
Per eseguire un'istruzione con un parametro, separare l'istruzione dal parametro con una "e commerciale" &. Il valore del parametro è separato da un segno di uguale =
.
http://31.47.87.165/control/control?list§ion=actions
Per utilizzare più parametri, separarli con una "e commerciale" &:
http://31.47.87.165/control/rcontrol?action=ledson&time=5
Per alcuni parametri è necessario immettere due valori per indirizzarsi a entrambi gli obiettivi. Tali parametri sono riportati con due valori di default (ad esempio: 0 0
). Nel comando http questi valori vanno separati con un segno di addizione +:
http://31.47.87.165/control/control?set§ion=general&sharpen=0+0
Per utilizzare uno o più caratteri di 'a capo' in un comando, ad esempio per impostare diverse definizioni di finestre di movimento video, sostituire i caratteri di 'a capo' con la stringa CGI %0A
. http://31.47.87.165/control/control?set§ion=general&
coverimage_area=0,540,380,200,200,2%0A1,320,100,100,150,2
Per visualizzare le stringhe di formattazione CGI (a capo, spazi, accenti e così via), immettere i caratteri in base alla codifica URL. A tale scopo immettere un segno di percentuale %
seguito dal valore esadecimale del carattere da visualizzare. La tabella seguente contiene un elenco dei caratteri più comuni:
Carattere | Codifica URL | Carattere | Codifica URL | Carattere | Codifica URL |
---|---|---|---|---|---|
(a capo) | %0A |
(spazio) | %20 o + |
% | %25 |
& | %26 |
+ | %2B |
= | %3D |
? | %3F |
© | %A9 |
® | %AE |
ß | %DF |
ä | %e4 |
Ä | %c4 |
ö | %F6 |
Ö | %D6 |
ü | %FC |
Ü | %DC |
Ç | %c7 |
à | %e0 |
á | %e1 |
â | %E2 |
æ | %E6 |
ç | %E7 |
è | %E8 |
é | %E9 |
ê | %EA |
ë | %EB |
î | %ee |
ï | %EF |
ô | %F4 |
ù | %F9 |
ú | %FA |
ù | %FB |
û | %fc |
È possibile specificare i valori dei colori di alcuni parametri. Tali valori corrispondono ai valori esadecimali del rosso, verde e blu (RGB) di un colore specifico. Due caratteri rappresentano un colore: 00
rappresenta il valore più basso (nessun colore), FF
rappresenta il valore più alto (colore pieno). Per il tipo di miscelazione dei colori, 0x000000
è nero e 0XFFFFFF
è bianco.
Esempio:
0xFF0000 |
Rosso |
0x00FF00 |
Verde |
0x0000FF |
Blu |
Nome del colore | Notazione esadecimale | Colore | Nome del colore | Notazione esadecimale | Colore |
---|---|---|---|---|---|
Nero | 0x000000 |
Marrone | 0x800000 |
||
Verde scuro | 0x008000 |
Verde oliva | 0x808000 |
||
Blu oltremare | 0x000080 |
Viola | 0x800080 |
||
Verde bluastro | 0x008080 |
Grigio scuro | 0x808080 |
||
Grigio chiaro | 0xC0C0C0 |
Rosso | 0xFF0000 |
||
Verde | 0x00FF00 |
Giallo | 0xFFFF00 |
||
Blu | 0x0000FF |
Magenta | 0xFF00FF |
||
Ciano | 0x00FFFF |
Bianco | 0xFFFFFF |
È innanzitutto necessario comunicare alla videocamera le istruzioni da eseguire.
Istruzioni | Descrizione |
---|---|
set |
Accesso in scrittura alle impostazioni dell'immagine. Utilizzare questa istruzione per modificare le impostazioni dell'immagine.http://31.47.87.165/control/control?set
|
read |
Accesso in lettura alle impostazioni dell'immagine. Utilizzare questa istruzione per eseguire query informative sulle impostazioni dell'immagine.http://31.47.87.165/control/control?read
|
list |
L'istruzione list restituisce un elenco delle sezioni modificabili dei file di configurazione.
Esempio: Questo comando consente ad altre applicazioni di leggere i valori correnti e di ottenere le opzioni e i testi dell'interfaccia utente. |
factory |
L'istruzione factory permette di ripristinare i parametri di una sezione alle impostazioni di default. Questa chiamata richiede il nome sezione section=<nomesezione> come parametro addizionale.http://31.47.87.165/control/control?factory§ion=<nomesezione>
|
restore |
L'istruzione restore permette di ripristinare i parametri di una sezione ai valori contenuti nella memoria flash. Questa chiamata richiede il nome sezione section=<nomesezione> come parametro addizionale.http://31.47.87.165/control/control?restore§ion=<nomesezione>
|
Il primo valore atteso dallo script è sempre il nome dell'azione da eseguire. A seconda dell'azione può essere necessario fornire parametri addizionali. I parametri addizionali possono essere obbligatori od opzionali.
Nota: |
per visualizzare tutte le opzioni del comando rcontrol immettere l'istruzione |
---|
Azione | Descrizione | Parametro obbligatorio | Parametro opzionale | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
sigouthigh | L'uscita del segnale è chiusa. Il parametro time opzionale riapre l'uscita del segnale dopo il periodo di tempo definito. | nessuno/a |
| ||||||||
sigoutlow | L'uscita del segnale è aperta. Il parametro time opzionale chiude nuovamente l'uscita del segnale dopo il periodo di tempo definito. | nessuno/a |
|
||||||||
sound | Esegue il file audio boing. Il parametro soundfile opzionale permette di specificare un file di suono. È inoltre possibile utilizzare uno dei file di suono forniti con il software, oppure qualsiasi file registrato nella finestra di dialogo Gestione messaggi vocali. | nessuno/a |
|
||||||||
ledson | Attiva tutti i led. Il parametro time opzionale resetta i led alle impostazioni di default dopo il periodo di tempo specificato. | nessuno/a |
|
||||||||
ledsoff | Disattiva tutti i led. Il parametro time opzionale resetta i led alle impostazioni di default dopo il periodo di tempo specificato. | nessuno/a |
|
||||||||
ledsdefault | Resetta tutti i led alle impostazioni di default. Il parametro time opzionale resetta i led alle impostazioni precedenti l'intervallo di tempo specificato. | nessuno/a | time | ||||||||
ledsstring |
È possibile cambiare esplicitamente lo stato di ogni singolo led. È sufficiente utilizzare il parametro leds. Questo parametro attende una stringa di sei caratteri, ognuno dei quali definisce lo stato di un led. I caratteri sono allocati in senso orario, con il primo riferito al led che si trova nella posizione "ore 12". Esempio: http://31.47.87.165/
|
leds
|
|
||||||||
irledson | Attiva tutti i led IR. Il parametro time opzionale disattiva nuovamente tutti i led dopo il periodo di tempo definito. | nessuno/a |
|
||||||||
irledsoff | Disattiva tutti i led IR. | nessuno/a | nessuno/a | ||||||||
irledsstring |
È possibile cambiare in modo esplicito lo stato dei led IR per ciascun lato. È sufficiente utilizzare il parametro leds. Questo parametro attende una stringa di due caratteri, ognuno dei quali definisce lo stato di un led IR. Il primo carattere della stringa controlla lo stato della serie di led a destra, il secondo la serie di led a sinistra. Esempio: |
leds
|
|
||||||||
defreeze | Sblocca la videocamera dopo un evento Arresta azione (SP) e riprende la registrazione delle immagini. | nessuno/a | nessuno/a | ||||||||
putrs232 | Invia il testo tramite interfaccia seriale. Quando non si imposta il parametro rs232outtext, vengono trasferite solo le parole "hello world". | nessuno/a |
|
||||||||
getrs232 | Legge il testo dall'interfaccia seriale. Quando non si utilizzano altri parametri, dal buffer vengono letti solo gli ultimi 2048 byte. | nessuno/a |
|
||||||||
getrs232hex | È simile alla funzione getrs232, con l'unica differenza che i caratteri sono restituiti come codice esadecimale. | nessuno/a | come getrs232 | ||||||||
userclick | Esegue la funzione Clic utente. | nessuno/a | nessuno/a | ||||||||
pancenter | Imposta la posizione della sezione dell'immagine ingrandita al centro dell'immagine visibile. | nessuno/a | nessuno/a | ||||||||
gettemp | Restituisce la temperatura interna della videocamera.
|
nessuno/a | nessuno/a | ||||||||
rs232sigin | Restituisce lo stato del pin 9 dell'interfaccia seriale. | nessuno/a | nessuno/a | ||||||||
setrs232sig | Imposta i pin dell'interfaccia seriale. Verificare che l'interfaccia seriale sia stata correttamente configurata nella finestra di dialogo Impostazione dell'interfaccia seriale e del modem. |
|
nessuno/a | ||||||||
ftplastevent | Trasferisce via FTP l'ultima immagine dell'allarme memorizzata. Attende il nome di un profilo FTP come informazione addizionale. Il profilo deve essere definito nella finestra di dialogo Profili FTP. |
|
nessuno/a | ||||||||
ftpcurrent | Trasferisce l'immagine corrente via FTP. Attende il nome di un profilo FTP come informazione addizionale. Il profilo deve essere definito nella finestra di dialogo Profili FTP. |
|
nessuno/a | ||||||||
emaillastevent | Trasferisce via email l'ultima immagine dell'allarme memorizzata. Attende il nome di un profilo email come informazione addizionale. Il profilo deve essere definito nella finestra di dialogo Profili email. |
|
nessuno/a | ||||||||
emailcurrent | Trasferisce via email l'immagine corrente. Attende il nome di un profilo email come informazione addizionale. Il profilo deve essere definito nella finestra di dialogo Profili email. |
|
nessuno/a | ||||||||
notifylastevent | Invia un messaggio di rete con lo stato dell'immagine più recente dell'evento. |
|
nessuno/a | ||||||||
notifycurrent | Invia un messaggio di rete con lo stato dell'immagine corrente. |
|
nessuno/a | ||||||||
sendmessage | Invia una notifica IP all'indirizzo definito
|
|
nessuno/a | ||||||||
actionactivityon | Attiva tutte le azioni | nessuno/a | nessuno/a | ||||||||
actionactivityoff | Disattiva tutte le azioni | nessuno/a | nessuno/a | ||||||||
actionactivitytime | Attiva tutte le azioni per il periodo di tempo definito nella finestra di dialogo Impostazioni generali eventi. | nessuno/a | nessuno/a | ||||||||
eventack | Riconosce un allarme. | nessuno/a | nessuno/a | ||||||||
isdnphone | Attiva un messaggio vocale dalla videocamera via telefono. Come informazione addizionale attende il nome di un profilo definito in Profili telefonia. |
|
nessuno/a | ||||||||
speakip | Ripete l'indirizzo IP corrente tramite l'altoparlante.
Nota: |
nessuno/a | nessuno/a |
Le funzioni di salvataggio e ripristino della configurazione possono essere eseguite solo da utenti del livello di accesso admin.
Esempio: |
http://31.47.87.165/admin/rcontrol?action=storeconfig
|
---|
Nota: | Questo comando non è disponibile per il modello Web e di base. |
---|
Funzione | Descrizione | Parametro obbligatorio | Parametro opzionale |
---|---|---|---|
storeconfig | Archivia la configurazione corrente nella memoria permanente della videocamera. | nessuno/a | nessuno/a |
restoreconfig | Ripristina l'ultima configurazione salvata nella memoria permanente della videocamera. | nessuno/a | nessuno/a |
resetconfig | Legge le impostazioni di default della videocamera. | nessuno/a | nessuno/a |
reboot | Riavvia la videocamera. | nessuno/a | nessuno/a |
cn, de, en, es, fr, it, jp, ru |