5.8.2 api camera snapshot

Funkce /api/camera/snapshot umožňuje stažení obrázku z interní nebo externí IP kamery připojené k interkomu. Pomocí parametrů lze specifikovat zdroj obrázku, rozlišení apod.

Funkce je součástí služby Camera a v případě použití autentizace je nutné, aby uživatel měl přiřazené privilegium Kamera – sledování.

Pro tuto funkci lze použít metody GET nebo POST.

Parametry požadavku:

Parametr

Popis

width

Povinný parametr specifikující horizontální rozlišení JPEG snímku v pixelech. Rozlišení musí odpovídat jedné z podporovaných variant (viz funkce api/camera/caps). Při zadání nepodporované hodnoty nebude požadavek proveden.

height

Povinný parametr specifikující vertikální rozlišení JPEG snímku v pixelech. Rozlišení snímku musí odpovídat jedné z podporovaných variant (viz funkce api/camera/caps). Při zadání nepodporované hodnoty nebude požadavek proveden.

source

Volitelný parametr definující zdroj videa (internal – interní kamera, external – externí IP kamera). Pokud parametr není uveden, je zvolen výchozí zdroj videa uvedený v konfiguračním webovém rozhraní v sekci Hardware / Kamera / Společné nastavení.

fps

Volitelný parametr definující snímkovou frekvenci. Pokud je parametr nastaven na hodnotu >= 1, interkom odesílá s nastavenou snímkovou frekvencí obrázky metodou http server push.

time

Volitelný parametr definující čas snímku v paměti vrátníku. Hodnoty time musí být v rozsahu paměti vrátníku, tedy <-30, 0> sekund. Pokud je tento parametr použit společně s parametrem fps, je parametr fps ignorován a funkce vrátí pouze jeden snímek.

Pokud je tento parametr použit, vrací funkce snímky o maximálním rozlišení 1280 x 960 px (width × height). Požadavky parametrů width a height na vyšší hodnoty budou ignorovány.

Odpověď je ve formátu image/jpeg příp. multipart/x-mixed-replace (pro fps >= 1). V případě chybných parametrů požadavku, funkce vrací informaci ve formátu application/json

Příklad:

 GET /api/camera/snapshot?width=640&height=480&source=internal
 
 # následující příkaz vrátí snímek zachycený 5 sekund před voláním funkce
 GET /api/camera/snapshot?width=640&height=480&source=internal&time=-5