Range

Function

This API is used to get Alarm > Face Detection parameter range.

Request Message

Parameter Description

Table 1
ParameterRangeTypeDescription
channel"CH1"…"CHx",
"IP_CH1"…"IP_CHx",
"WIFI_CH1"…"WIFI_CHx"
The channels supported by the device.
string arrayIPC can only Use "CH1".
page_type"ChannelConfig", "AlarmConfig"stringIt is used to distinguish the data of channel configuration page or alarm configuration page.

Sample:

POST /API/AlarmConfig/Intelligent/FD/Range HTTP/1.1
{
    "version": "1.0",
    "data": {}
}

Response Message

Parameter Description

Table 2
ParameterRangeTypeDescription
channel_infoobjectTotal channel information see Table 3.
channel_maxintThe maximum number of channels.
support_copyboolWhether to support copy.
agreed_to_agreementboolAgreed to the agreement.
statement_file_namestring length:1-48stringprotocol file name.
Table 3
ParameterRangeTypeDescription
CH1objectSee Table 4
object
IP_CH1object
object
WIFI_CH1object
object
Table 4
ParameterRangeTypeDescription
status"Offline","Online","Nonsupport"stringOnline status of the channel, only for digital channels. Note: When the channel is online, there is no such field.
alarm_out"Local->1"…"Local->x"
"IP_CH1->1"…"IP_CHx->x"
The number of channels depends on the function of the device.
string arrayalarm Output channel.
Array members use a string to represent an alarm output channel.
Local->1: open, empty value: close.
latch_time"10","20","40","60"string arrayAlarm output time, IPC: 5 10 20 30
record_enabletrue, falseboolChannel recording switch.
record_channel"CH1"…"CHx"
"IP_CH1"…"IP_CHx"
"WIFI_CH1"…"WIFI_CHx"
string arrayChannel of linkage recording.
post_recording"30","60","120","300"stringRecording delay time, IPC: 0 5 10 20 30.
send_emailtrue, falseboolSend Email switch.
ftp_picture_uploadtrue, falseboolChannel snapshot FTP upload switch (for NVR only).
ftp_video_uploadtrue, falseboolChannel video FTP upload switch (for NVR only).
picture_to_cloudtrue, falseboolPicture upload switch (for NVR only).
video_to_cloudtrue, falseboolVideo cloud upload switch (for NVR only).
full_screenboolFullScreen switch (for NVR only).
buzzer"0","10","20","40","60"stringBuzzer buzzing time (for NVR only).
show_messageboolShow Message switch (for NVR only).
switchtrue, falsebool
is_ai_paramboolUsed to distinguish between ordinary face detection and deep learning face detection (NVR dedicated).
face_enhancetrue, falseboolface enhance switch
detection_mode"StaticMode"
"MotionMode"
string
snap_mode"RealTimeMode"
"OptimalMode"
"IntervalMode"
string
apply_mode"FrontalView"
"MultiAngle"
"Customize"
string
min_pixel32-1080int
max_pixel320-1080int
iva_lines0,1intSet whether the line should appear during preview and playback, 0:no, 1:yes.
rule_infoobjectSee Table 5 for details.
voice_prompts_index0~4294967295intFile index (0~4294967295, 0 means None, that is, no audio file is selected). Each file is named as "index_filename" (1_i will try), on the page When displaying, "index_" should be hidden, such as "1_i will try", and only "i will try" will be displayed.
voice_prompts_selectsize: 0-12int arrayPlaying channel, calculated by bit (bit0 is local, bit1 corresponds to front channel 1, bit2 corresponds to channel 2...).
voice_prompts_timesize: 0-12object arraytime period.
copy_ch"digit", "analog", "wifi"stringSupport channel copy flag (for NVR and DVR only).
snap_num"1"
"2"
"3"
"Unlimited"
stringNumber of screenshots
snap_frequencyintScreenshot interval, unit s/pic
http_listeningboolhttp event push
roll_range0-180intThe following default value fields are only available in Range:
"default_value_frontal": frontal default value for mode
"default_value_multi":multi default value for mode
pitch_range0-180intThe following default value fields are only available in Range:
"default_value_frontal": frontal default value for mode
"default_value_multi":multi default value for mode
yaw_range0-180intThe following default value fields are only available in Range:
"default_value_frontal": frontal default value for mode
"default_value_multi":multi default value for mode
picture_quality0-100intThe following default value fields are only available in Range:
"default_value_frontal": frontal default value for mode
"default_value_multi":multi default value for mode
Table 5
ParameterRangeTypeDescription
rule_number1objectRule number 1,information JSON show as follow Table Table 6
Table 6
ParameterRangeTypeDescription
rule_switchbool
rule_type"Normal","A->B","B->A"string
rule_kind"Rect", "Line"string
detection_range"FullScreen", "Customize"string
rule_rectobjectRectangle,information JSON show as follow Table Table 7
rule_lineobjectLine,information JSON show as follow Table Table 8
Table 7
ParameterRangeTypeDescription
x10-704shortx1 Coordinate points。
y10-576shorty1 Coordinate points。
x20-704shortx2 Coordinate points。
y20-576shorty2 Coordinate points。
x30-704shortx3 Coordinate points。
y30-576shorty3 Coordinate points。
x40-704shortx4 Coordinate points。
y40-576shorty4 Coordinate points。
Table 8
ParameterRangeTypeDescription
x10-704shortx1 Coordinate points。
y10-576shorty1 Coordinate points。
x20-704shortx2 Coordinate points。
y20-576shorty2 Coordinate points。

