Custom Application Software Development Guide

VN-V685/686/686B can be used from a custom application software by utilizing the API and protocols for VN-V685/686/686B. The following operations are possible.

-Getting JPEG from VN-V685/686/686B.

-Getting MPEG-4 from VN-V685/686/686B.

-Getting Alarm from VN-V685/686/686B.

-Getting or changing VN-V685/686/686B settings.

-Pan/Tilt/Zoom/Focus operation of VN-V685/686/686B.

-Sending Multicast from VN-V685/686/686B.

-Customization of VN-V685/686/686B's built-in viewer.

Page 3

Image 3

JVC 686U, 686BU, VN-V685U manual Custom Application Software Development Guide

Contents

API Guide Updates Custom Application Software Development Guide Content Getting Jpeg from VN-V685/686/686B via Http Basic ProceduresPage Parameter Description API Format Structure Response When API is successfully received with boundary=on When API is successfully received with boundary=offRestrictions Jpeg File Format Sent Out by VN-V685/686/686B Access restriction Getting MPEG-4 from VN-V685/686/686B via Http Example of VN-V685 API Format Structure Response When API is successfully received 20070319161455123UTC MPEG-4 Stream Format Sent Out by VN-V685/686/686B Search VN-V685/686/686B in LAN Procedure Using API that Requires Basic Authentication User Vn-v686 VN-V685 and VN-V686B Username Camera General Getting Camera ID stored in Jpeg from VN-V685/686/686B Saving Changes of Camera SettingsSetting Camera ID in Jpeg from VN-V685/686/686B Example of setting /api/param?camera.id=Camera01 Getting Black level from VN-V685/686/686B Setting Monitor Type for VN-V685/686/686BSetting Black level for VN-V685/686/686B Getting Monitor Type from VN-V685/686/686B Getting Active Gamma Level from VN-V685/686/686B Setting Gamma for VN-V685/686/686BSetting Active Gamma Level for VN-V685/686/686B Getting Gamma from VN-V685/686/686B Getting Color Level from VN-V685/686/686B Setting Enhance Band for VN-V685/686/686BSetting Enhance for VN-V685/686/686B Getting Enhance from VN-V685/686/686B Getting Stabilizer Level from VN-V685/686/686B Setting Color Level for VN-V685/686/686BSetting Stabilizer for VN-V685/686/686B Getting Stabilizer from VN-V685/686/686B Getting 3D Noise Reduction from VN-V685/686B Setting Stabilizer Level for VN-V685/686/686BSetting DNR for VN-V685/686/686B Getting DNR from VN-V685/686/686B Getting Limit of Sense Up from VN-V685/686/686B Setting 3D Noise Reduction for VN-V685/686BSetting AGC for VN-V685/686/686B Getting AGC from VN-V685/686/686B Getting ALC priority from VN-V685/686/686B Setting Limit of Sense Up for VN-V685/686/686BSetting ALC priority for VN-V685/686/686B Setting Shutter Speed for VN-V685/686/686B Format /api/param?camera.image.truedaynight.af=data Getting B&W Mode from VN-V685/686/686BSetting B&W Mode for VN-V685/686/686B Camera.image.truedaynight&202 Acceptedcamera.status=save Camera.image.truedaynight.af&202 Acceptedcamera.status=save Setting Light for focus in B&W mode for VN-V685/686/686BSaving Image Settings for Auto Pan and Auto Trace Example /api/param?camera.image.truedaynight.af=on Operating Iris for VN-V685/686/686B Setting Iris for VN-V685/686/686BSetting Iris Direction for VN-V685/686/686B Getting Iris from VN-V685/686/686B Example of response camera.iris.status&200 OK Setting White Balance for VN-V685/686/686BGetting White Balance from VN-V685/686/686B Getting R-Gain of White Balance from VN-V685/686/686B Setting R-Gain of White Balance for VN-V685/686/686B Setting B-Gain of White Balance for VN-V685/686/686BGetting B-Gain of White Balance from VN-V685/686/686B Getting Back Light Compensation from VN-V685/686/686B Setting Back Light Compensation for VN-V685/686/686B Getting Jpeg Frame Size from VN-V685/686/686B Setting Jpeg Frame Size for VN-V685/686/686BGetting Jpeg Rate Control Setting from VN-V685/686/686B Setting Jpeg Rate Control for VN-V685/686/686B Format /api/param?encode2.framesize Getting Jpeg File Size Setting from VN-V685/686/686BSetting Jpeg File Size Setting for VN-V685/686/686B Getting MPEG-4 Frame Size from VN-V685/686/686B Getting MPEG-4 Rate Control Setting from VN-V685/686/686B Setting MPEG-4 Frame Size for VN-V685/686/686BGetting MPEG-4 bitrate Setting from VN-V685/686/686B Setting MPEG-4 bitrate Setting for VN-V685/686/686B Setting MPEG-4 Frame Rate Setting for VN-V685/686/686B Getting MPEG-4 Frame Rate Setting from VN-V685/686/686B Getting MPEG-4 Priority Setting from VN-V685/686/686B Setting MPEG-4 Priority Setting for VN-V685/686/686BFormat /api/param?application.eventNumber.status Getting Alarm Action from VN-V685/686/686B Format /api/param?application.eventNumber.action=Data Setting Alarm Action for VN-V685/686/686B Ssage Alarm%20ON Getting Alarm Filter Setting from VN-V685/686/686B Api/param?application.event1.filtersunday.status=on Setting Alarm Filter for VN-V685/686/686BGetting Alarm Filter Time from VN-V685/686/686B Setting Alarm Filter Time for VN-V685/686/686B Getting Alarm Filter Type from VN-V685/686/686B Setting Alarm Filter Type for VN-V685/686/686BApi/param?application.event1.filtersunday.type=unmask Example of Response application.event1.trigger=v1&200 OK Getting Alarm Trigger from VN-V685/686/686BSetting Alarm Trigger for VN-V685/686/686B Format /api/param?application.eventNumber.trigger Api/param?application.event1.trigger=m1 Setting Example /api/param?application.event1.trigger=v1Setting Example /api/param?application.event6.trigger=i1500 Format /api/param?application.eventNumber.trigger=data Setting Smtp Server Address for VN-V685/686/686B Setting Smtp Server Port Number for VN-V685/686/686BGetting Sender Mail Address Setting from VN-V685/686/686B Getting POP Server Address Setting from VN-V685/686/686B Setting Sender Mail Address for VN-V685/686/686BGetting POP before Smtp Setting from VN-V685/686/686B Setting POP before Smtp for VN-V685/686/686B Setting POP Server Port Number for VN-V685/686/686B Getting POP Server User Name Setting from VN-V685/686/686BSetting POP Server User Name for VN-V685/686/686B Getting FTP Server Path Setting from VN-V685/686/686B Setting POP Server Password for VN-V685/686/686BGetting FTP Server Address Setting from VN-V685/686/686B Setting FTP Server Address for VN-V685/686/686B Setting FTP Server Password for VN-V685/686/686B Setting FTP Server Path for VN-V685/686/686BGetting FTP Server User Name Setting from VN-V685/686/686B Setting FTP Server User Name for VN-V685/686/686B Setting File Naming of Periodic FTP for VN-V685/686/686B Api/param?application.ftp.password=%00Getting File Naming of Periodic FTP from VN-V685/686/686B Setting User Define Name of File Naming for VN-V685/686/686B Getting Alarm Output Time Setting from VN-V685/686/686B Setting Alarm Output Time for VN-V685/686/686BGetting Alarm Output Status from VN-V685/686/686B PTZ Changing Alarm Output of VN-V685/686/686BGetting Auto Return Mode from VN-V685/686/686B Setting Auto Return Mode for VN-V685/686/686B Getting Auto Return Status from VN-V685/686/686B Getting Timeout of Auto Return from VN-V685/686/686BSetting Timeout of Auto Return for VN-V685/686/686B Setting Auto Return Status for VN-V685/686/686B Api/param?camera.motion.autotracking2.target=s10-s20 Start/Stop of Auto Tracking for VN-V685/686/686B Setting Restart Time of Auto Tracking for VN-V685/686/686B Getting Restart Time of Auto Tracking from VN-V685/686/686BFormat /api/param?camera.motion.autotracking2.area Page Page Getting Upper Limit of EZoom from VN-V685/686/686B Setting Upper Limit of EZoom for VN-V685/686/686B Getting Left Side of Pan Limit from VN-V685/686/686B Setting On/Off of Pan Limit for VN-V685/686/686BSetting Left Side of Pan Limit for VN-V685/686/686B Getting On/Off of Pan Limit from VN-V685/686/686B Getting Tilt Limit from VN-V685/686/686B Setting Right Side of Pan Limit for VN-V685/686/686BSetting Tilt Limit for VN-V685/686/686B Moving to Left/Right Side of Pan Limit for VN-V685/686/686B Setting Auto Flip for VN-V685/686/686B Getting Auto Flip Setting from VN-V685/686/686B Moving to Specified Pan Position for VN-V685/686/686B Setting Direction of Pan Operation for VN-V685/686/686BSetting Speed of Pan Operation for VN-V685/686/686B Getting Pan Position from VN-V685/686/686B Example of Response camera.motion.pan.speed&200 OK Getting Pan Operation Status from VN-V685/686/686BGetting Tilt Position from VN-V685/686/686B Moving to Specified Tilt Position for VN-V685/686/686B Getting Tilt Operation Status from VN-V685/686/686B Setting Direction of Tilt Operation for VN-V685/686/686BSetting Speed of Tilt Operation for VN-V685/686/686B Tilt Operation for VN-V685/686/686B Zoom Operation for VN-V685/686/686B Setting Direction of Zoom Operation for VN-V685/686/686BSetting Speed of Zoom Operation for VN-V685/686/686B Moving to Specified Zoom Position for VN-V685/686/686B Moving Specified Position to Center for VN-V685/686/686B Getting Focus Position from VN-V685/686/686BMoving to Specified Focus Position for VN-V685/686/686B Focus Operation for VN-V685/686/686B Setting Direction of Focus Operation for VN-V685/686/686BSetting Speed of Focus Operation for VN-V685/686/686B Getting Current Preset Position from VN-V685/686/686B Setting Title to Preset Position for VN-V685/686/686B Initialize Preset Position for VN-V685/686/686BMoving to Preset Position for VN-V685/686/686B Getting Title of Preset Position from VN-V685/686/686B Getting Direction of Auto Pan from VN-V685/686/686B Setting Direction of Auto Pan for VN-V685/686/686BGetting Status of Auto Pan from VN-V685/686/686B Start/Stop of Auto Pan for VN-V685/686/686B Format /api/param?camera.motion.autotrace.status Setting Speed of Auto Pan for VN-V685/686/686BGetting Speed of Auto Pan from VN-V685/686/686B Getting Status of Auto Trace from VN-V685/686/686B Start/Stop of Auto Trace for VN-V685/686/686B Start/Stop of Auto Trace Recording for VN-V685/686/686BApi/param?camera.motion.autotrace.record.status=start Getting Status of Auto Patrol from VN-V685/686/686B Auto Patrol Start/Stop of Auto Patrol for VN-V685/686/686B Setting Duarion of Auto Patrol for VN-V685/686/686B Getting Duration of Auto Patrol from VN-V685/686/686BPrivacy Masking Getting Privacy Masking Brightness from VN-V685/686/686B Setting Whole Status of Privacy Masking for VN-V685/686/686B Start/Save Editing of Privacy Masking for VN-V685/686/686B Setting Privacy Masking Brightness for VN-V685/686/686BSetting Width of Privacy Masking Area for VN-V685/686/686B Setting Height of Privacy Masking Area for VN-V685/686/686B Setting Motion Detect to On/Off for VN-V685/686/686B Setting Motion Detect Sensitivity for VN-V685/686/686BGetting Motion Detect Sensitivity from VN-V685/686/686B Setting Motion Detect Mask for VN-V685/686/686B Network Basics Enabling Network Setting ChangesGetting Motion Detect Mask from VN-V685/686/686B Getting IP Address from VN-V685/686/686B Getting Dhcp Setting from VN-V685/686/686BSetting Dhcp for VN-V685/686/686B Setting IP Address for VN-V685/686/686B Getting Subnet Mask from VN-V685/686/686B Setting Subnet Mask for VN-V685/686/686BGetting Default Gateway from VN-V685/686/686B Setting Default Gateway for VN-V685/686/686B Getting DNS Server IP Address from VN-V685/686/686B Setting Host Name for VN-V685/686/686BSetting DNS Server IP Address for VN-V685/686/686B Getting DNS Server On/Off Status from VN-V685/686/686B Getting Global Address of IPv6 from VN-V685/686/686B Setting IPv6 status for VN-V685/686/686BGetting IPv6 status from VN-V685/686/686B Getting Link Local Address of IPv6 from VN-V685/686/686B Setting TOS Value of Jpeg for VN-V685/686/686B Getting MAC Address from VN-V685/686/686BGetting TOS Value of MPEG-4 from VN-V685/686/686B Getting Unicast TTL Value from VN-V685/686/686B Setting TOS Value of MPEG-4 for VN-V685/686/686BSetting Unicast TTL for VN-V685/686/686B Setting Multicast TTL for VN-V685/686/686B Getting MTU Value VN-V685/686/686B Setting MTU Value for VN-V685/686/686BGetting Network Negotiation Setting from VN-V685/686/686B Setting Network Negotiation for VN-V685/686/686B Getting Status of Vsip from VN-V685/686/686B Setting Port Number of Http for VN-V685/686/686BSetting Status of Vsip for VN-V685/686/686B Protocol Getting Port Number of Http from VN-V685/686/686B Setting Port Number of Vsip for VN-V685/686/686B Getting Mode of Jpeg streaming from VN-V685/686BSetting Mode of Jpeg streaming for VN-V685/686B Getting Jpeg Multicast Address from VN-V685/686/686B Getting Jpeg Multicast Port Number from VN-V685/686/686B Setting Jpeg Multicast Address for VN-V685/686/686BSetting Jpeg Multicast Port Number for VN-V685/686/686B Setting Frame Rate of Jpeg Multicast for VN-V685/686/686B Getting MPEG-4 Multicast Address from VN-V685/686/686B Setting MPEG-4 Multicast Address for VN-V685/686/686B Getting MPEG-4 Multicast Port Number from VN-V685/686/686B Setting MPEG-4 Multicast Port Number for VN-V685/686/686B Time Format /api/param?network.accesscontrolstreamout.hostNumberNetwork.accesscontrolstreamout.host1=10.0.0.0/24&200 OK Example /api/param?network.accesscontrolstreamout.host1=%00 Getting On/Off of Sntp Client from VN-V685/686/686B Setting NTP Server Address for VN-V685/686/686BGetting Access Interval to NTP Server from VN-V685/686/686B Setting Access Interval to NTP Server for VN-V685/686/686B Getting Time from VN-V685/686/686B Getting Access Interval Unit of NTP from VN-V685/686/686BSetting Access Interval Unit of Sntp for VN-V685/686/686B Setting Time for VN-V685/686/686B GMT-8 Getting Timezone from VN-V685/686/686B Setting Timezone for VN-V685/686/686B Password Setting Password for VN-V685/686/686BFormat /api/param?system.password.data1=data2 Setting Auto Cleaning for VN-V685/686/686B Maintenance InitializationFirmware Update Getting Status of Auto Cleaning from VN-V685/686/686B Setting Time of Auto Cleaning for VN-V685/686/686B Getting Status Getting Sending StatusFormat /api/param?system.session 100 Getting Settings Getting Model NameGetting Log Getting Firmware Revisions of Streaming Manager Getting Firmware Revisions of Lens Getting Alarm Input Status from VN-V685/686/686BGetting Firmware Revisions of PTZ Controller Getting Firmware Revisions of Image Processor Format /api/param?application.ftp.mode=data Getting Mode of FTP Server from VN-V685/686/686BSetting Mode of FTP Server for VN-V685/686/686B 102 103 List of ActiveX 104 Properties of ActiveX Hhmmss 105 106 Method of ActiveX Control 107 How to use ActiveX Control by Html 108 Html Sample Script 109 110 Form Body Html 111