Configure Line Crossing Alarm for Intelligent Device

For intelligent device, you should configure the analysis engine of device first, and then set rule, arming schedule, alarm linkage for a specific detection scene that may trigger line crossing alarm.

  • Make sure you have called NET_DVR_Init to initialize the development environment.

  • Make sure you have called NET_DVR_Login_V40 to log in to the device.

Figure 1 Programming Flow of Configuring Line Crossing Alarm for Intelligent Device

  1. Call NET_DVR_STDXMLConfig to pass through the request URL: GET /ISAPI/System/capabilities for getting the device capability to check if the analysis engine configuration is supported.

    The device capability is returned in the message XML_DeviceCap by output parameter pointer (lpOutputParam).

    If the node <isSupportIntelligentAnalysisEngines> is returned in the message and its value is "true", it indicates that analysis engine configuration is supported, you can continue to perform this step.

    Otherwise, the analysis engine configuration is not supported by device, please end this task.

  2. Optional: Call NET_DVR_STDXMLConfig to pass through the request URL: GET /ISAPI/Intelligent/analysisEngines/<ID> for getting default or configured analysis engine parameters for reference.

    The analysis engine parameters is returned in the message XML_AnalysisEngine by output parameter pointer (lpOutputParam).

  3. Call NET_DVR_STDXMLConfig to pass through the request URL: PUT /ISAPI/Intelligent/analysisEngines/<ID>, and set input parameter pointer (lpInputParam) to XML_AnalysisEngine for setting the analysis engine parameters.
  4. Call NET_DVR_STDXMLConfig to pass through the request URL: GET /ISAPI/Intelligent/channels/<ID>/capabilities for getting intelligent channel capability to check if line crossing detection is supported.

    The intelligent channel capability is returned in the message XML_IntelliCap by output parameter pointer (lpOutputParam).

    If the node <isLineDetectionSupport> is returned in the message and its value is "true", it indicates that line crossing detection is supported, you can continue to perform this step.

    Otherwise, the line crossing detection is not supported by device, please end this task.

  5. Configure line crossing detection rule for a detection scene by channel.
    1. Optional: Call NET_DVR_STDXMLConfig to pass through the request URL: GET /ISAPI/Intelligent/channels/<ID>/behaviorRule/capabilities for getting the line crossing detection rule capability.

      The line crossing detection rule capability is returned in the message XML_Cap_RuleInfo by output parameter pointer (lpOutputParam).

    2. Optional: Call NET_DVR_STDXMLConfig to pass through the request URL: GET /ISAPI/Intelligent/channels/<ID>/behaviorRule/<SID> for getting default or configured line crossing detection rule for reference.

      The line crossing detection rule parameters are returned in the message XML_RuleInfo by output parameter pointer (lpOutputParam).

    3. Call NET_DVR_STDXMLConfig to pass through the request URL: PUT /ISAPI/Intelligent/channels/<ID>/behaviorRule/<SID>, and set input parameter pointer (lpInputParam) to XML_RuleInfo for setting the line crossing detection rule of a specific detection scene.
  6. Configure alarm linkage for the line crossing detection of a detection scene by channel.
    1. Optional: Call NET_DVR_STDXMLConfig to pass through the request URL: GET /ISAPI/Intelligent/channels/<ID>/behaviorRule/<SID>/notifications for getting default or configured line crossing alarm linkage parameters for reference.

      The line crossing alarm linkage parameters are returned in the message XML_RuleNotification by output parameter pointer (lpOutputParam).

    2. Call NET_DVR_STDXMLConfig to pass through the request URL: PUT /ISAPI/Intelligent/channels/<ID>/behaviorRule/<SID>/notifications, and set input parameter pointer (lpInputParam) to XML_RuleNotification for setting the line crossing alarm linkage of a specific detection scene.
    Note:

    To receive the alarm in the platform, the linkage action must be set to "center" (upload to center).

  7. Configure arming schedule for the line crossing detection of a detection scene by channel.
    1. Optional: Call NET_DVR_STDXMLConfig to pass through the request URL: GET /ISAPI/Intelligent/channels/<ID>/behaviorRule/<SID>/schedules for getting default or configured line crossing arming schedule for reference.

      The arming schedule are returned in the message XML_RuleSchedule by output parameter pointer (lpOutputParam).

    2. Call NET_DVR_STDXMLConfig to pass through the request URL: PUT /ISAPI/Intelligent/channels/<ID>/behaviorRule/<SID>/schedules, and set input parameter pointer (lpInputParam) to XML_RuleSchedule for setting arming schedule of a specific detection scene.

Note:

The above rules, arming schedule, and alarm linkage can also be configured by logging in to device via web browser.

  1. Optional: Receive 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.
    Note:

Call NET_DVR_Logout and NET_DVR_Cleanup to log out and release resources.