Sample:

HTTP/1.1 200 OK
Content-Type: application/json
{
    "result": "success",
    "data": {
        "channel_max": 16,
        "support_copy": true,
        "agreed_to_agreement": {
            "type": "bool"
        },
        "statement_file_name": {
            "type": "string",
            "min_len": 1,
            "max_len": 48
        },
        "channel_info": {
            "type": "object",
            "items": {
                "CH9": {
                    "type": "object",
                    "items": {
                        "status": {
                            "description": "Only offline channel has this variable.",
                            "type": "string",
                            "mode": "r",
                            "items": [
                                "Offline",
                                "Online",
                                "NotSupport"
                            ]
                        },
                        "buzzer": {
                            "type": "string",
                            "items": [
                                "0",
                                "10",
                                "20",
                                "40",
                                "60"
                            ]
                        },
                        "alarm_out": {
                            "type": "array",
                            "min_size": 0,
                            "max_size": 33,
                            "items": {
                                "type": "string",
                                "items": [
                                    "Local->1",
                                    "IP_CH9->1"
                                ]
                            }
                        },
                        "latch_time": {
                            "type": "string",
                            "items": [
                                "10",
                                "20",
                                "40",
                                "60"
                            ]
                        },
                        "record_enable": {
                            "type": "bool"
                        },
                        "record_channel": {
                            "type": "array",
                            "min_size": 0,
                            "max_size": 16,
                            "items": {
                                "type": "string",
                                "items": [
                                    "CH1",
                                    "CH2",
                                    "CH3",
                                    "CH4",
                                    "CH5",
                                    "CH6",
                                    "CH7",
                                    "CH8",
                                    "CH9",
                                    "CH10",
                                    "CH11",
                                    "CH12",
                                    "CH13",
                                    "CH14",
                                    "CH15",
                                    "CH16"
                                ]
                            }
                        },
                        "post_recording": {
                            "type": "string",
                            "items": [
                                "30",
                                "60",
                                "120",
                                "300"
                            ]
                        },
                        "show_message": {
                            "type": "bool"
                        },
                        "send_email": {
                            "type": "bool"
                        },
                        "full_screen": {
                            "type": "bool"
                        },
                        "http_listening": {
                            "type": "bool"
                        },
                        "ftp_picture_upload": {
                            "type": "bool"
                        },
                        "ftp_video_upload": {
                            "type": "bool"
                        },
                        "picture_to_cloud": {
                            "type": "bool"
                        },
                        "video_to_cloud": {
                            "type": "bool"
                        },
                        "voice_prompts_index": {
                            "type": "array",
                            "min_size": 0,
                            "max_size": 12,
                            "items": []
                        },
                        "voice_prompts_select": {
                            "type": "array",
                            "min_size": 0,
                            "max_size": 12,
                            "items": []
                        },
                        "voice_prompts_time": {
                            "type": "array",
                            "min_size": 0,
                            "max_size": 12,
                            "items": []
                        },
                        "copy_ch": {
                            "type": "string",
                            "items": [
                                "digit",
                                "analog",
                                "wifi",
                                "local",
                                "all"
                            ]
                        }
                    }
                }
            }
        }
    }
}

Error Code

See Response Messages Body and Common error_code for more information.