萤石云移动端sdk常见问题

使用萤石云的SDK时常会遇到各种问题

首先，请先查看错误码文档，这能解决其中的绝大多数！！！

如果没有找到，可以看看下方这些常见问题能否解决你碰到的情况。（iOS可以在打印日志中搜索opensdk error找到错误码，android可以在Logcat日志中搜索handle error找到错误码）

 

如果未解决，请先自行运行Demo，确保问题能在Demo上复现。如不能复现，请参考Demo实现；如能复现，请提供以下信息并提交工单

1.是否已在Demo上复现，偶现还是必现

2.安卓还是iOS问题、SDK版本号

3.问题详细描述+demo启动至问题复现过程的日志 (不是开发好的App)

4.提供appKey+accessToken+设备序列号+验证码

相关文档地址

文档	url
安卓接入文档	https://open.ys7.com/help/36
IOS接入文档	https://open.ys7.com/help/43
SDK & Demo下载	https://open.ys7.com/mobile/download.html

一、配网流程

二、常见问题

1.预览问题

• 预览失败

      1.确定是否是网络问题，切换至外网试试

      2.如果demo正常，用户自己App不正常，可能是验证码问题。SDK中验证码要传入明文，用户App验证码可能获取了后端加密的验证码

      3.可能是服务端返回设备未加密，设备实际是加密状态，进入demo该设备的设置页面，开启或关闭“视频图片加密”，同步下再试下

      4.打开萤石SDK调试模式，将调试栏里的ysproto://xxx 地址复制出来，提工单反馈排查

• 预览花屏、绿屏

      出现此问题是因为设备端网络不稳定或设备有问题，发送过来的原始码流就有问题，并不是SDK的问题，需要检查设备网络情况或找设备技术排查

      android原始码流获取方法：先打开调试模式：EZOpenSDK.showSDKLog(true)，复现问题后，打开文件存储路径/storage/emulated/0/Android/data/ezviz.ezopensdk/files，stream.txt即是原始码流文件。

      iOS原始码流获取方法：先打开调试模式：[EZOPENSDK setDebugLogEnable:YES]，复现问题后，打开文件存储路径/SandBox/Documents/EZSaveStreamData，设备序列号_通道号_日期_xxx 即是原始码流文件。

2.SD卡回放问题

• 打开萤石SDK调试模式，将调试栏里的ysproto://xxx 地址复制出来，提工单反馈排查

3.云存储回放问题

• 提供api环境+appkey+access token+设备序列号，提工单反馈排查

 

4.对讲问题

• 确定设备是NVR还是IPC，是否支持对讲

> 如果是  IPC设备，打开SDK调试模式，调试栏中搜索supportExtShort字段第2位数字。(1:支持全双工 3:支持半双工 4:同时支持全双工和半双工；其他：不支持)

> 如果是NVR设备，打开SDK调试模式，调试栏中搜索supportExtShort字段第192位数字。(1:支持通道对讲；其他：不支持)

• 打开萤石SDK调试模式，将调试栏里的tts://xxx 地址复制出来，提工单反馈排查

 

5.局域网设备搜索问题

• 提供错误日志，提工单反馈排查

6.SD卡格式化失败问题

• SDK这边只是发送了一个https请求，服务端下发信令(0x2883)给设备，需要设备技术排查。
• 内存卡要求：为防止出现内存卡异常、无法识别等现象，建议使用萤石视频监控专用micro SD卡或者也可使用正品金士顿、闪迪之类的Micro SD卡。Micro SD卡需满足以下条件：

1. 读写速度要求：Class10级别；
2. 文件格式：FAT32；（目前萤石设备支持FAT32和EXFAT格式的内存卡，如果使用其他格式的内存卡，客户端会显示不可用，然后点击格式化后会自动格式化为FAT32格式。）
3. 容量大小：一般为“8G≤内存卡容量≤128G”（大部分摄像机开始陆续升级支持256G）。

注：运动相机、行车记录仪推荐闪迪U1读写速度以上内存卡。

7.根据不同录像类型获取SD卡回放视频，数据一样

•  同一个视频可以同时是事件录像、定时录像，所以就算传的类型不一样，也可能返回相同的数据。具体需要咨询设备端同事。

8.接口问题

• 提供请求报文 & 响应报文，提工单反馈排查

9.配网问题

• android sdk配网弹出网络连接确认框，萤石云App没有

安卓Q-SDK API 29-系统版本号10.0以上，旧的强制连接wifi的api已被废弃，使用的话会失败。必须使用新的api来做网络连接，就会弹出提示需要用户确认才能进行网络连接。

萤石云不弹框提示是因为国内的App target还是28，所以还能用旧的api。

EZOpenSDK是国内和海外公用的，有些用户需要将App上架到谷歌的Play Store，而Play Store最低的target sdk要求就是30，所以只能使用新的api来配网。

综上，这个是正常现象。以后国内应用商城targetsdk要求上来了，国内的萤石云App也会使用新的api，会出现网络连接弹框提示的。

• android AP配网连接设备热点，不断弹框提示是否连接网络

问题原因：系统在wifi连接到设备的AP 热点后，大概过了30s，系统启动外网的检测机制，当发现该设备热点wifi无外网时，给该设备热点打上一个无外网的标签并且缓存到系统里面。当App调用API主动连接wifi名相同的热点时，系统读取到缓存认为这个wifi无网络，直接强行关闭弹窗，重新弹窗。

解决方案：手动去wifi管理页面，把缓存的相同wifi名删除掉即可。

• SoftAP设备无法配网

我们的SDK默认支持的是基线设备(热点WIFI名为EZVIZ_序列号)。如果您的设备是定制的，前缀可能是SoftAP_序列号或者其他，那热点验证码则为SoftAP_验证码。

iOS Demo需要在支持页面（EZSupportViewController.m）输入对应的WiFi Prefix，如SoftAP

android Demo 如果是AP配网，ApConfigWifiPresenterForFullSdk.java类中会调用配网方法，确保deviceHotspotSSID和deviceHotspotPwd这两个参数一定要传入对应的设备热点名和设备热点密码，否则配网失败。其他同理

• iOS Smart配网问题

1. Smart配网失败是正常情况，所以现在设备都用AP配网方式了。
2. 苹果手机芯片可能不支持smart配网的，可以使用安卓手机去配网。

•  其他配网问题

请提供demo配网过程视频（用另一个手机拍，不是手机配网录屏，需要观察设备的响应提示）& demo配网过程完整日志。

• wifi密码错误问题

Android将WiFi信息发送给设备后，会在SDK内部去轮询设备是否注册到平台，如果成功才会回调给应用层，应用层再进行设备添加。 iOS将WiFi信息发送给设备后，直接回调一个结                  果(WiFi信息发送给设备)给应用层，回调YES仅仅代表成功将WiFi信息发送给设备，不代表设备配网成功。如果发送成功，会出现添加设备按钮，然后在应用层查询设备是否配网成功                  并注册到平台，如果注册成功，最后再进行设备添加。应用层无法判断wifi密码是否正确，只能在端上去判断

10.IOS SDK集成，报No such file or directory错误

• 阅读包中的README(集成必读)

11.基线门铃接入，实现预览对讲

• 把EZCameraListActivity内的getDeviceList替换成getDeviceListEx方法， getDeviceInfo替换成getDeviceInfoEx方法即可