OpenSDK  V4.2.0
错误码

通过OpenSDK_GetLastErrorCode拿错误码,通过OpenSDK_GetLastErrorDesc拿错误码描述信息。接口基本默认只返回0和-1(除了部分特殊说明的接口)。SDK错误码根据模块来罗列,下面归类的是主要、常见的错误码。
错误码定义在OpenNetStreamError.h头文件中.


通过消息回调函数返回,完整请参考INS_ErrorCode.h头文件
注意:预览流媒体如下消息回调返回的错误码,即消息回调(AllocSessionEx时设置)里面的MsgInfo.

错误信息数值提示语
OPEN_SDK_STREAM_ACCESSTOKEN_ERROR_OR_EXPIREEZ001accesstoken过期,需要重新获取
OPEN_SDK_STREAM_PU_NO_RESOURCEEZ101设备连接数过大,停止其他连接后再试试吧
OPEN_SDK_STREAM_TRANSF_DEVICE_OFFLINEEZ102设备不在线
OPEN_SDK_STREAM_INNER_VERIFYCODE_ERROREZ104视频验证码错误,建议查看设备上标记的验证码
OPEN_SDK_STREAM_PLAY_FAILEZ105视频播放失败
OPEN_SDK_STREAM_TRANSF_TERMINAL_BINDINGEZ106当前账号开启了终端绑定,只允许指定设备登录操作

错误码格式{xbbbbb}, x表示错误码模块类别, bbbbb表示什么错误,x的值如下表:

类别含义备注
0correct condition正确
1network exception此错误一般同网络或者配置信息有问题,可以照常CURL ErrorCode, 比方DNS没有配置
2user operation error用户级别错误码,一般是用户使用SDK不当造成引起
3platform server errorOpenApi返回的错误,详细了解请参阅服务端错误码
4system resource exception一般是系统资源不足造成,比方内存不足
5get stream exception取流模块错误码
6method not supportedSDK不支持
7push error推送相关错误信息
9undefined error未具体定义的错误码

具体错误码数值的宏定义,如下表:

错误码描述数值定义备注
网络级别
OPEN_SDK_COULDNT_RESOLVE_HOST100006给定的远程主机没有得到解析这里是指platform域名无法正常解析。可能是DNS没有配置或者机器没有连网
OPEN_SDK_COULDNT_CONNECT100007远程主机不可达这里是指无法访问platform。可能是platform地址配置错误
OPEN_SDK_OPERATION_TIMEOUT100028请求操作超时

超时时间为20s, 请求平台超时,请检查platform地址配置错误

用户操作级别
OPEN_SDK_BAD_PARAMS200001接口传入参数不符合要求
OPEN_SDK_SESSION_INVALID200002当前Session不存在或者被释放可能是SessionId传入值错误或者是Session已经被释放
OPEN_SDK_VIDEO_RECORD_NOT_EXIST200003指定时间段内录像记录不存在
OPEN_SDK_VIDEO_RECORD_SEARCHING200004录像记录正在搜索
OPEN_SDK_STOP_ALARM_REC_FAILED200005关闭告警失败
OPEN_SDK_PERMANENT_KEY_INVALID200006验证码不正确
OPEN_SDK_PIC_DECRYPT_FAILED200007图片解码失败
OPEN_SDK_PIC_CONTENT_INVALID200008图片内容无效
OPEN_SDK_PIC_NO_NEED_DECRYPT200009图片无需解码
OPEN_SDK_PIC_COULDNT_ALLOC_BUFFERS200010无法分配图片资源内存

内存不足或者图片过大

萤石云接口级别
OPEN_SDK_RESPINFO_BAD300001请求返回的信息,json无法正常解析可能是PlatformAddr配置有问题
OPEN_SDK_RESPINFO_INVALID300002请求返回信息格式有误
OPEN_SDK_ACCESSTOKEN_INVALID310002accesstoken异常或者过期
OPEN_SDK_SIGNATURE_ERROR310008表示输入参数有问题。平台显示签名错误
OPEN_SDK_USERID_PHONE_UNBIND310014APPKEY下对应的第三方userId和phone未绑定
OPEN_SDK_CHANNEL_NOT_EXIST320001通道不存在通道对应某一监控点
OPEN_SDK_USER_NOTOWN_DEVICE320018该用户不拥有该设备

系统资源级别
OPEN_SDK_COULDNT_CREATE_THREAD400001创建线程失败
OPEN_SDK_COULDNT_ALLOC_BUFFERS400002申请内存资源失败

取流功能级别
OPEN_SDK_NS_OPERATIONCODE_FAILED500045获取操作码失败一般是由于用户开启终端绑定了,会报这个错误
OPEN_SDK_NS_STREAM_LIMIT500410取流路数限制设备达到连接上线
OPEN_SDK_NS_DEV_NO_ONLINE503121设备不在线
OPEN_SDK_NS_PERMANENTKEY_EXCEPTION502012重新输入密钥 1.明文密钥和输入MD5密钥不相等输入的验证码有误
OPEN_SDK_NS_VTDU_TIMEOUT502021流媒体向设备发送或接受信令超时查看设备连接网络是否稳定。一般是网络问题
OPEN_SDK_NS_VTDU_CLIENT_TIMEOUT502025vtdu客户端接收回应超时

可能摄像头与后端设备接触有问题

不支持级别
OPEN_SDK_DEV_NOT_SUPPORT600001不支持非1.7设备
OPEN_SDK_API_NO_IMPLEMENT600002接口未实现

