The radar PTZ camera detects people, vehicles, or objects crossing a
predefined virtual line to trigger line crossing alarm, and some certain actions can be
taken when the alarm is triggered. The crossing direction can be set to bidirectional, from
left to right, or from right to left.
Figure 1 API Calling Flow of
Configuring Radar Line Crossing Alarm
-
Call NET_DVR_STDXMLConfig to transmit /ISAPI/System/capabilities or /ISAPI/Smart/capabilities by GET method for getting device
or smart capability to check.
-
Check whether the device supports radar line crossing detection.
It supports and continue the following steps when the nodes
<isSupporLineDetection> and
<isSupportRadarLineDetection> is returned in
the XML_DeviceCap and their values are "true".
\
-
It supports and continue the following steps when the node
<isSupportLineDetection> is returned in the
XML_SmartCap and its value is "true".
-
It does not support and end this task when neither the XML_DeviceCap nor the XML_SmartCap contains node
<isSupporLineDetection.
- Optional:
Call NET_DVR_STDXMLConfig to transmit /ISAPI/Smart/RadarChannels/<ID>/radarLineDetection/capabilities?format=json by GET method for getting configuration
capability of radar line crossing detection.
-
Call NET_DVR_STDXMLConfig to transmit /ISAPI/Smart/RadarChannels/<ID>/radarLineDetection?format=json by PUT method and set lpInputParam to JSON_RadarLineDetection for setting radar line crossing detection parameters of a
channel.
-
Call NET_DVR_STDXMLConfig to transmit /ISAPI/Smart/RadarChannels/<ID>/radarLineDetection/lineItems/<lineID>?format=json or /ISAPI/Smart/RadarChannels/<ID>/radarLineDetection/lineItems?format=json by PUT method and set lpInputParam to JSON_LineItemInfo or JSON_LineItemList respectively, for setting parameters of one or all detection
line(s).
- Optional:
Call NET_DVR_STDXMLConfig to transmit /ISAPI/Event/channels/<ID>/capabilities or /ISAPI/Event/channels/capabilities by GET method for getting event capability of
one or all channel(s).
-
Call NET_DVR_STDXMLConfig to transmit /ISAPI/Event/schedules/radarLineDetections/<ID> or /ISAPI/Event/schedules/radarLineDetections by PUT method, set
<ID> in the single configuration URI to
"radarLineDetection-<channelID>" (e.g.,
/ISAPI/Event/schedules/radarLineDetections/radarLineDetection-101), and set
lpInputParam to XML_RadarLineDetectionScheduleList or XML_Schedule respectively, for setting arming schedules of one or all
channel(s).
- Optional:
Call NET_DVR_STDXMLConfig to transmit /ISAPI/Event/triggersCap by GET method for getting linkage capability
of radar line crossing alarm.
-
Call NET_DVR_STDXMLConfig to transmit /ISAPI/Event/triggers/<eventType>-<channelID> by PUT method, set
<ID> in the URI to
"radarLineDetection-<channelID>" (e.g.,
/ISAPI/Event/triggers/radarLineDetection-101), and set lpInputParam to XML_EventTrigger for setting linkage action of a radar line crossing alarm.
Note:
To receive alarm in the platform, the linkage action must be
set to "center" (upload to center).
- Optional:
Set lCommand to "COMM_ALARM_RULE" (command
No.: 0x1102) and set wEventTypeEx to
"ENUM_VCA_EVENT_TRAVERSE_PLANE" for receiving radar line crossing alarm in
arming mode (see Receive Alarm/Event in Arming Mode) or listening mode (see Receive Alarm/Event in Listening Mode) when alarm is triggered.
Call NET_DVR_Logout and NET_DVR_Cleanup to log out and release resources.