Guida in linea MOBOTIX

Opzioni API HTTP

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.

Il comando HTTP http://192.168.1.225/control/control consente di modificare le impostazioni del menu Setup.

Esecuzione delle funzioni della videocamera

Il comando HTTP http://192.168.1.225/control/rcontrol permette di eseguire alcune funzioni della videocamera.

Convenzioni relative ai comandi

Comandi con un'istruzione

Per utilizzare l'istruzione list con il comando control, è necessario separare l'istruzione dal comando con un punto interrogativo ?:
   http://192.168.1.225/control/control?list

Comando con un'istruzione e una coppia parametro/valore

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://192.168.1.225/control/control?list&section=action

Comando con un'istruzione e diverse coppie parametro/valore

Per utilizzare più parametri, separarli con una "e commerciale" &:
    http://192.168.1.225/control/rcontrol?action=ledson&time=5

Diversi valori per un parametro

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://192.168.1.225/control/control?set&section=general&sharpen=0+0

Caratteri di 'a capo' nei comandi

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://192.168.1.225/control/control?set&section=general&
    coverimage_area=0,540,380,200,200,2%0A1,320,100,100,150,2

Caratteri speciali nei comandi

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:

Tabella dei codici dei colori

È 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:

Il comando control

È innanzitutto necessario comunicare alla videocamera le istruzioni da eseguire.

Istruzioni per il comando control

Il comando rcontrol

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.

Parametri di rcontrol

Salvataggio e ripristino della configurazione

Le funzioni di salvataggio e ripristino della configurazione possono essere eseguite solo da utenti del livello di accesso admin.

Funzioni per gli utenti del livello admin