萤石云 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这两个文件。

取流常见错误码