设备网络SDK开发使用手册


<?xml version="1.0" encoding="utf-8"?>
<!--req, 设备JPEG抓图能力集描述-->
<JpegCaptureAbility version="2.0">
  <!--req,通道号-->
  <channelNO>1</channelNO>
  <FindPicInfo>
    <!--req,对应结构 NET_DVR_FIND_PICTURE_PARAM -->
    <supportFileType  opt= "CMR,MOTION,ALARM,EDR,ALARMANDMOTION,manual,intelligentPic,pir,wlsensor,callhelp,
                      previewScreenshot,facedetection,LineDetection,FieldDetection,scenechangedetection,
                      lockPlaybackScreenshot,INTELLIGENT,regionEntrance,regionExiting,loitering,group,
                      rapidMove,parking,unattendedBaggage,attendedBaggage,VehicleDetection,HvtVehicleDetection,
                      evidence,fireDetection,shipsDetection,thermEarlyWarning,thermAlarm,thermDiffAlarm,
                      faceSnap,thermometryOffLineAlarm,vcaEventGetUp,vcaEventAdvReachHeight,vcaEventToiletTarry,
                      vcaEventSafetyHelmet,allType"/>
    <!--req, 查找的图片类型: 0-定时抓图, 1-移动侦测抓图, 2-报警抓图, 3-报警|移动侦测抓图, 4-报警&移动侦测抓图
    6-手动抓图, 9-智能图片, 10-PIR报警, 11-无线报警, 12-呼救报警, 0xa-预览时截图,0xd-人脸侦测, 0xe-越界侦测,
    0xf-入侵区域侦测, 0x10-场景变更侦测, 0x11-设备本地回放时截图, 0x12-智能侦测, 0x13-进入区域侦测,
    0x14-离开区域侦测, 0x15-徘徊侦测, 0x16-人员聚集侦测, 0x17-快速运动侦测, 0x18-停车侦测, 0x19-物品遗留侦测,
    0x1a-物品拿取侦测, 0x1b-车辆检测, 0x1c-混行检测, 0x1d-取证事件, 0x1d-火点检测, 0x20-船只检测, 
    0x21-测温预警, 0x22-测温报警, 0x23-测差报警, 0x26-离线测温报警, 0x25-人脸抓拍, 0x2a-起身检测, 0x2b-折线攀高, 0x2c-如厕超时, 
    0x2d-安全帽检测,0xff- 全部类型-->

    <enableNeedCard opt="disable,able"/>
    <province opt="1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,0xff"/>
    <!--req, 省份索引-->
    <cardNumberLen min="" max=""/>
    <StartTime>
      <year min="" max=""/>
      <month min="" max=""/>
      <day min="" max=""/>
      <hour min="" max=""/>
      <minute min="" max=""/>
      <second min="" max=""/>
    </StartTime>
    <StopTime>
      <year min="" max=""/>
      <month min="" max=""/>
      <day min="" max=""/>
      <hour min="" max=""/>
      <minute min="" max=""/>
      <second min="" max=""/>
    </StopTime>
    <trafficType opt="license,vehicleType,illegalType"/>
    <vehicleType opt="smallCar,bigCar,bus,truck,car,minibus,smallTruck"/>
    <subHvtType opt="all,motorVehicle,nonMotorVehicle,pedestrian"/>
    <!--req, all-全部,Non-motor Vehicle(非机动车), Motor Vehicle(机动车), Pedestrian(行人)-->
    <illegalType opt="postPic,lowSpeed,highSpeed,retrograde,rushRedLight,pressLane,violateGuide,roadStrand,
               vehicleillegal,roadStand,changeLane,dirveillegalLane,violate,crossParking,greenParking"/>
    <region opt="Res,EU,ER,EUAndCIS,All"/>
    <!--req,区域索引:0-保留,1-欧洲(EU),2-俄罗斯(ER),3-欧洲&俄罗斯(EU&CIS),0xff-所有-->
    <country opt="0,1,2,3,4,5,6,7,8,9,10,11,12,0xfe,0xff "/>
    <!--req 国家索引:0-算法库不支持牌识国家, 1-捷克共和国(CZ - Czech Republic),2-法国(FRA - France),3-德国(DE - Germany),
    4-西班牙(E - Spain),5-意大利(IT - Italy),6-荷兰(NL - Netherlands),7-波兰(PL - Poland),8-斯洛伐克(SVK - Slovakia), 
    9-白俄罗斯(BY - Belorussia),10-摩尔多瓦(MDA - Moldova),11-俄罗斯(RU - Russia),12-乌克兰(UA - Ukraine),13-比利时(BEL - Belgium),
    14-保加利亚,15-丹麦,16-芬兰,17-英国,18-希腊,19-克罗地亚,20-匈牙利,21-以色列,22-卢森堡,23-马其顿共和国,24-挪威,
    25-葡萄牙,26-多马尼亚,27-塞尔维亚,28-阿塞邦疆共和国,29-格鲁吉亚,30-哈萨克斯坦,31-立陶宛共和国,32-土库曼斯坦,
    33-乌兹别克斯坦,34-拉脱维亚,35-爱沙尼亚,36-阿尔巴尼亚,37-奥地利,38-波斯尼亚和黑塞哥维那,39-爱尔兰,40-冰岛,
    41-梵蒂冈,42-马耳他,43-瑞典,44-瑞士,45-塞浦路斯,46-土耳其,47-斯洛文尼亚,0xfe-无法识别,0xff-全部(All)-->
    <licenseLen min="" max=""/>
    <!--opt,车牌号支持最大,最小长度-->
  </FindPicInfo>

  <SmartPicSearchInfo>
    <!--req,对应结构NET_DVR_SMART_SEARCH_PIC_PARA-->
    <supportFileType  opt= "vehicleDetection,faceFeature,facePicData,FieldDetection,unattendedBaggage,attendedBaggage,regionEntrance,
                      regionExiting,parking,loitering,group,rapidMove,allType"/>
    <!--req 0-车辆检索,1-人脸属性,2-人脸图片数据,3-穿越警戒线(越界侦测),4-区域入侵,5-物品遗留,6-物品拿取,7-进入区域,8-离开区域,9-非法停车,
    10-徘徊,11-人员聚集,12-快速移动-->
    <StartTime>
      <year min="" max=""/>
      <month min="" max=""/>
      <day min="" max=""/>
      <hour min="" max=""/>
      <minute min="" max=""/>
      <second min="" max=""/>
    </StartTime>
    <StopTime>
      <year min="" max=""/>
      <month min="" max=""/>
      <day min="" max=""/>
      <hour min="" max=""/>
      <minute min="" max=""/>
      <second min="" max=""/>
    </StopTime>
    <VehicleCond>
      <!--req,支持车辆检索时返回的-->
      <licenseLen min="1" max="16"/>
      <!--req,支持的车牌号长度-->
      <country opt="czech,france,germany,spain,italy,netherlands,poland,slovakia,
               belorussia,moldova,russia,ukraine,canada,us,australia"/>
      <!--req,支持的国家-->
    </VehicleCond>
    <FaceFeature>
      <!--req,人脸属性-->
      <ageGroup opt="infant,child,youngster,adolescent,youth,prime,midlife,midage,old"/>
      <!--req,支持的年龄段范围-->
      <sex opt="man,women"/>
      <withGlasses opt="true,false"/>
      <!--req,是否支持带眼镜-->
    </FaceFeature>
    <FacePicData>
      <!--req,人脸图片数据-->
      <faceScore min="0" max="100"/>
      <!--req,相似度-->
      <picType opt="jpg"/>
      <!--req,支持的图片格式-->
    </FacePicData>
    <isSupportFaceDataAnalysis>
      <!--opt, xs: bool,"true, false",是否支持人脸数据分析,true则支持使用只上传图片ID和坐标的方式进行识别-->
    </isSupportFaceDataAnalysis>
    <isSupportHumanMisinfo>
      <!--opt, xs:boolean,"只获取人体误报信息,支持返回true,不支持不返回"-->
    </isSupportHumanMisinfo>
  </SmartPicSearchInfo>

  <ManualCapture>
    <!--req,手动抓图-->
    <!--req, IPC返回当前支持的分辨率-->
    <ResolutionEntry>
      <!--req, 同级节点可以有多个-->
      <resolutionName>CIF</resolutionName>
      <!--req, xs:string, "CIF"...,分辨率名称-->
      <index>0</index>
      <!--req, xs:inter,该分辨率对应SDK中定义的值-->
    </ResolutionEntry>
    <ResolutionEntry>
      <!--req, 同级节点可以有多个-->
      <resolutionName>4CIF</resolutionName>
      <!--req, xs:string, "4CIF"...,分辨率名称-->
      <index>2</index>
      <!--req, xs:inter,该分辨率对应SDK中定义的值-->
    </ResolutionEntry>
    <picQuality opt="best,better,normal"/>
    <!--图片质量,best-最好,better-较好,normal-一般-->
  </ManualCapture>
  <SchedCapture>
    <!--req,计划抓图-->
    <!--req,以下是抓图配置中对应的参数能力,SDK结构体NET_DVR_JPEG_CAPTURE_CFG-->
    <TimingCap>
      <!--req,定时抓图-->
      <ResolutionEntry>
        <!--req, 同级节点可以有多个-->
        <resolutionName>CIF</resolutionName>
        <!--req, xs:string, "CIF"...,分辨率名称-->
        <index>0</index>
        <!--req, xs:inter,该分辨率对应SDK中定义的值-->
      </ResolutionEntry>
      <ResolutionEntry>
        <!--req, 同级节点可以有多个-->
        <resolutionName>4CIF</resolutionName>
        <!--req, xs:string, "4CIF"...,分辨率名称-->
        <index>2</index>
        <!--req, xs:inter,该分辨率对应SDK中定义的值-->
      </ResolutionEntry>
      <intervalUnit>ms</intervalUnit>
      <!--req,时间间隔单位,s/ms-->
      <interval min="" max="" opt="0"/>
      <!--req, xs:inter,抓拍间隔,可选0表示关闭抓图(没有连续值min和max空,没有可选值opt空,后端前两个空,opt填上)-->
      <!--req,以上是抓图配置中对应的参数能力,SDK结构体NET_DVR_JPEG_CAPTURE_CFG-->
      <!--req,以下是抓图计划配置中对应的参数能力,SDK结构体NET_DVR_SCHED_CAPTURECFG-->
      <RecorderDuration min="" max=""/>
      <!--req,抓图保存天数-->
      <DayCapture>
        <!--req,全天抓图-->
        <captureType opt="timing,motion,alarm,motionOrAlarm,motionAndAlarm,vca,command,thermometryOffLineAlarm "/>
        <!--req,抓图类型-->
      </DayCapture>
      <TimeSlot>
        <!--req,时间段抓图-->
        <slotNum>8</slotNum>
        <!--req,时间段-->
        <captureType opt="timing,motion,alarm,motionOrAlarm,motionAndAlarm,vca,command,thermometryOffLineAlarm "/>
        <!--req,抓图类型-->
      </TimeSlot>
      <HolidayDay>
        <!--req,假日全天抓图-->
        <captureType opt="timing,motion,alarm,motionOrAlarm,motionAndAlarm,vca,command,thermometryOffLineAlarm "/>
        <!--req,抓图类型-->
      </HolidayDay>
      <HolidayTimeSlot>
        <!--req,假日时间段抓图-->
        <slotNum>8</slotNum>
        <!--req,时间段-->
        <captureType opt="timing,motion,alarm,motionOrAlarm,motionAndAlarm,vca,command,thermometryOffLineAlarm "/>
        <!--req,抓图类型-->
      </HolidayTimeSlot>
      <delayTime opt="0,3,4,5,10,30,60,120,300"/>
        <!--抓图延时时间, unit:s -->
      <!--req,以上是抓图计划配置中对应的参数能力,SDK结构体NET_DVR_SCHED_CAPTURECFG-->
    </TimingCap>
    <!--req,以下是抓图配置中对应的参数能力,SDK结构体NET_DVR_JPEG_CAPTURE_CFG-->
    <EventCap>
      <eventType opt="motion,hide,loss,PIR,wireless,callhelp,vca,facedDetect,lineDetection,
                 filedDetection,sceneChangeDetection,regionEntrance,regionExiting,loitering,
                 group,rapidMove,parking,unattendedBaggage,attendedBaggage"/>
      <!--req, xs:string,事件类型-->
      <ResolutionEntry>
        <!--req, 同级节点可以有多个-->
        <resolutionName>CIF</resolutionName>
        <!--req, xs:string, "CIF"...,分辨率名称-->
        <index>0</index>
        <!--req, xs:inter,该分辨率对应SDK中定义的值-->
      </ResolutionEntry>
      <ResolutionEntry>
        <!--req, 同级节点可以有多个-->
        <resolutionName>4CIF</resolutionName>
        <!--req, xs:string, "4CIF"...,分辨率名称-->
        <index>2</index>
        <!--req, xs:inter,该分辨率对应SDK中定义的值-->
      </ResolutionEntry>
      <intervalUnit>ms</intervalUnit>
      <!--req,时间间隔单位,s/ms-->
      <interval min="" max="" opt="0"/>
      <!--req, xs:inter,抓拍间隔,可选0表示关闭抓图(没有连续值min和max空,没有可选值opt空,后端前两个空,opt填上)-->
      <capTimes min="" max=""/>
      <!--req, xs:inter,抓拍张数-->
      <eventCapChan opt="1,2"/>
      <!--req, xs:inter,事件可触发抓拍的通道号列举-->
      <alarmInCapChan opt="1,2"/>
      <!--req, xs:inter,报警输入可触发抓拍的通道号列举-->
    </EventCap>
    <!--req,以上是抓图配置中对应的参数能力,SDK结构体NET_DVR_JPEG_CAPTURE_CFG-->
    <AdvancedParam>
      <!--opt,"抓图高级参数配置"-->
      <streamType opt="0-mainstream,1-substream,2-stream3,3-stream4,4-stream5">
        <!--opt,xs:string, 码流类型-->
      </streamType>
    </AdvancedParam>
  </SchedCapture>
  <PromptDescription>
    <prompt1>true</prompt1>
    <!--opt,支持就返回,不支持不返回,上层判断节点存在-->
  </PromptDescription>
  <CapturePicture>
    <!--opt,抓图能力,对应接口NET_DVR_CapturePicture_V50-->
    <Resolution>
      <!--req,支持分辨率-->
      <value opt="500-384*288"/>
    </Resolution>
    <picQuality opt="best,good,normal"/>
    <!--req,图片质量系数:0-最好,1-较好,2-一般-->
    <picFormat opt="0-Jpeg"/>
    <!--req,设备抓图图片格式:0- JPEG-->
    <picType opt="normal,calibPanoramicPic,calibPanoramicPicinFlash"/>
    <!--req,设备抓图类型:normal-设备通用抓图,calibPanoramicPic-鹰眼标定图片(FPJA重启刷新获取图片,需要时间较长,最长超时3分钟),calibPanoramicPicinFlash-从Flash中获取已存在鹰眼标定图片-->   
  </CapturePicture>
</JpegCaptureAbility>