推送级别错误
OPEN_SDK_PUSH_PARAM_ERROR710001传入参数非法
OPEN_SDK_PUSH_DATA_UNINIT_ERROR710002数据未初始化请先调用Init接口初始化
OPEN_SDK_PUSH_NO_REGISTER_ERROR710003未向Push平台注册未调register接口
OPEN_SDK_PUSH_NO_MQTT_CREATE_ERROR710004未创建创建推送对象

未调create接口

OPEN_SDK_PUSH_MQTT_DISCONNECTED_ERROR720003sdk同push服务器断开连接网络断开或者网络不稳定
OPEN_SDK_PUSH_MQTT_MAX_MESSAGES_ERROR720004推送消息达到消息接收上限
OPEN_SDK_PUSH_MQTT_BAD_UTF8_STRING_ERROR720005不合法的UTF-8字符串
OPEN_SDK_PUSH_MQTT_NULL_PARAMETER_ERROR720006传入参数为空指针

OPEN_SDK_PUSH_MQTT_VERSION_INVALID_ERROR730001连接失败,协议版本不支持
OPEN_SDK_PUSH_MQTT_IDENTIFIER_ERROR730002连接失败,唯一标识不正确
OPEN_SDK_PUSH_MQTT_SERVER_UNAVAILABLE_ERROR730003连接失败,服务不存在
OPEN_SDK_PUSH_MQTT_BAD_USERNAME_PASSWORD_ERROR730004连接失败,mqtt用户名和密码不正确
OPEN_SDK_PUSH_MQTT_NOT_AUTHORIZED_ERROR730005连接失败,未授权

OPEN_SDK_PUSH_PLATFORM_RESPINFO_BAD740001请求返回的信息,json无法正常解析可能是PlatformAddr配置有问题
OPEN_SDK_PUSH_PLATFORM_RESPINFO_INVALID740002请求返回信息格式有误
OPEN_SDK_PUSH_PLATFORM_SESSION_INVALID_ERROR740003会话失效会话可能已经被释放
OPEN_SDK_PUSH_PLATFORM_UNAUTHORIZED_ERROR740401凭证无效

可能是PlatformAddr配置有问题

OPEN_SDK_PUSH_COULDNT_CREATE_THREAD750001创建线程失败
OPEN_SDK_PUSH_COULDNT_ALLOC_BUFFERS750002申请内存资源失败

OPEN_SDK_PUSH_COULDNT_RESOLVE_HOST760006给定的远程主机没有得到解析这里是指platform域名无法正常解析,可能是DNS没有配置或者机器没有连网
OPEN_SDK_PUSH_COULDNT_CONNECT760007远程主机不可达这里是指无法访问platform,可能是platform地址配置错误。
OPEN_SDK_PUSH_OPERATION_TIMEOUT760028请求操作超时, 超时时间为20s

请求平台超时,请检查platform地址配置错误或者网络不好,无法访问萤石开放平台

未定义级别
OPEN_SDK_ALLOCSESSION_FAILED900001AllocSession 失败
OPEN_SDK_SEARCH_RECORD_FAILED900002查询回放记录失败
OPEN_SDK_START_ALARM_REC_FAILED900003开启告警失败
取流级别通过消息回调函数返回,下面为常见错误码,完整请参考INS_ErrorCode.h头文件
OPEN_SDK_OPERATIONCODE_FAILED45获取操作码失败一般是由于用户开启终端绑定了,会报这个错误
OPEN_SDK_STREAM_LIMIT410取流路数限制设备达到连接上线(设备端的限制)
OPEN_SDK_DEV_NO_ONLINE3121设备不在线
OPEN_SDK_PERMANENTKEY_EXCEPTION2012重新输入密钥 1.明文密钥和输入MD5密钥不相等输入的验证码有误
OPEN_SDK_VTDU_TIMEOUT2021流媒体向设备发送或接受信令超时查看设备连接网络是否稳定。一般是网络问题
OPEN_SDK_VTDU_CLIENT_TIMEOUT2025vtdu客户端接收回应超时可能摄像头与后端设备接触有问题
OPEN_SDK_VTDU_STOP2034vtdu取流停止失败
OPEN_SDK_VTDU_TOKEN_NOCONNECT_VTM2047VTDU 客户端连接不上VTM,预览时候断网,包重连异常
OPEN_SDK_VTDU_TOKEN_NOCONNECT_VTDU2048VTDU 客户端连接不上VTDU
OPEN_SDK_DEVICE_UNCONNECT_VTDU2051设备连接不上流媒体
OPEN_SDK_PLATFORM_CLIENT_NO_SIGN_RELEATED3128没有关联特征码一般是用户为开启终端绑定,请登录萤石云关闭终端绑定功能。
OPEN_SDK_TTS_DEV_NO_ONLINE5012TTS设备不在线
OPEN_SDK_GET_OPERATIONCODE_PARAMETER_ERROR2056获取操作码参数错误
OPEN_SDK_PRIVATE_VTDU_REQUEST_TIMEOUT2225网络带宽受限或者短时间对同一个请求过于频繁
OPEN_SDK_PRIVATE_VTDU_DISCONNECTED_LINK2226网络无法连通
OPEN_SDK_PRIVATE_VTDU_STATUS_4115411token无权限
OPEN_SDK_PRIVATE_VTDU_STATUS_4525452设备连接预览流媒体服务器失败
OPEN_SDK_PRIVATE_VTDU_STATUS_5465546并发路数限制