- 在萤石开发平台(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、重启设备尝试 |
