Configure Region Exiting 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 region exiting 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 Region Exiting 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 region exiting detection is supported.

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

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

    Otherwise, the region exiting detection is not supported by device, please end this task.

  5. Configure region exiting 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 region exiting detection rule capability.

      The region exiting 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 region exiting detection rule for reference.

      The region exiting 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 region exiting detection rule of a specific detection scene.
  6. Configure alarm linkage for the region exiting 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 region exiting alarm linkage parameters for reference.

      The region exiting 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 region exiting 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 region exiting 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 region exiting 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 region exiting 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.