萤石云视频Android SDK接口使用说明合作伙伴交流使用版本日期修改人修改原因3.02015-10-15夏兴锁SDK大版本重构3.12015-12-05夏兴锁1 UI改版2增添广场接口3.22016-01-13夏兴锁增加设备操作/留言/等相关接口3.32016-01-28夏兴锁1,增加A1 探测器接口2,修正版本升级界面bug3,播放时给出终端绑定错误码1200314,修正其他bug特别说明1：本SDK只包含真机调试的功能，不支持任何模拟器的调试；特别说明2：本SDK提供的功能都已经在文档上说明，任何不在文档上说明的功能不支持，用户可以向我们提需求来完善功能；特别说明3：请频繁查看内容更新，特别是FAQ栏目。1.简介32.名词解释33.功能介绍34.SDK配置35.快速接入示范55.1获取摄像头列表55.2添加设备75.3Wifi一键配置85.4设备预览126.接口146.1SDK整体接入流程146.2SDK初始化156.3登录模块156.4设备模块176.5设备升级246.6报警信息模块246.7留言消息模块256.8SD卡操作276.9录像相关模块286.10设备控制模块296.11EZPlayer模块306.12广场相关接口386.13安全验证接口406.14其他接口416.15实体类426.16EZOpenSDK枚举值44 45 / 451. 简介本文档用于说明萤石开放平台SDK Android版本接口之间的关系以及接口调用顺序，对开放平台SDK Android版本各接口都有详细的说明。主要分为四个部分，第一部分为名词解释;第二部分为SDK环境配置；第三部阐述了开放SDK的主要调用流程;第四部分对各模块接口进行了详细的说明2. 名词解释名词释义accessToken访问令牌，由server返回给client用于认证camerId摄像头唯一标志AppKey应用程序keyAppKey的申请可以参阅deviceSerial设备唯一标志OSD视频当前时间PTZ云台控制，可以通过终端控制操作设备3. 功能介绍V3.0: 授权登录、获取摄像头列表、直播预览、查看回放（SD卡、云存储）、设备添加删除、设备的设置功能（h5）、设备控制接口（云台、镜头画面）、WiFi配置、视频本地录像、视频截屏、报警消息等V3.1: 安全验证接口、获取设置设备验证码、数据解密接口、视频广场相关接口等，主要功能是完成UI版本的开源项目4. SDK配置1. 新建android app工程2. 导入EZOpenSDK.jar（拷贝到libs/下）3. 拷贝lib*.so到libs/armeabi/4. 设置AndroidManifest.xml权限： 应用组件： 用于sdk中间页显示，包含登录、设备添加、设备操作等页面 用于接收网络变化刷新SDK网络状态，接收中间页登录成功消息启动其他界面5. 快速接入示范本节旨在引导开发者进行快速接入，通过介绍几个关键的接口，并给出对应的界面和接口，以及代码范例，让开发者对sdk有个初步了解首先请下载并安装萤石云app, 登陆以后，进入的是监控列表界面，如下所示 图中橙色矩形框仅作为标注，并非原生app界面5.1 获取摄像头列表try List result = null; result = mEZOpenSDK.getCameraList(0, 10); return result; catch (BaseException e) mErrorCode = e.getErrorCode(); return null;说明：通过调用getCameraList，可以得到一个列表，列表每一项包含一个摄像头的信息。开发者可以通过list adapter将列表展示代码位于SrccomvideogouicameralistEZCameraListActivity.java5.2 添加设备说明：需要添加设备时，可以点击界面一中的加号(+)， 进入界面2界面二是一个二维码扫描，用户可以通过扫描二维码获取设备序列号，也可以点击界面右上角的图标(橙色标注)，进入界面3，界面3是一个手动输入序列号界面界面2(二维码扫描)代码在srccomvideogoscanmainCaptureActivity.java界面3(手动输入)代码在srccomvideogouidevicelist SeriesNumSearchActivity用户输入设备序列号，只有当设备没有被其他人添加，并且设备已经在线(注册上平台)时，才能够被添加，因此，必须要查询一下该设备状态，调用的接口是probeDeviceInfotry mEZProbeDeviceInfo = mEZOpenSDK.probeDeviceInfo(serialNo); sendMessage(MSG_QUERY_CAMERA_SUCCESS); LogUtil.infoLog(TAG, probeDeviceInfo success); catch (BaseException e) sendMessage(MSG_QUERY_CAMERA_FAIL, e.getErrorCode(); LogUtil.infoLog(TAG, probeDeviceInfo fail : + e.getErrorCode(); e.printStackTrace();如果该接口返回成功，则说明该设备状态正常，继续调用addDevice接口添加。try boolean result = mEZOpenSDK.addDevice(mSerialNoStr, mVerifyCode); / 添加成功 sendMessage(MSG_ADD_CAMERA_SUCCESS); catch (BaseException e) sendMessage(MSG_ADD_CAMERA_FAIL, e.getErrorCode(); LogUtil.errorLog(TAG, add camera fail);如果该接口返回错误，开发者需要处理以下几个错误码，告诉用户该设备不可添加的原因：20020设备在线，已经被自己添加 (给出提示)20022设备在线，已经被别的用户添加 (给出提示)20023设备不在线，未被用户添加 （这里需要调用wifi一键配置）20024设备不在线，已经被别的用户添加 (给出提示)20029设备不在线，已经被自己添加 (给出提示)至此，一个简单的设备添加就完成了5.3 Wifi一键配置在上述调用接口probeDeviceInfo过程中，如果返回的错误