Configure Auto Person Arming

The auto person arming is to enable device to track and capture targets automatically according to the configured rules. You should configure face picture libraries, human body picture libraries, auto person arming rules, and linkage actions to realize device auto person arming.

  • Make sure you have created and configure face picture libraries. Refer to Configure Face Picture Library.

  • Make sure you have created and configured human body picture libraries. See Create Human Body Picture Library and Manage Records in Human Body Picture Library for details.

Figure 1 API Calling Flow of Configuring Auto Person Arming
Note:

For integration via Device Network SDK, the related text protocol data should be transmitted by the specific API (i.e., NET_DVR_STDXMLConfig) to realize the applications. Refer to Integrate by Transmitting Text Protocol for details.

  1. Call /ISAPI/System/capabilities by GET method to get the device capability to check whether the device supports auto person arming.
    • If the node <isSupportPersonArmingTrack> exists in the returned device capability XML_DeviceCap, and its value is true, perform the following steps to continue.

    • Otherwise, end this task as the auto person arming is not supported.

  2. Call /ISAPI/Intelligent/channels/<ID>/personArmingTrack/capabilities?format=json by GET method to get configuration capability of auto person arming.

    The configuration capability is returned in the message JSON_PersonArmingTrackCap.

  3. Call /ISAPI/Intelligent/channels/<ID>/personArmingTrack?format=json by PUT method to set the auto person arming rules.
    Note:

    Before setting the auto person arming rules, you'd better call above URI by GET method to get the existing configurations for reference.

  4. Optional: Configure the advanced parameters of auto person arming.
    Note:

    Before configuring advanced parameters, you should check whether the device supports the function. If the node isSupportAdvanceConfiguration exists in the capability JSON_PersonArmingTrackCap and its value is true, you can perform following steps.

    1. Call /ISAPI/Intelligent/channels/<ID>/personArmingTrack/advanceConfiguration/capabilities?format=json by GET method to get the configuration capability of person arming advanced parameters.

      The configuration capability is returned in the message JSON_AdvanceConfigurationCap.

    2. Call /ISAPI/Intelligent/channels/<ID>/personArmingTrack/advanceConfiguration?format=json by PUT method to set the person arming advanced parameters.
      Note:

      Before setting, you'd better call the URI by GET method to get the existing configuration for reference.

  5. Call /ISAPI/Event/triggersCap by GET method to get the linkage action capability to check whether human body picture library and face picture library support setting linkage action.
    • If the capability XML_EventTriggersCap is returned, and the nodes <HBDLibTriggerCap> and <FaceLibTriggerCap> exist in the capability, perform the following steps.

    • If getting capability XML_EventTriggersCap failed, or the nodes <HBDLibTriggerCap> and <FaceLibTriggerCap> do not exist in the capability, end the task as setting linkage actions for human body picture library and face picture library is not supported.

  6. Perform the following operations to set arming schedule and linkage actions for human body picture library and face picture library.
    Option Description

    Set Arming Schedule of Human Body Picture Library

    PUT /ISAPI/Event/schedules/HBDLib-<ID>/<HBDID>

    Set Arming Schedule of Face Picture Library

    PUT /ISAPI/Event/schedules/faceLib/<ID>/<FDID>

    Set Linkage Actions of Human Body Picture Library

    PUT /ISAPI/Event/triggers/HBDLib-<ID>/<HBDID>

    Set Linkage Actions of Face Picture Library

    PUT /ISAPI/Event/triggers/faceLib-<channelID>/<FDID>

  7. Optional: Call /ISAPI/Intelligent/channels/<ID>/restoreAlgLibParam/<NAME> by GET method to restore the algorithm library parameters to default.