萤石云移动端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
一、配网流程

萤石云移动端sdk常见问题_第1张图片

二、常见问题

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方法即可

你可能感兴趣的:(音视频,个人开发,萤石云)