Axis 250S Manuel d'utilisateur Page 1

Naviguer en ligne ou télécharger Manuel d'utilisateur pour Mise en réseau Axis 250S. Axis HTTP API Manuel d'utilisatio

  • Télécharger
  • Ajouter à mon manuel
  • Imprimer
  • Page
    / 72
  • Table des matières
  • MARQUE LIVRES
  • Noté. / 5. Basé sur avis des utilisateurs
Vue de la page 0
CorporateWhere to buySupportSolutionsProductsHome
Support
Network Video
Developer pages
VAPIX
®
HTTP API ver.1
HTTP API ver.2
Difference v1/v2
Recording API
Parameters
RTSP API
IV Modules API
Other links
Partner program (ADP)
Downloads
Product firmware
Software tools
Customer Services
FAQ database
Online Helpdesk
Axis Customer Forum
Subscribe to e-news:
Network Video News
Axis Video API, HTTP - Interface Specification
Revision: 1.14
Date: 2004-April-22
TABLE OF CONTENTS
DOCUMENT HISTORY
1 OVERVIEW
1.1 Product and firmware versions
2 REFERENCES
3 DEFINITIONS
3.1 General notations
3.1.1 General abbreviations
3.1.2 Style convention
3.1.3 General CGI URL syntax and parameters
3.1.4 Parameter value convention
4 INTERFACE SPECIFICATION
4.1 Naming conventions and URL syntax
4.1.1 Obsolete CGI parameters
4.2 Server responses
4.2.1 HTTP status codes
5 API GROUPS
5.1 General
5.1.1 Get camera parameter values
5.1.2 Camera parameter values response
5.1.3 Set camera parameter values
5.1.4 Factory default
5.1.5 Restart server
Axis Communications - Network Camera Developer pages http://www.axis.com/techsup/cam_servers/dev/cam_http_api.php
1 of 72 5/21/10 15:42
Vue de la page 0
1 2 3 4 5 6 ... 71 72

Résumé du contenu

Page 1 - TABLE OF CONTENTS

CorporateWhere to buySupportSolutionsProductsHomeSupportNetwork VideoDeveloper pagesVAPIX®HTTP API ver.1HTTP API ver.2Difference v1/v2Recording APIPar

Page 2 - 2 of 72 5/21/10 15:42

http://myserver/axis-cgi/admin/getparam.cgi?Network 5.1.2 Camera parameter values responseWhen querying parameter values, the current parameter values

Page 3 - DOCUMENT HISTORY

5.1.3 Set camera parameter valuesSet a camera's parameter values.Note: This request requires administrator access (administrator authorization).M

Page 4 - 1 OVERVIEW

5.1.4 Factory defaultReload factory defaultNote: This request requires administrator access (administrator authorization).Method: GETSyntax:http://<

Page 5 - 3 DEFINITIONS

http://<servername>/axis-cgi/admin/serverreport.cgi 5.1.7 System logsGet system log informationNote: This request requires administrator access

Page 6 - 6 of 72 5/21/10 15:42

http://<servername>/jpg[/<camera>]/<name>.jpgwith the following parametersParameter Values Description<camera>1, ... 1Select i

Page 7 - 4 INTERFACE SPECIFICATION

<parameter>=<value>Values Descriptionresolution=<int>x<int><width>1,<height>1Specify the resolution as <width&g

Page 8 - 5 API GROUPS

showlength=<int> 0, 1 Content-Length is added to the HTTP-header and inthe boundary section, between the images.0 = hidden, 1 = shown.timeout=&l

Page 9 - 9 of 72 5/21/10 15:42

5.2.4 JPEG buffer requestRequest for controlling image buffers via HTTP.Method: GETSyntax:http://<servername>/axis-cgi/buffer/command.cgi?<p

Page 10 - 10 of 72 5/21/10 15:42

postalarm=<int> 0, ... Number of images to be saved after an alarmoccurs.predelay=<int> <milliseconds> The preferred time between th

Page 11 - 11 of 72 5/21/10 15:42

http://<servername>/mjpg[/<camera>]/<name>.mjpgwith the following parametersParameter Values Description<camera>1, ... 1Select

Page 12 - 12 of 72 5/21/10 15:42

