JVC VN-V686UAPI manual General

Page 17

Date: Fri, 13 MAY 2005 07:33:12 GMT<CRLF>

Server: JVC VN-V686 API Server<CRLF>

network.interface.subnetmask=255.0.0.0&200 OK<CRLF>

4) The client disconnects TCP80 to end the use of API.

Note: APIs for getting/setting parameters are not restricted by the access restriction function.

6. API for Getting/Changing Parameters of VN-V686

This section provides description of APIs for getting/changing parameters of VN-V686. Make use of the API explained in this section in the way as mentioned in Section 5

.

6.1. General

(1)Getting parameter

Specify API in GET line according to the format below when getting a parameter from VN-V686.

/api/param?ParamA.ParamB.ParamC

The upper limit of this character string is 1024 bytes.

When acquisition is successfully completed, values will be shown in the body of HTTP response, followed by "&200 OK" message.

Example:

ParamA.ParamB.ParamC=Data&200 OK

When an error occurs, an error code will be returned instead of indicating a value in the body of HTTP response. Example:

ParamA.ParamB.ParamC&401 Unauthorized

(2) Setting parameter

Specify API in GET line according to the format below when setting a parameter for VN-V686.

/api/param?ParamA.ParamB.ParamC=Data

Parameter values are indicated using =. Do not insert space before and after =.

The upper limit of this character string is 1024 bytes.

Response will be in the following format.

ParamA.ParamB.ParamC&200 OK

17

