《移动SDK对接白皮书（Android）+V1.2》由会员分享，可在线阅读，更多相关《移动SDK对接白皮书（Android）+V1.2（14页珍藏版）》请在金锄头文库上搜索。
1、目 录1 SDK应用场景51.1 简介51.2 系统支持51.3 组网环境52 SDK导入62.1 拷贝SDK库文件62.1.1 Eclipse62.1.2 Android Studio62.2 添加依赖项63 SDK接口介绍83.1 基本介绍83.1.1 主要文件介绍83.2 业务接口说明83.2.1 登录接口83.2.2 登出接口83.2.3 查询摄像机列表接口83.2.4 启动实况接口93.2.5 停止实况接口93.2.6 查询回放接口93.2.7 启动回放接口93.2.8 停止回放接口103.2.9 启动对讲接口103.2.10 停止对讲接口103.2.11 云台控制接口103.2.1
2、2 锁定、解锁云台接口113.2.13 添加预置位接口113.2.14 查询预置位接口113.2.15 使用预置位接口113.2.16 删除预置位接口113.2.17 获取/查询告警接口113.2.18 推送告警接口123.3 播放器接口123.3.1 初始化接口123.3.2 销毁接口123.3.3 启动播放接口123.3.4 停止播放接口123.3.5 打流接口123.4 对讲接口133.4.1 对讲建立接口133.4.2 对讲关闭接口133.5 基本流程143.5.1 业务流程143.5.2 回放流程143.5.3 实况流程154 Demo介绍164.1 LoginActivity.ja
3、va16该类用于演示登录接口调用164.2 MainActivity.java16该类用于演示业务接口调用16141 SDK应用场景1.1 简介针对部分公司和局点开发的客户端中需要实现我司TS服务器组网的摄像机实况播放，我司提供该SDK包含了部分TS接口供外部开发使用。该SDK只用于Android的开发使用，提供的接口功能主要有TS服务器的登录和登出、实况和回放的播放、云台控制等功能。1.2 系统支持系统类型是否支持Android 2.3.3以上32位系统支持64位系统支持1.3 组网环境该SDK所适用的基本组网环境如下图所示：固定IP地址视频监控系统TS接入/转码服务器固定IP地址视频监控系
4、统TS接入/转码服务器3G网络WIFI网络该组网主要由一台VM服务器和一台TS服务器组成，将TS服务器接入VM服务器，移动端通过3G/4G网络或WIFI网络连接TS服务器，进而获取VM服务器的相关配置以及视频播放。2 SDK导入2.1 拷贝SDK库文件2.1.1 Eclipse将jar文件和so文件夹拷贝至工程的libs目录下。2.1.2 Android Studio将jar文件拷贝至工程的libs目录下，so文件夹拷贝至工程的jinLibs目录下。2.2 添加依赖项若是Android Studio，请在【Open Module Settings】中添加库的依赖项。3 SDK接口介绍3.1 基
5、本介绍3.1.1 主要文件介绍1、ServiceManager类ServiceManager类封装所有业务的请求及结果回调，业务与接口一一对应。2、KeepaliveService类KeepaliveService服务类用于与TS服务器之间的保活，需要在登录成功后启动。3、Player类Player类用于视频图像的播放。3.2 业务接口说明3.2.1 登录接口ServiceManager.login(LoginParam param, OnLoginListener listener) 类型参数说明LoginParam param登录参数，包含TS服务器地址、端口、用户名、密码OnLoginL
6、istener listener登录结果回调函数3.2.2 登出接口ServiceManager.logout(OnLogoutListener listener) 类型参数说明OnLogoutListener listener登出结果回调函数3.2.3 查询摄像机列表接口ServiceManager.queryResource(QueryResourceParam param, OnQueryResourceListener listener)类型参数说明QueryResourceParam param查询摄像机列表参数，包含父组织编码、模糊搜索字段、分页查询条件OnQueryResourc
7、eListener listener查询结果回调回调函数结果以列表形式返回：List。ResourceInfo包含摄像机名称、摄像机编码、摄像机类型、摄像机在线状态等。3.2.4 启动实况接口ServiceManager.startLive(StartLiveParam param, OnStartLiveListener listener)类型参数说明StartLiveParam param参数包含摄像机编码、帧率、码率、分辨率等OnStartLiveListener listener实况启动结果回调OnStartLiveListener回调中包含播放session，为该次播放的唯一标识。3
8、.2.5 停止实况接口ServiceManager.stopLive(String playSession, OnStopLiveListener listener)类型参数说明String playSession启动实况时获得的播放sessionOnStopLiveListener listener实况停止结果回调3.2.6 切换清晰度接口ServiceManager.changeStream(String playSession, StreamParam param, OnStreamChangeListener listener)类型参数说明String playSession启动实况时
9、获得的播放sessionStreamParamparam清晰度相关参数包括帧率、码率、分辨率等OnStreamChangeListenerlistener切换清晰度回调3.2.7 查询回放接口ServiceManager.queryReplay(QueryReplayParam param, OnQueryReplayListener listener)类型参数说明QueryReplayParam param包含摄像机编码、查询起始时间、查询结束时间、分页查询条件OnQueryReplayListener listener查询结果回调OnQueryReplayListener 回调函数结果以列
10、表形式返回：List。RecordInfo包含录像片段起始时间、结束时间、文件名。3.2.8 启动回放接口ServiceManager.startReplay(StartReplayParam param, OnStartReplayListener listener)类型参数说明StartReplayParam param参数包含摄像机编码、帧率、码率、分辨率、录像片段信息等OnStartReplayListener listener回放启动结果回调OnStartReplayListener 回调中包含播放session，为该次播放的唯一标识。3.2.9 停止回放接口ServiceManag
11、er.stopReplay(String playSession, OnStopReplayListener listener)类型参数说明String playSession启动回放时获得的播放sessionOnStopReplayListener listener回放停止结果回调3.2.10 获取回放播放时间ServiceManager.getReplayPos(String playSession, OnGetReplayPosListener listener)类型参数说明String playSession启动回放时获得的播放sessionOnGetReplayPosListener
12、 listener获取回放播放时间结果回调3.2.11 启动对讲接口ServiceManager.startTalkback(String deviceCode, OnStartTalkbackListener listener)类型参数说明String deviceCode对讲设备编码OnStartTalkbackListener listener回放启动结果回调OnStartTalkbackListener 回调中包含对讲信息，用于实际对讲的建立。3.2.12 停止对讲接口ServiceManager.stopTalkback(TalkbackInfo info, OnStopTalkba
13、ckListener listener)类型参数说明TalkbackInfo info启动对讲时获得的对讲信息OnStopTalkbackListener listener对讲停止结果回调3.2.13 云台控制接口ServiceManager.ptzCommand(PtzCommandParam param, OnPtzCommandListener listener)类型参数说明PtzCommandParam param云台控制参数，包含云台命令字，横向速度、纵向速度等OnPtzCommandListener listener云台控制结果回调云台命令字见PTZ_CMD类，如向左转动，为PTZ
14、.PANLEFT 。转动速度为1-10任意整数值，数字越大速度越快。3.2.14 锁定、解锁云台接口ServiceManager.lockPtz(String cameraCode, OnLockPtzListener)ServiceManager.unLockPtz(String cameraCode,OnUnLockPtzListener listener)两个接口只需传入要锁定或者解锁的云台摄像机编码即可实现。3.2.15 添加预置位接口ServiceManager.addPreset(SetPresetParam param, OnSetPresetListener listener)类型参数说明SetPresetParam param预置位信息参数OnSetPresetListener listener结果回调预置位信息参数包含：摄像机编码、预置位值、预置位描述。3.2.16 查询预置位接口