Enter your E-mail:OKOther e-newsletteroptionsSearch5.1.6 Server report5.1.7 System logs5.2 JPEG/MJPG5.2.1 JPEG image request5.2.2 JPEG image (snapshot

Page 13 - 13 of 72 5/21/10 15:42

<parameter>=<value>Values Descriptionresolution=<int>x<int><width>1,<height>1Specify the resolution as <width&g

Page 14 - 14 of 72 5/21/10 15:42

showlength=<int> 0, 1 Content-Length is added to the HTTP-header and inthe boundary section, between the images.0 = hidden, 1 = shown.duration=&

Page 15 - 15 of 72 5/21/10 15:42

&compression=25Example: a Multipart JPEG image stream from camera 1 with a required frame rate of 5http://myserver/axis-cgi/mjpg/video.cgi?req_fps

Page 16 - 16 of 72 5/21/10 15:42

--myboundary\r\nContent-Type: image/jpeg\r\nContent-Length: 15656\r\n\r\n<JPEG image data>\r\n--myboundary\r\nContent-Type: image/jpeg\r\nConten

Page 17 - 17 of 72 5/21/10 15:42

maxlag=<int>500,... 1A number specifying at which lag (in ms) the servershould eliminate the lag by cutting the stream. A lagcould occur at the

Page 18 - 18 of 72 5/21/10 15:42

<MPEG stream>\r\n 5.3.3 MPEG-2 buffer requestRequest for pre-buffered MPEG-2 video.Method: GETSyntax:http://<servername>/axis-cgi/mpeg2/b

Page 19 - 19 of 72 5/21/10 15:42

http://<servername>/view/sdp/guide.sdpx 5.3.5 MPEG-2 multicast info responseThe response to an MPEG-2 multicast info request is a text file desc

Page 20 - 20 of 72 5/21/10 15:42

Last-Modified: Thu, 28 Nov 2002 13:12:24 GMTContent-Type: application/sdpv=0o=root 1038489142 1038489142 IN IP4 10.13.9.123s=AXIS 250S MPEG-2 Video Se

Page 21 - 21 of 72 5/21/10 15:42

http://<servername>/axis-cgi/com/ptz.cgi?<parameter>=<value>[&<parameter>=<value>... ]with the following parameters

Page 22 - 22 of 72 5/21/10 15:42

pan=<float> -180.0 - 180.0 Absolute: Pans the device relative to the (0,0)position.Relative: N/Atilt=<float> -180.0 - 180.0 Absolute: Tilt

Page 23 - 23 of 72 5/21/10 15:42

5.7.3 Recorded JPG/MJPG response5.7.4 Preserve and release recordings5.7.5 Controlling recordings5.8 I/O5.8.1 I/O control5.8.1.1 Input5.8.1.2 Output5.

Page 24 - 24 of 72 5/21/10 15:42

Relative: Move Focus approx. n steps relative tothe current position. Positive values mean focusnear, negative values mean focus far.riris=<int>

Page 25 - 25 of 72 5/21/10 15:42

continuousirismove=<int>-100 - 100 Continuous iris motion. Positive values mean irisopen and negative values mean iris close. "0"means

Page 26 - 26 of 72 5/21/10 15:42

<alignment> is one of the strings "horisontal" or"vertical". The alignment string determines if the x(horizontal) or the y

Page 27 - 27 of 72 5/21/10 15:42

"vertical" as alignment.irisbar=<int>,<string> <length>,<alignment><length> is the length of the bar in pixels

Page 28 - 28 of 72 5/21/10 15:42

Method: GETSyntax:http://<servername>/axis-cgi/audio/receive.cgiThere are no valid parameters and valuesExample: a Multipart Audio streamhttp://

Page 29 - 29 of 72 5/21/10 15:42

5.5.3 Multipart audio data transmitTransmits a Multi pa rt A ud io d at a stream.Method: POSTSyntax:http://<servername>/axis-cgi/audio/trans

Page 30 - 30 of 72 5/21/10 15:42

root.Audiod.duplexMode=<duplexMode>\nroot.Audiod.maxNumberOfClients=<maxNumberOfClients>\nroot.Audiod.forwardOnPost=<forwardOnPost>\

Page 31 - 31 of 72 5/21/10 15:42

The "key" entry is a unique window identity communicated in all actions concerning the window, i.e., whenadding, updating or removing it, or

Page 32 - 32 of 72 5/21/10 15:42

method=<char> w Motion detection method to use for this window.Default: wleft=<int> 0 ... 9999 The coordinate for the left boundary of the

Page 33 - 33 of 72 5/21/10 15:42

color and/or structure. A low value detects evenvery small changes and can e.g. trigger on imagenoise if set too low. A very high value on the otherha

Page 34 - 34 of 72 5/21/10 15:42

1.01 2000-nov-13 Added info about dataout and altered description of waitand timeout in "serial port control".1.02 2000-nov-28 Added entry f

Page 35 - 35 of 72 5/21/10 15:42

http://myserver/axis-cgi/admin/mdsetparam.cgi?action=add&key=2&name=Entrance&top=500&bottom=7000&left=5000&right=8500Example:

Page 36 - 36 of 72 5/21/10 15:42

right=<right>\r\nbottom=<bottom>\r\nsensitivity=<sensitivity>\r\nhistory=<history>\r\nsize=<size>\r\n\r\n[ <window da

Page 37 - 37 of 72 5/21/10 15:42

HTTP/1.0 200 OK\r\nContent-Type: multipart/x-mixed-replace;boundary=<boundary>\r\n\r\n --<boundary>\r\n<motion levels>where the prop

Page 38 - 38 of 72 5/21/10 15:42

with the following parameters and values<parameter>=<value>Values Descriptionrecordingid=<int> > 0 Recording id, unique number fo

Page 39 - 39 of 72 5/21/10 15:42

cameraname=<string> user specified Name of the camera recorded from.eventid=<int> user specified Event IDeventpath=<string> paramete

Page 40 - 40 of 72 5/21/10 15:42

postbufferstoptime=<int>:<int>Seconds since 1970:1/100 secondsTime of the postbufferstopframe.Example: 983453412:10priority=<int>0 -

Page 41 - 41 of 72 5/21/10 15:42

HTTP/1.0 200 OK\r\nContent-Type: text/plain\r\n\r\nrecordingid=12\r\ncameraid=1\r\ncameraname=backdoor\r\neventid=2\r\neventpath=root.Event.E2\r\neven

Page 42 - 42 of 72 5/21/10 15:42

\r\nrecordingid=357\r\n...eventstarttime=1025778305:00\r\n...eventstoptime=1025778401:34\r\n...\r\nExample 3: Search and list recordings of event 6 fr

Page 43 - 43 of 72 5/21/10 15:42

http://myserver/axis-cgi/view/reclist.cgi Server response containing info about allrecordingsPlay recording 24http://myserver/axis-cgi/view/player.c

Page 44 - 44 of 72 5/21/10 15:42

Example: 785421:57stopframe=<int>:<int>frame id3Play only a part of the recording. Stop at thisframe.Example: 785421:57time=<int>:&l

Page 45 - 45 of 72 5/21/10 15:42

The HTTP-based video interface provides the functionality for requesting single and multi-part images, forcontrolling camera functions (PTZ, output re

Page 46 - 46 of 72 5/21/10 15:42

timeout=<int> > 0 Set the timeout value (in seconds) of theplayer session.The session will be automatically closed ifan open stream is blocke

Page 47 - 47 of 72 5/21/10 15:42

http://myserver/axis-cgi/view/player.cgi?sessionid=3&startframe=45347:00&stopframe=47023:00&direction=backward&keepalive=yesExample 3:

Page 48 - 48 of 72 5/21/10 15:42

HTTP/1.0 200 OK\r\nContent-Type: multipart/x-mixed-replace;boundary=<boundary>\r\n\r\n--<boundary>\r\n<progress>1<image>where

Page 49 - 49 of 72 5/21/10 15:42

Content-Length: <image size>\r\n\r\n<JPEG image data>\r\nMeta tag Descriptionx-axis-dvr-search-progress-percent: <int>Percent (0-100

Page 50 - 50 of 72 5/21/10 15:42

Example: Response to request for part of recording starting at frame 563234:23 with keepalive set.HTTP/1.0 200 OK\r\nContent-Type: multipart/x-mixed-r

Page 51 - 51 of 72 5/21/10 15:42

This request changes the status on a recording from released to preserved or vice versa.A preserved recording is not affected by quality reduction, bu

Page 52 - 52 of 72 5/21/10 15:42

do=<string>1start,stopStart or stop recording.camera=<int>11, ... 2Selects a camera.1 Request must contain these. See example below.2 Prod

Page 53 - 53 of 72 5/21/10 15:42

<value>check=<int>[,<int>,...]<id1>[,<id2>, ...] 1Returns the status of one or more inputs numberedid1 ,id2, ...See 5.2

Page 54 - 54 of 72 5/21/10 15:42

http://myserver/axis-cgi/io/input.cgi?monitor=1,2,3,4Example: Monitor data on input port 1HTTP/1.0 200 OK\r\nContent-Type: multipart/x-mixed-replace;

Page 55 - 55 of 72 5/21/10 15:42

http://<servername>/axis-cgi/io/output.cgi?<parameter>=<value>[&<parameter>=<value>...]with the following parameters

Page 56 - 56 of 72 5/21/10 15:42

In URL syntax and in descriptions of CGI parameters, text in italic within angle brackets denotes content thatshould be replaced with either a value o

Page 57 - 57 of 72 5/21/10 15:42

http://myserver/axis-cgi/io/output.cgi?action=1:/300\500/300\Example: Wait 1 second before setting output 1 onhttp://myserver/axis-cgi/io/output.cgi?a

Page 58 - 58 of 72 5/21/10 15:42

5.9 Serial PortThe requests specified in the Serial Port section are supported by those video products that have implemented aGeneric driver.5.9.1 Ser

Page 59 - 59 of 72 5/21/10 15:42

parameter. A read is terminated when the specifiednumber of bytes is read or when the wait period hasended.timeout=<int> 1 - 9000 Specified in m

Page 60 - 60 of 72 5/21/10 15:42

determine the serial port to use.connect=<string> yes Makes the server keep theconnection open, and start actingas a link between the client and

Page 61 - 61 of 72 5/21/10 15:42

HTTP/1.0 204 No Content\r\n 5.10.2 Reset PPP connection maxtimerNote: This request requires administrator access (administrator authorization).Accessi

Page 62 - 62 of 72 5/21/10 15:42

http://<servername>/axis-cgi/operator/ev_admin.cgi?delete=<entry> 5.11.1.1 ActionsThese are the actions used to administer the events. Eac

Page 63 - 63 of 72 5/21/10 15:42

\r\n Request failed: <error message>\r\nExample: Adding new event entryhttp://myserver/axis-cgi/operator/ev_admin.cgi?addResponse:HTTP/1.0 20

Page 64 - 64 of 72 5/21/10 15:42

Syntax:http://<servername>/axis-cgi/admin/fwall_admin.cgi?listhttp://<servername>/axis-cgi/admin/fwall_admin.cgi?enable[&<option>

Page 65 - 65 of 72 5/21/10 15:42

host=<address>1host name2 or numericalInternet addressHost to add or modify.http Opens ports for HTTP access.https Opens ports for HTTPS acc

Page 66 - 66 of 72 5/21/10 15:42

Return: A successful enable, disable, delete or update:HTTP/1.0 200 OK\r\nContent-Type: text/plain\r\n\r\n OK\r\nReturn: A successful add:HTTP/1.0

Page 67 - 67 of 72 5/21/10 15:42

3.1.3 General CGI URL syntax and parametersCGI URLs are written in lower-case. CGI parameters are written in lower-case and as one word, with nounders

Page 68 - 68 of 72 5/21/10 15:42

where each <entry data> is: [<entry>]\r\nhost=<value>\r\nhttp=<value>\r\nhttps=<value>\r\nftp=<value>\r\ntelnet

Page 69 - 69 of 72 5/21/10 15:42

HTTP/1.0 200 OK\r\nContent-Type: text/plain\r\n\r\nF1 OK\r\nExample: Listing entrieshttp://myserver/axis-cgi/admin/fwall_admin.cgi?listResponse:HTTP/1

Page 70 - 70 of 72 5/21/10 15:42

Verification failed for IP 10.13.18.20\r\nExample: Deleting entry, overriding verificationhttp://myserver/axis-cgi/admin/fwall_admin.cgi?delete=F1&

Page 71 - 71 of 72 5/21/10 15:42

Return:HTTP/1.0 <HTTP code> <HTTP text>\r\nwith the following HTTP code and meaningsHTTP code HTTP text Description200 OK The request has

Page 72 - 72 of 72 5/21/10 15:42

requests have been grouped together. Information about which groups are supported can be found in theproduct-specific release notes document, availabl

Commentaires sur ces manuels

Pas de commentaire