设备网络SDK开发使用手册


<?xml version="1.0" encoding="utf-8"?>
<!--req, 设备图像参数能力集描述 -->
<VideoPicAbility version="2.0">
  <channelNO>1</channelNO>
  <OSD>
    <ChannelName>
      <enabled>true</enabled>
    </ChannelName>
    <Week>
      <enabled>true</enabled>
    </Week>
    <OSDType opt="xxxx-xx-xxYMD,xx-xx-xxxxMDY,xxxxYxxMxxD,xxMxxDxxxxY,xx-xx-xxxxDMY,xxDxxMxxxxY,xx/xx/xxxxM/D/Y,xxxx/xx/xxY/M/D,xx/xx/xxxxD/M/Y "/>
    <!--req,OSD属性(索引值), 1-透明,闪烁,2-透明,不闪烁,3-不透明,闪烁,4-不透明,不闪烁-->
    <OSDAttrib opt="1,2,3,4"/>
    <OSDHourType opt="24Hour,12Hour"/>
    <FontSize opt="16*16,24*24,32*32,48*48,64*64,96*96,adaptive"/>
    <!--req,OSD字体大小:0-16*16(中)/8*16(英),1-32*32(中)/16*32(英),2-64*64(中)/32*64(英),
        3-48*48(中)/24*48(英),4-24*24(中)/12*24(英),5-96*96(中)/48*96(英),0xff-自适应(adaptive) -->
    <OSDColorType opt="0,1"/>
    <!--req,0-默认黑白颜色,1-自定义颜色-->
    <OSDColorRGB>true</OSDColorRGB><!--req,支持OSD颜色设置-->
    <alignment opt="customize,alignRight,alignLeft,GB"/>
    <!--req,OSD支持对齐方式:customize-自适应,alignRight-右对齐,alignLeft-左对齐,GB-国标模式-->
    <OSDMilliSecond>true</OSDMilliSecond>
    <!--req,视频叠加时间支持毫秒-->
    <OSDCharactersNum>32</OSDCharactersNum>
    <!--opt, xs:integer, OSD字符叠加长度限制-->
    <ChannelNumOverlySize min="0" max="30">
      <!--opt, xs:integer, 通道名称长度限制-->
    </ChannelNumOverlySize>
    <boundary min="" max="">
      <!--opt,xs:integer, OSD左右对齐时的边界值范围-->
    </boundary>
    <lowRightTextNumber min="1" max="6"/>
    <lowLeftTextNumber min="7" max="8"/>
    <boudaryOptionShow opt="no,oneFont,twoFont">
      <!--opt,xs:string, 边界值选项显示能力,分别为无、一个字符宽度、二个字符宽度。
      该能力只为界面显示使用,具体配置的值依然通过boudary字段进行传输,因此设备必须返回<boudaryOptionShow>以及<boudary>两个能力节点。
      界面选择会根据选择的字符大小,动态发送边界值,若字符大小选择的是2-64*64(中),twoFont就表示偏移两个字符宽度,boudary中应当赋值为128-->
    </boudaryOptionShow>
  </OSD>
  <MotionDetection>
    <!--req,移动侦测-->
    <regionType opt="grid,area,coordinates"/>
    <!--req, 网格模式(普通模式), 区域模式(专家模式), 坐标系区域模式-->
    <Grid>
      <VideoFormatP>
        <!--req,P制式宏块-->
        <rowGranularity>18</rowGranularity>
        <columnGranularity>22</columnGranularity>
      </VideoFormatP>
      <VideoFormatN>
        <!--req,N制式宏块-->
        <rowGranularity>15</rowGranularity>
        <columnGranularity>22</columnGranularity>
      </VideoFormatN>
    </Grid>
    <Area>
      <areaNo min="1" max="8"/>
      <!--req, 区域号-->
      <switchDayNightSet opt="off,autoSwitch,scheduleSwitch"/>
      <!--req, 日夜控制 0~关闭,1~自动切换,2~定时切换-->
      <Off>
        <objectAreaProportion min="0" max="100"/>
        <!--req, 占比参数(0~100)-->
        <sensitivityLevel min="1" max="100"/>
        <!--req,灵敏度(1~100)-->
      </Off>
      <AutoSwitch>
        <supportType opt="day,night"/>
        <!--req,支持工作模式-->
        <dayObjectAreaProportion min="0" max="100"/>
        <!--req 占比参数(0~100)-->
        <daySensitivityLevel min="1" max="100"/>
        <!--req,灵敏度(1~100)-->
        <nightObjectAreaProportion min="0" max="100"/>
        <!--req 占比参数(0~100)-->
        <nightSensitivityLevel min="1" max="100"/>
        <!--req,灵敏度(1~100)-->
      </AutoSwitch>
      <ScheduleSwitch>
        <supportType  opt="day,night"/>
        <!--req,支持工作模式-->
        <dayObjectAreaProportion min="0" max="100"/>
        <!--req 占比参数(0~100)-->
        <daySensitivityLevel min="1" max="100"/>
        <!--req,灵敏度(1~100)-->
        <nightObjectAreaProportion min="0" max="100"/>
        <!--req 占比参数(0~100)-->
        <nightSensitivityLevel min="1" max="100"/>
        <!--req,灵敏度(1~100)-->
        <TimeSchedule>
          <beginTime opt="hour,min,sec,millisec"/>
          <!--req,开始时间段类型-->
          <endTime opt="hour,min,sec,millisec"/>
          <!--req 结束时间段类型-->
        </TimeSchedule>
      </ScheduleSwitch>
    </Area>   
    <sensitivityLevel min="0" max="5"/>
    <!--req,灵敏度-->
    <Sensitivity>
      <!--req,新增灵敏度节点,兼容之前客户端写死加1出现的问题 -->
      <notSupportOff>true</notSupportOff>
      <!--req,不支持关闭灵敏度,支持关闭时不返回该节点-->
      <level min="1" max="5"/>
      <!--req,灵敏度级别,客户端不要进行加1处理-->
    </Sensitivity>

    <NormalSensitivity>
      <!--req ipc V5.1.0 增加-->
      <level min="0" max="5"/>
      <step>20</step>
      <!--req, 步进-->
      <offStatus>true</offStatus>
      <!--req,关闭状态-->
    </NormalSensitivity>
    <alarmTime>8</alarmTime>
    <!--req,布防时间段个数-->
    <alarmHandleType opt="monitor,audio,center,alarmout,picture,wirelesslight,uploadftp,uploadcloud"/>
    <!--req,处理类型-->
    <displayMotion opt="true,false"/>
    <!--req,启用移动侦测高亮显示,0-否,1-是-->
    <Coordinates>
      <!--opt, 移动侦测坐标系区域模式, 后端3.4.8项目支持-->
      <normalizedScreenSize>
        <!--req, ro ,"区域参照值"-->
        <normalizedScreenWidth>
          <!--opt, ro,xs:integer, 归一化值宽度-->
        </normalizedScreenWidth>
        <normalizedScreenHeight>
          <!--opt, ro,xs:integer, 归一化值高度-->
        </normalizedScreenHeight>
      </normalizedScreenSize>
      <supportRegionNum size=""/>
      <!--req, "支持区域的个数范围"-->
    </Coordinates>
    <alarmRelateAct opt="ftp,email"/>
    <!--req, 报警联动动作:ftp- 抓图上传FTP, email- Jpeg抓图上传Email-->
    <isSupportKeyingEnable>true</isSupportKeyingEnable>
    <!--opt, 支持的返回该节点,不支持的不返回,"键控移动侦测开启能力"-->
  </MotionDetection>
  <VILostDetection>
    <!--req,视频丢失-->
    <alarmTime>8</alarmTime>
    <!--req,布防时间段个数-->
    <alarmHandleType opt="monitor,audio,center,alarmout,picture,wirelesslight,uploadftp,uploadcloud"/>
    <!--req,处理类型-->
    <alarmRelateAct opt="ftp,email"/>
    <!--req, 报警联动动作:ftp- 抓图上传FTP, email- Jpeg抓图上传Email-->
  </VILostDetection>
  <HideDetection>
    <!--req,遮挡报警-->
    <HideAreaNum>1</HideAreaNum>
    <!--req,遮挡区域个数-->
    <HideArea>
      <id>1</id>
      <PAL>
        <AreaX min="0" max="704"/>
        <AreaY min="0" max="576"/>
      </PAL>
      <NTSC>
        <AreaX min="0" max="704"/>
        <AreaY min="0" max="480"/>
      </NTSC>
    </HideArea>
    <sensitivity opt="none,low,middle,high"/>
    <!--req,灵敏度-->
    <alarmTime>4</alarmTime>
    <!--req,布防时间段个数-->
    <alarmHandleType opt="monitor,audio,center,alarmout,picture,wirelesslight,uploadftp,uploadcloud"/>
    <!--req,处理类型-->
    <alarmRelateAct opt="ftp,email"/>
    <!--req, 报警联动动作:ftp- 抓图上传FTP, email- Jpeg抓图上传Email-->
  </HideDetection>
  <PrivacyMask>
    <!--req,隐私遮蔽-->
    <PrivacyMaskAreaNum>1</PrivacyMaskAreaNum>
    <!--req,隐私遮蔽区域个数-->
    <PrivacyMaskArea>
      <id>1</id>
      <PAL>
        <AreaX min="0" max="704"/>
        <AreaY min="0" max="576"/>
      </PAL>
      <NTSC>
        <AreaX min="0" max="704"/>
        <AreaY min="0" max="480"/>
      </NTSC>
    </PrivacyMaskArea>
  </PrivacyMask>
  <VideoInputEffect>
    <!--req,通道视频输入图像参数,对应SDK配置结构NET_DVR_VIDEO_INPUT_EFFECT-->
    <mode opt="standard,mode1,mode2,mode3,selfDefine"/>
    <!--req,模式,0-标准,1-预置模式1,2-预置模式2,3-预置模式3,255-自定义-->
    <bright min="0" max="255"/>
    <!--req,亮度-->
    <contrast min="0" max="255" />
    <!--req,对比度-->
    <saturation min="0" max="255"/>
    <!--req,饱和度-->
    <hue min="0" max="255"/>
    <!--req,色度-->
    <sharpness min="0" max="255"/>
    <!--req,锐度-->
    <denoising min="0" max="255"/>
    <!--req,去噪-->
    <NotSupport opt="true, false"/>
    <!--req, true表示不支持VideoInputEffect,false表示支持VideoInputEffect-->
  </VideoInputEffect>
  <LogoOverlay>
    <!--req,视频LOGO叠加-->
    <!--2012-08-29-->
    <logoFormat opt="yuv,bmp"/>
    <!--req,logo图片格式-->
    <logoWidth min="" max=""/>
    <!--req,logo图片宽-->
    <logoHeight min="" max=""/>
    <!--req,logo图片高-->
  </LogoOverlay>
  <PicAdjust>
    <!--req,支持图像调整,不支持不显示-->
    <leftAdjustParam min="" max=""/>
    <!--req,向左调整参数取值范围-->
    <rightAdjustParam min="" max=""/>
    <!--req,向右调整参数取值范围-->
    <upAdjustParam min="" max=""/>
    <!--req,向上调整参数取值范围-->
    <downAdjustParam min="" max=""/>
    <!--req,向下调整参数取值范围-->
    <autoAdjust>enable</autoAdjust>
    <!--req,支持自动调整图像-->
    <heightAdjustParam min="" max=""/>
    <!--req,高度调整参数取值范围-->
    <widthAdjustParam min="" max=""/>
    <!--req,宽度调整参数取值范围-->
  </PicAdjust>  
</VideoPicAbility>