萤石云 C++ SDK使用指南

今天继续指南系列，给出了萤石云QtDemo配置使用以及sdk开发中常见问题的指南

SDK下载

一、demo使用配置

1、demo环境配置

Demo 所使用Qt SDK版本：Qt4.8.5

Demo两种开发模式： 

• 下载Qt Creator for Windows，使用Qt Creator作为IDE进行开发

• Visual Studio Add-in for Qt4， 集成到Visual Studio中进行开发。

2、demo的操作步骤

• 在萤石开发平台(https://open.ys7.com)创建一个新应用，获取AppKey和AppSecret。
• 打开EzvizQtDemo.ini文件进行配置
• 采用直接进入设备列表页面或者单设备获取登录后,进行预览、回放、语音等操作

直接进入设备列表页面

注：当通过AccessToken方式登录时，此时输入的token需要和配置文件中配置的appkey对应

单设备获取

注：用户按照提示输入 accessToken appkey（需要和配置文件中的一致），设备序列号和通道号，点击确认，可以获取账号下的指定设备进行相关的操作

• 分析问题获取日志的方法有两种（1. 下载工具DebugView直接抓取2. 使用log4cxx.properties配置日志存储的目录）；问题排查请提供log，方便排查问题。

注意：Demo工程目录路径不要包含中文

3、说明文档

• SDK接口使用说明文档在 doc\EZPCOpenSDK Operation Manual_CN.chm
• 错误码文档在 doc\EZPCOpenSDK错误码.txt

  如果需运行Demo， 请将lib\win32目录下文件拷贝到demo目录下， 然后配置EzvizQtDemo.ini

4、操作文档：

详见https://open.ys7.com/help/47

预览： 用户登录成功后，选择左侧设备列表中的一个设备， 点击预览模块中 预览 按钮进行预览，此时demo开始取流，取流成功后会显示预览画面（如果配置文件中配置了播放功能）；点击 结束 按钮可停止当前预览。

回放：用户登录成功后，选择选择需要回放的设备，点击”选搜索时间”按钮确定录像搜索的时间, 然后点击“搜索设备录像”开始搜索录像信息，选择索索出的录像片段, 然后点击开始回放按钮开始回放，如下图所示；点击停止按钮可停止当前回放。

二、常见问题排查

1、如何获取c++ sdk日志？

PCSDK记录日志主要有两个文件OpenSDK.log及plug.log

其中OpenSDK.log是面向用户接口层的日志，从这个文件里可以获取取流异常，搜索异常及开放平台的一些http接口异常的信息，也可看到每个接口的入口传参内容。

plug.log文件记录的是SDK取流模块信息的日志，从这个日志里可以看出具体取流异常的错误原因。

下面介绍一下客户端如何生成这两个文件。用户下载完成SDK开发包的时候，开发包内会带有SDK的客户端demo（EzvizQtDemo.exe）,demo根目录下会存在一个log4cxx.properties文件，这个文件是SDK的日志配置文件，用户可以参考该文件的内容对SDK的日志生成进行配置。配置完成后，重启客户端运行，客户端安装目录的文件夹下会生成一个log文件夹，该文件夹内会生成OpenSDK.log及plug.log这两个文件。

取流常见错误码

错误码	错误描述	释义	解决方案
525402	回放找不到录像文件	设备回放找不到录像文件	检查目标时间段是否有录像文件
525404	设备不在线	设备不在线	检查设备网络；重启设备接入萤石云
525405	流媒体向设备发送或接受信令超时/cas响应超时	设备回应信令10秒超时	该报错是设备端网络不佳导致的报错。1、建议排查下设备的网络环境，每一路设备的上行带宽要保证2m。2、如果设备绑定在录像机下，可能是录像机与摄像头之间设备信令响应超时所致，建议可以将摄像头直连账号下测试排查。3、重启设备尝试
525410	设备达到最大连接数		连接数为设备端限制，不同设备，最大连接数不同（设备支持最大连接数，请咨询所购设备售后或销售）。该报错表示设备在同一时间内被多路取流，主码流、子码流、私有流、回放流等，会受到设备硬件本身的连接数量限制。遇到此类报错，请关闭、减少其它端客户端对该设备的预览、回放。若设备一直报错，建议重启设备后，等待一段时间后再播放
525411	token无权限	token无权限、用户无权限	请检查token正确性，托管、子账号请检查是否赋权
525415	设备通道错	设备判断请求通道不存在	请确认请求的通道参数
525416	设备资源受限	设备资源受限	连接数为设备端限制，不同设备，最大连接数不同（设备支持最大连接数，请咨询所购设备售后或销售）。该报错表示设备在同一时间内被多路取流，主码流、子码流、私有流、回放流等，会受到设备硬件本身的连接数量限制。遇到此类报错，请关闭、减少其它端客户端对该设备的预览、回放。若设备一直报错，建议重启设备后，等待一段时间后再播放
525451	设备不支持的码流类型	设备不支持的码流类型	报错为设备没有对应码流，一般出现在以下两种情况，1、多通道设备（NVR本地通道关联情况异常或者没有关联设备，需要到NVR设备本地检查硬件连接情况；2、设备没有对应的码流，通常设备有主码流、子码流之分，有些特殊的设备（IPC类设备）可能没有主码流或者子码流，这时候可以切换清晰度测试。
525452	设备链接流媒体服务器失败	设备链接流媒体服务器失败	该报错是设备端网络不佳导致的报错。1、建议排查下设备的网络环境，每一路设备的上行带宽要保证2m。2、如果设备绑定在录像机下，可能是录像机与摄像头之间设备信令响应超时所致，建议可以将摄像头直连账号下测试排查。3、重启设备尝试
525492	设备不支持的命令	设备不支持的命令	设备不支持的命令
525546	vtdu返回达到取流并发路数限制	免费版取流限制	请升级为企业版，放开并发限制
525547	vtdu返回开放平台用户并发限制	免费版取流限制	请升级为企业版，放开并发限制
525557	回放服务器等待流头超时	设备网络异常	该报错是设备端网络不佳导致的报错。1、建议排查下设备的网络环境，每一路设备的上行带宽要保证2m。2、如果设备绑定在录像机下，可能是录像机与摄像头之间设备信令响应超时所致，建议可以将摄像头直连账号下测试排查。3、重启设备尝试
525558	查找录像开始时间错误	客户端请求的回放开始时间异常	请核实录像起止时间
526519	设备推流链路网络不稳定	设备长时间未推流超时	该报错是设备端网络不佳导致的报错。1、建议排查下设备的网络环境，每一路设备的上行带宽要保证2m。2、如果设备绑定在录像机下，可能是录像机与摄像头之间设备信令响应超时所致，建议可以将摄像头直连账号下测试排查。3、重启设备尝试