Image 17
Contents VN-V686U Updates Custom Application Software Development Guide Content Host 192.168.0.2CRLFCRLF Basic ProceduresPage Parameter Description Response When API is successfully received with boundary=onAPI Format Structure Jpeg File Format Sent Out by VN-V686 When API is successfully received with boundary=offRestrictions 190.00 .00 corresponds to -5 degrees Getting MPEG-4 from VN-V686 via Http Page Response When API is successfully received MPEG-4 Stream Format Sent Out by VN-V686 VOL VOP Search VN-V686 in LANProcedure Getting Alarm from VN-V686Encoded User Name and Password General Getting Camera ID stored in Jpeg from VN-V686 Camera Saving Changes of Camera SettingsSetting Camera ID in Jpeg from VN-V686 Setting Black level for VN-V686 Setting Monitor Type for VN-V686Getting Monitor Type from VN-V686 Getting Black level from VN-V686Setting Active Gamma Level for VN-V686 Setting Gamma for VN-V686Getting Gamma from VN-V686 Getting Active Gamma Level from VN-V686Setting Enhance for VN-V686 Setting Enhance Band for VN-V686Getting Enhance Band from VN-V686 Getting Enhance from VN-V686Setting Stabilizer for VN-V686 Setting Color Level for VN-V686Getting Color Level from VN-V686 Getting Stabilizer from VN-V686Setting DNR for VN-V686 Setting Stabilizer Level for VN-V686Getting Stabilizer Level from VN-V686 Getting DNR from VN-V686Setting Limit of Sense Up for VN-V686 Setting AGC for VN-V686Getting AGC from VN-V686 Getting Limit of Sense Up from VN-V686Setting Shutter Speed for VN-V686 Setting ALC priority for VN-V686Getting B&W Mode from VN-V686 Getting Shutter Speed from VN-V686Getting Auto Focus mode for B&W switching from VN-V686 Setting B&W Mode for VN-V686Setting Auto Focus mode for B&W switching for VN-V686 Getting Light setting for focus in B&W mode from VN-V686Getting Iris from VN-V686 Setting Light for focus in B&W mode for VN-V686Saving Image Settings for Auto Pan and Auto Trace Setting Iris Direction for VN-V686 Setting Iris for VN-V686Operating Iris for VN-V686 Getting White Balance from VN-V686Setting R-Gain of White Balance for VN-V686 Setting White Balance for VN-V686Getting R-Gain of White Balance from VN-V686 Getting B-Gain of White Balance from VN-V686Getting Current R-Gain of Auto White Balance from VN-V686 Setting B-Gain of White Balance for VN-V686Getting Current B-Gain of Auto White Balance from VN-V686 Getting Back Light Compensation from VN-V686Encoding Saving Changes of Encode Settings for VN-V686 Setting Back Light Compensation for VN-V686Setting Jpeg Frame Size for VN-V686 Getting Jpeg Frame Size from VN-V686Setting Jpeg Rate Control for VN-V686 Getting Jpeg Rate Control Setting from VN-V686Getting Jpeg File Size Setting from VN-V686 Setting Jpeg File Size Setting for VN-V686Getting MPEG-4 Frame Size from VN-V686 Setting MPEG-4 Frame Size for VN-V686Setting MPEG-4 bitrate Setting for VN-V686 Getting MPEG-4 bitrate Setting from VN-V686Getting MPEG-4 Rate Control Setting from VN-V686 Setting MPEG-4 Rate Control for VN-V686Getting MPEG-4 I-Frame Interval Setting from VN-V686 Setting MPEG-4 Frame Rate Setting for VN-V686Setting MPEG-4 I-Frame Interval Setting for VN-V686 Getting MPEG-4 Priority Setting from VN-V686Alarm Setting Getting On/Off of Alarm Action from VN-V686 Setting MPEG-4 Priority Setting for VN-V686Format /api/param?application.eventNumber.status Format /api/param?application.eventNumber.status=dataFormat /api/param?application.eventNumber.action Getting Alarm Action from VN-V686Api/param?application.event1.action Example of Response application.event1.action=&200 OKSsage Setting Alarm Action for VN-V686Format /api/param?application.eventNumber.action=Data Alarm%20ON Api/param?application.event1.filtersunday.status=on Getting Alarm Filter Setting from VN-V686Setting Alarm Filter for VN-V686 Setting Alarm Filter Time for VN-V686 Getting Alarm Filter Time from VN-V686Setting Alarm Filter Type for VN-V686 Getting Alarm Filter Type from VN-V686Getting Alarm Trigger from VN-V686 Api/param?application.event1.filtersunday.type=unmaskExample of Response application.event1.trigger=v1&200 OK Setting Alarm Trigger for VN-V686Format /api/param?application.eventNumber.trigger=data Api/param?application.event1.trigger=m1Setting Example /api/param?application.event6.trigger=i1500 Setting Smtp Server Address for VN-V686Setting Example /api/param?application.event1.trigger=v1 Setting Smtp Server Port Number for VN-V686 Getting Smtp Server Port Number Setting from VN-V686Getting Sender Mail Address Setting from VN-V686 Setting Sender Mail Address for VN-V686Setting POP before Smtp for VN-V686 Getting POP before Smtp Setting from VN-V686Getting POP Server Address Setting from VN-V686 Setting POP Server Address for VN-V686Getting POP Server User Name Setting from VN-V686 Setting POP Server Port Number for VN-V686Setting POP Server User Name for VN-V686 Example of setting /api/param?application.pop.user=somenameGetting FTP Server Address Setting from VN-V686 Setting POP Server Password for VN-V686Setting FTP Server Address for VN-V686 Getting FTP Server Path Setting from VN-V686Setting FTP Server User Name for VN-V686 Getting FTP Server User Name Setting from VN-V686Setting FTP Server Password for VN-V686 Getting File Naming of Periodic FTP from VN-V686Getting User Define Name of File Naming from VN-V686 Setting File Naming of Periodic FTP for VN-V686Example of Response application.ftp.naming=default&200 OK Getting Parameters of Pre/Post Recording from VN-V686 Setting User Define Name of File Naming for VN-V686Setting Parameters of Pre/Post Recording for VN-V686 Setting Alarm Output Time for VN-V686 Getting Alarm Output Time Setting from VN-V686Getting Alarm Output Status from VN-V686 Changing Alarm Output of VN-V686Setting Auto Return Mode for VN-V686 Getting Auto Return Mode from VN-V686Getting Timeout of Auto Return from VN-V686 Setting Timeout of Auto Return for VN-V686Start/Stop of Auto Tracking for VN-V686 Setting Auto Return Status for VN-V686Getting Auto Return Status from VN-V686 Specify target for Intelligent Tracking for VN-V686 Setting Detection Level of Auto Tracking for VN-V686Getting Detection Level of Auto Tracking from VN-V686 Getting Restart Time of Auto Tracking from VN-V686Setting Detection Area of Intelligent Tracking for VN-V686 Setting Restart Time of Auto Tracking for VN-V686Getting Detection Area of Intelligent Tracking from VN-V686 Format /api/param?camera.motion.autotracking2.areaSetting Zoom Limit of Intelligent Tracking for VN-V686 Setting Tracking Zoom of Intelligent Tracking for VN-V686Getting Zoom Limit of Intelligent Tracking from VN-V686 Getting Maximum Zoom of Intelligent Tracking from VN-V686Setting Threshold of Intelligent Tracking for VN-V686 Setting Maximum Zoom of Intelligent Tracking for VN-V686Getting Threshold of Intelligent Tracking from VN-V686 Getting Dead Zone of Intelligent Tracking from VN-V686Setting Upper Limit of EZoom for VN-V686 Setting Dead Zone of Intelligent Tracking for VN-V686Setting On/Off of Pan Limit for VN-V686 Getting Upper Limit of EZoom from VN-V686Setting Right Side of Pan Limit for VN-V686 Setting Left Side of Pan Limit for VN-V686Getting Left Side of Pan Limit from VN-V686 Getting Right Side of Pan Limit from VN-V686Getting Speed of Going to Preset Position from VN-V686 Setting Tilt Limit for VN-V686Setting Speed of Going to Preset Position for VN-V686 Getting Auto Flip Setting from VN-V686Getting Pan Position from VN-V686 Setting Auto Flip for VN-V686Getting Current Status of Digital Flip from VN-V686 Setting Speed of Pan Operation for VN-V686 Setting Direction of Pan Operation for VN-V686Moving to Specified Pan Position for VN-V686 Pan Operation for VN-V686Getting Tilt Position from VN-V686 Setting Status of Variable Pan/Tilt Speed for VN-V686Moving to Specified Tilt Position for VN-V686 Tilt Operation for VN-V686Setting Speed of Tilt Operation for VN-V686 Setting Direction of Tilt Operation for VN-V686Getting Tilt Operation Status from VN-V686 Getting Zoom Position from VN-V686Setting Speed of Zoom Operation for VN-V686 Setting Direction of Zoom Operation for VN-V686Zoom Operation for VN-V686 Getting Zoom Operation Status from VN-V686Setting Speed of Focus Operation for VN-V686 Setting Direction of Focus Operation for VN-V686Moving to Specified Focus Position for VN-V686 Focus Operation for VN-V686Getting Status of Specified Preset Position from VN-V686 Getting Current Preset Position from VN-V686Register Current Position as Preset Position for VN-V686 Initialize Preset Position for VN-V686Getting Title of Preset Position from VN-V686 Moving to Preset Position for VN-V686Setting Title to Preset Position for VN-V686 Getting Status of Auto Pan from VN-V686Setting Speed of Auto Pan for VN-V686 Setting Direction of Auto Pan for VN-V686Getting Direction of Auto Pan from VN-V686 Getting Speed of Auto Pan from VN-V686Start/Stop of Auto Trace for VN-V686 Getting Status of Auto Trace from VN-V686Start/Stop of Auto Trace Recording for VN-V686 Api/param?camera.motion.autotrace.record.status=startGetting Status of Auto Patrol from VN-V686 Getting Status of Auto Trace Recording from VN-V686Auto Patrol Start/Stop of Auto Patrol for VN-V686 Setting Preset Postion Number of Auto Patrol for VN-V686 Getting Preset Postion Number of Auto Patrol from VN-V686Setting Duarion of Auto Patrol for VN-V686 Getting Duration of Auto Patrol from VN-V686Getting Status of a Privacy Masking Area from VN-V686 Setting Whole Status of Privacy Masking for VN-V686Setting Privacy Masking Brightness for VN-V686 Setting Status of a Privacy Masking Area for VN-V686Getting Privacy Masking Brightness from VN-V686 Start/Save Editing of Privacy Masking for VN-V686Setting Motion Detect to On/Off for VN-V686 Setting Width of Privacy Masking Area for VN-V686Setting Height of Privacy Masking Area for VN-V686 Setting Motion Detect Mask for VN-V686 Setting Motion Detect Sensitivity for VN-V686Getting Motion Detect Sensitivity from VN-V686 Getting Motion Detect Mask from VN-V686Setting Dhcp for VN-V686 Network Basics Enabling Network Setting ChangesGetting Dhcp Setting from VN-V686 Setting Subnet Mask for VN-V686 Setting IP Address for VN-V686Getting Default Gateway from VN-V686 Getting IP Address from VN-V686Setting Host Name for VN-V686 Setting Default Gateway for VN-V686Getting Host Name from VN-V686 Getting DNS Server On/Off Status from VN-V686Getting DNS Server IP Address from VN-V686 Setting DNS Server IP Address for VN-V686Getting MAC Address from VN-V686 Network Details Getting TOS Value of Jpeg from VN-V686Setting TOS Value of MPEG-4 for VN-V686 Setting TOS Value of Jpeg for VN-V686Setting Unicast TTL for VN-V686 Getting TOS Value of MPEG-4 from VN-V686Setting MTU Value for VN-V686 Setting Multicast TTL for VN-V686Getting Multicast TTL Value from VN-V686 Getting MTU Value VN-V686Setting Network Negotiation for VN-V686 Getting Network Negotiation Setting from VN-V686Setting Port Number of Http for VN-V686 Protocol Getting Port Number of Http from VN-V686Getting Jpeg Multicast Address from VN-V686 Setting Jpeg Multicast Address for VN-V686Setting Frame Rate of Jpeg Multicast for VN-V686 Setting Jpeg Multicast Port Number for VN-V686Getting Jpeg Multicast Port Number from VN-V686 Getting Frame Rate of Jpeg Multicast from VN-V686Getting MPEG-4 Multicast Port Number from VN-V686 Setting MPEG-4 Multicast Address for VN-V686Getting MPEG-4 Multicast Address from VN-V686 Format /api/param?network.accesscontrolstreamout.hostNumber Setting MPEG-4 Multicast Port Number for VN-V686Setting Client Restriction to Deny/Allow for VN-V686 Network.accesscontrolstreamout.host1=10.0.0.0/24&200 OK Setting IP Address of Restricted Client for VN-V686Example /api/param?network.accesscontrolstreamout.host1=%00 Time Getting On/Off of Sntp Client from VN-V686Getting Access Interval to NTP Server from VN-V686 Setting NTP Server Address for VN-V686Setting Access Interval to NTP Server for VN-V686 Getting NTP Server Address from VN-V686Setting Access Interval Unit of Sntp for VN-V686 Getting Access Interval Unit of NTP from VN-V686Setting Time for VN-V686 Getting Time from VN-V686GMT-9 Format /api/param?system.password.data1=data2 Setting Timezone for VN-V686Password Setting Password for VN-V686 Firmware Update Maintenance InitializationGetting Status of Auto Cleaning from VN-V686 Setting Auto Cleaning for VN-V686Format /api/param?system.session Setting Time of Auto Cleaning for VN-V686Getting Status Getting Sending Status Getting Firmware Revisions of Streaming Manager Getting Settings Getting Model NameGetting Log Getting Firmware Revisions of PTZ Controller Getting Alarm Input Status from VN-V686Getting Firmware Revisions of Image Processor Getting Firmware Revisions of LensSetting Mode of FTP Server for VN-V686 Getting Mode of FTP Server from VN-V686Setting Control Port Number of FTP Server for VN-V686 Getting Control Port Number of FTP Server from VN-V686List of Protocols and Port Numbers Used with VN-V686 Methods of ActiveX Getting Multicast Seamless Switching 103 104 FAQ