Android取流播放获取资源SDK使用说明书

AndroidSDK使用说明文档目录一.文档阅读说明.......................................................................................................................3二.SDK内容说明.....................................................................................................................3三.3.0SDK使用说明.................................................................................................................3(1)登录流程:.............................................................................................................................4(2)获取资源流程：..................................................................................................................4(3)获取设备信息....................................................................................................................5(4)获取播放地址....................................................................................................................6(6)远程回放查询接口..............................................................................................................6(7)获取的监控点主要作用如下图所示：..............................................................................7四.2.0SDK使用说明.............................................................................................................10一.文档阅读说明非常感谢您选购我们公司的产品，申请我们的SDK进行二次开发。温馨的提醒您在开发前请您对整个说明文档进行仔细阅读，以便整体的了解开发流程。二.SDK内容说明该文档主要针对手机客户端iVMS-5060取流播放SDK进行说明，文档介绍区分手机客户端2.0和3.0版本。2个版本的SDK区分如下：功能2.0SDK3.0SDK取流方式支持MAG支持MAG、VTDU(区分主子码流)资源获取方式通过WebView加载平台返回的URL(平台实现，手机客户端只需要实现webview相关内容)通过VmsNetSDK.jar网络库进行获取资源(需要在手机客户端实现)是否支持远程回放否是以上是2.0SDK和3.0SDK的主要区别，开发者可以根据平台目前支持的手机客户端版本进行选择，如果该平台支持手机客户端iVMS-5060V2.0系列版本，则需要使用2.0版本的SDK，如果该平台支持手机客户端iVMS-5060V3.0系列版本，则需要使用3.0版本的SDK。具体平台支持哪个版本的手机客户端，需要咨询平台相关开发人员。三.3.0SDK使用说明系统框架图如图3-1所示：中心管理服务流媒体服务云台控制服务海康平台手机客户端V3.0ABC图3-13.0手机客户端与平台系统架构图(1)登录流程:首先要获取线路也就是调用getLineList接口其次调用登录接口login接口，该接口中会用到getLineList接口中返回的线路(具体参考SDKdemo中相关接口注释)(2)获取资源流程：获取资源流程，用到的接口有5个getControlUnitList：获取控制中心的列表getRegionListFromCtrlUnit：从控制中心中获取区域列表getRegionListFromRegion：从区域获取区域列表getCameraListFromCtrlUnit：从控制中心获取监控点列表getCameraListFromRegion：从区域获取监控点列表以上各个接口的参数说明参考SDKdemo中相关接口注释。流程如下：首先获取根目录下的资源信息，根目录也就是控制中心，所以需要调用如下接口控制中心如图3-2所示图3-2获取根目录下的资源信息1.getControlUnitList2.getRegionListFromCtrlUnit3.getCameraListFromCtrlUnit以上接口调用完成后，展示的数据是根目录下所有的控制中心、区域和监控点。当需要获取根目录下控制中心下的数据时，同样需要调用以上3个接口。注：只要是获取控制中心下的数据，都需要调用以上3个接口。当需要获取区域下数据时，需要调用如下接口，区域展示如图3-3所示：图3-3获取控制中心下资源1.getRegionListFromRegion2.getCameraListFromRegion以上接口调用完成后，展示出该区域下所有的区域和监控点注：只要是获取区域下的数据，都需要调用以上接口。客户可以根据实际情况将资源列表做成树形结构或者是目前我们手机客户端3.0版本展示的方式(如果层次过深，建议采用我们手机客户端的展示方式)。(3)获取设备信息3.0SDK可以通过平台获取设备信息：getDeviceInfo调用该接口需要平台地址，登录成功的会话ID(登录成功接口中获取)、监控点ID(资源获取到的监控点对象的一个属性ID)、设备ID(资源获取到的监控点对象的一个属性ID)，、返回设备信息的对象(该对象是一个类似指针形式的对象)。设备信息包含以下内容设备名称、设备编号、设备IP、设备端口、登录设备的用户名(这个是登录设备的用户名，并不是登录平台的用户名)、登录设备的密码(这个是登录设备的密码，并不是登录平台的密码，和登录设备用户名对应)、设备类型、设备供应商等。(4)获取播放地址3.0SDK获取播放地址是通过以下接口实现的getRealPlayURL调用该接口需要平台地址、登录成功的会话ID(登录成功接口中获取)、监控点ID(资源获取到的监控点对象的一个属性ID)、码流类型、返回播放地址的对象(该对象是一个类似指针形式的对象)。对于码流类型，如果传入0，在返回的播放地址对象中url1表示主码流，url2表示MAG；如果传入1，在返回的播放地址对象中url1表示子码流，url2表示MAG。开发者可以根据需要选择对象的码流(清晰度以主码流最为清晰，流畅度以MAG最为流畅)。(5)云台接口云台接口采用的是UDP协议，只负责发送，接口如下sendStartPTZCmd调用该接口需要的参数有：云台服务器地址(可以从监控点对象中获取，不需要修改)、云台服务器端口(可以从监控点对象中获取，不需要修改)、登录成功后的会话ID、监控点ID、云台命令(int)、速度。以上参数的具体说明和使用可以参考SDKDemo中接口说明常用云台命令介绍如下：1-云台转上2-云台转下3-云台转左4-云台转右11-云台左上12-云台右上13-云台左下14-云台右下7-镜头拉近8-镜头拉远9-镜头近焦10-镜头远焦(6)远程回放查询接口远程回放时需要从存储介质中查询回放路径，接口如下queryCameraRecord需要的参数有平台地址、登录成功后返回的会话ID、监控点ID、录像类型、录像的存储介质、查询录像的开始时间、查询录像的结束时间、查询录像返回的对象其中开始时间和结束时间格林威治时间，也就是从1970年1月1日的00:00:00.000开始的时间，精确到毫秒。注：在使用该接口时，请先了解下格林威治时间和Calendar的使用方法，确保传入的时间是需要查询的时间。存储介质类型：0-IPSAN1-设备录像2-PCNVR3-ENVR4-CISCO5-DSNVR7-CVR目前我们只支持单存储介质查询，开发者可以根据需求进行遍历，实现多项查询。(7)获取的监控点主要作用如下图所示：图3-4监控点录像查询、实时预览、云台控制操作流程常见错误及排查方式N类错误排除方式N122、N123、N124、N1251.请检查您手机的网络；2.请确认服务器是否在线。N124、N140、N141、N1421.请向平台确认该平台是否与手机客户端完成对接。N1701.请检查流媒体服务器是否开启。N1711.请向平台管理员确认是否具有控制权限。R类错误排除方式R11.重启客户端；2.更换手机。R3、R131.重启客户端。R121.要求平台查询getDeviceInfo接口返回的设备名称密码是否为空。R141.重启客户端；2.关闭一些别的正在运行的软件。R171.要求平台查询getRealPlayURL接口返回的Rtsp地址是否正确。R181.手机所处的网络是否可以连通流媒体，检查流媒体的网络是否通；2.请进入“更多”页面，检查通讯线路是否选择正确。R103、R104、R202、R203、R302、R303、R402、R403、R502、R503、R602、R603、R702、R703、R802、R8031.网络不好引起，换个时间请求或者换个网络环境。R101、R105、R106、R204、R205、R304、R305、R404、R405、R504、R505、R604、R605、R704、R705、R804、R8051流媒体回复信令错误，需要在服务器抓包判断。R903、R1001流媒体取流端口不通1.请检查udp端口是否映射；2.关闭防火墙。R1103流媒体取流端口1.请检查tcp端口是否映射；2.关闭防火墙。M7Uri解析错误运行常见错误表N类错误码及错误描述，主要与CMS进行交互N100输入参数错误N120创建url对象失败N121创建request对象失败N122http请求超时N123http请求异常N124http请求返回非200N125http请求返回空N140创建datadoc对象失败N141获取root节点失败N142解析返回状态码和描述失败N160不存在数据N161URL请求时参数缺少或参数错误N162会话错误N163用户不存在N164密码错误N165设备不存在N166监控点不存在N167线路不存在N168控制中心不存在N169区域不存在N170流媒体没有被启用N171没有权限N172录像不存在N173用户被冻结N174用户已经登录N175没有支持N199未知错误N198平台需要提示的错误描述N200服务器异常R类错误码及错误描述，主要与流媒体服务器相关R1HPR初始化失败R2消息队列启动失败R3RtspClient未初始化R4协议不支持R5回调参数为空R6创建Rtsp引擎失败R7分配Rtsp引擎数超过最大数（32）R8无效的引擎IDR9引擎不存在R10引擎为空R11开始时间为空R12设备名称或者密码为空R13错误的基础端口号R14内存分配失败R15引擎未初始化R16MAG、VTDU4.0不支持RtporTcpR17Rtsp地址错误R18连接流媒体服务器失败R19不在播放状态R101Describe重定向失败R102生成Describe信令失败R103发送Desc