OpenSDK
V4.2.0
|
通过OpenSDK_GetLastErrorCode拿错误码,通过OpenSDK_GetLastErrorDesc拿错误码描述信息。接口基本默认只返回0和-1(除了部分特殊说明的接口)。SDK错误码根据模块来罗列,下面归类的是主要、常见的错误码。
错误码定义在OpenNetStreamError.h头文件中.
通过消息回调函数返回,完整请参考INS_ErrorCode.h头文件
注意:预览流媒体如下消息回调返回的错误码,即消息回调(AllocSessionEx时设置)里面的MsgInfo.
错误信息 | 数值 | 提示语 |
---|---|---|
OPEN_SDK_STREAM_ACCESSTOKEN_ERROR_OR_EXPIRE | EZ001 | accesstoken过期,需要重新获取 |
OPEN_SDK_STREAM_PU_NO_RESOURCE | EZ101 | 设备连接数过大,停止其他连接后再试试吧 |
OPEN_SDK_STREAM_TRANSF_DEVICE_OFFLINE | EZ102 | 设备不在线 |
OPEN_SDK_STREAM_INNER_VERIFYCODE_ERROR | EZ104 | 视频验证码错误,建议查看设备上标记的验证码 |
OPEN_SDK_STREAM_PLAY_FAIL | EZ105 | 视频播放失败 |
OPEN_SDK_STREAM_TRANSF_TERMINAL_BINDING | EZ106 | 当前账号开启了终端绑定,只允许指定设备登录操作 |
错误码格式{xbbbbb}, x表示错误码模块类别, bbbbb表示什么错误,x的值如下表:
类别 | 含义 | 备注 |
---|---|---|
0 | correct condition | 正确 |
1 | network exception | 此错误一般同网络或者配置信息有问题,可以照常CURL ErrorCode, 比方DNS没有配置 |
2 | user operation error | 用户级别错误码,一般是用户使用SDK不当造成引起 |
3 | platform server error | OpenApi返回的错误,详细了解请参阅服务端错误码 |
4 | system resource exception | 一般是系统资源不足造成,比方内存不足 |
5 | get stream exception | 取流模块错误码 |
6 | method not supported | SDK不支持 |
7 | push error | 推送相关错误信息 |
9 | undefined error | 未具体定义的错误码 |
具体错误码数值的宏定义,如下表:
错误码描述 | 数值 | 定义 | 备注 |
---|---|---|---|
网络级别 | |||
OPEN_SDK_COULDNT_RESOLVE_HOST | 100006 | 给定的远程主机没有得到解析 | 这里是指platform域名无法正常解析。可能是DNS没有配置或者机器没有连网 |
OPEN_SDK_COULDNT_CONNECT | 100007 | 远程主机不可达 | 这里是指无法访问platform。可能是platform地址配置错误 |
OPEN_SDK_OPERATION_TIMEOUT | 100028 | 请求操作超时 | 超时时间为20s, 请求平台超时,请检查platform地址配置错误 |
用户操作级别 | |||
OPEN_SDK_BAD_PARAMS | 200001 | 接口传入参数不符合要求 | |
OPEN_SDK_SESSION_INVALID | 200002 | 当前Session不存在或者被释放 | 可能是SessionId传入值错误或者是Session已经被释放 |
OPEN_SDK_VIDEO_RECORD_NOT_EXIST | 200003 | 指定时间段内录像记录不存在 | |
OPEN_SDK_VIDEO_RECORD_SEARCHING | 200004 | 录像记录正在搜索 | |
OPEN_SDK_STOP_ALARM_REC_FAILED | 200005 | 关闭告警失败 | |
OPEN_SDK_PERMANENT_KEY_INVALID | 200006 | 验证码不正确 | |
OPEN_SDK_PIC_DECRYPT_FAILED | 200007 | 图片解码失败 | |
OPEN_SDK_PIC_CONTENT_INVALID | 200008 | 图片内容无效 | |
OPEN_SDK_PIC_NO_NEED_DECRYPT | 200009 | 图片无需解码 | |
OPEN_SDK_PIC_COULDNT_ALLOC_BUFFERS | 200010 | 无法分配图片资源内存 | 内存不足或者图片过大 |
萤石云接口级别 | |||
OPEN_SDK_RESPINFO_BAD | 300001 | 请求返回的信息,json无法正常解析 | 可能是PlatformAddr配置有问题 |
OPEN_SDK_RESPINFO_INVALID | 300002 | 请求返回信息格式有误 | |
OPEN_SDK_ACCESSTOKEN_INVALID | 310002 | accesstoken异常或者过期 | |
OPEN_SDK_SIGNATURE_ERROR | 310008 | 表示输入参数有问题。平台显示签名错误 | |
OPEN_SDK_USERID_PHONE_UNBIND | 310014 | APPKEY下对应的第三方userId和phone未绑定 | |
OPEN_SDK_CHANNEL_NOT_EXIST | 320001 | 通道不存在 | 通道对应某一监控点 |
OPEN_SDK_USER_NOTOWN_DEVICE | 320018 | 该用户不拥有该设备 | |
系统资源级别 | |||
OPEN_SDK_COULDNT_CREATE_THREAD | 400001 | 创建线程失败 | |
OPEN_SDK_COULDNT_ALLOC_BUFFERS | 400002 | 申请内存资源失败 | |
取流功能级别 | |||
OPEN_SDK_NS_OPERATIONCODE_FAILED | 500045 | 获取操作码失败 | 一般是由于用户开启终端绑定了,会报这个错误 |
OPEN_SDK_NS_STREAM_LIMIT | 500410 | 取流路数限制 | 设备达到连接上线 |
OPEN_SDK_NS_DEV_NO_ONLINE | 503121 | 设备不在线 | |
OPEN_SDK_NS_PERMANENTKEY_EXCEPTION | 502012 | 重新输入密钥 1.明文密钥和输入MD5密钥不相等 | 输入的验证码有误 |
OPEN_SDK_NS_VTDU_TIMEOUT | 502021 | 流媒体向设备发送或接受信令超时 | 查看设备连接网络是否稳定。一般是网络问题 |
OPEN_SDK_NS_VTDU_CLIENT_TIMEOUT | 502025 | vtdu客户端接收回应超时 | 可能摄像头与后端设备接触有问题 |
不支持级别 | |||
OPEN_SDK_DEV_NOT_SUPPORT | 600001 | 不支持非1.7设备 | |
OPEN_SDK_API_NO_IMPLEMENT | 600002 | 接口未实现 | |
推送级别错误 | |||
OPEN_SDK_PUSH_PARAM_ERROR | 710001 | 传入参数非法 | |
OPEN_SDK_PUSH_DATA_UNINIT_ERROR | 710002 | 数据未初始化 | 请先调用Init接口初始化 |
OPEN_SDK_PUSH_NO_REGISTER_ERROR | 710003 | 未向Push平台注册 | 未调register接口 |
OPEN_SDK_PUSH_NO_MQTT_CREATE_ERROR | 710004 | 未创建创建推送对象 | 未调create接口 |
OPEN_SDK_PUSH_MQTT_DISCONNECTED_ERROR | 720003 | sdk同push服务器断开连接 | 网络断开或者网络不稳定 |
OPEN_SDK_PUSH_MQTT_MAX_MESSAGES_ERROR | 720004 | 推送消息达到消息接收上限 | |
OPEN_SDK_PUSH_MQTT_BAD_UTF8_STRING_ERROR | 720005 | 不合法的UTF-8字符串 | |
OPEN_SDK_PUSH_MQTT_NULL_PARAMETER_ERROR | 720006 | 传入参数为空指针 | |
OPEN_SDK_PUSH_MQTT_VERSION_INVALID_ERROR | 730001 | 连接失败,协议版本不支持 | |
OPEN_SDK_PUSH_MQTT_IDENTIFIER_ERROR | 730002 | 连接失败,唯一标识不正确 | |
OPEN_SDK_PUSH_MQTT_SERVER_UNAVAILABLE_ERROR | 730003 | 连接失败,服务不存在 | |
OPEN_SDK_PUSH_MQTT_BAD_USERNAME_PASSWORD_ERROR | 730004 | 连接失败,mqtt用户名和密码不正确 | |
OPEN_SDK_PUSH_MQTT_NOT_AUTHORIZED_ERROR | 730005 | 连接失败,未授权 | |
OPEN_SDK_PUSH_PLATFORM_RESPINFO_BAD | 740001 | 请求返回的信息,json无法正常解析 | 可能是PlatformAddr配置有问题 |
OPEN_SDK_PUSH_PLATFORM_RESPINFO_INVALID | 740002 | 请求返回信息格式有误 | |
OPEN_SDK_PUSH_PLATFORM_SESSION_INVALID_ERROR | 740003 | 会话失效 | 会话可能已经被释放 |
OPEN_SDK_PUSH_PLATFORM_UNAUTHORIZED_ERROR | 740401 | 凭证无效 | 可能是PlatformAddr配置有问题 |
OPEN_SDK_PUSH_COULDNT_CREATE_THREAD | 750001 | 创建线程失败 | |
OPEN_SDK_PUSH_COULDNT_ALLOC_BUFFERS | 750002 | 申请内存资源失败 | |
OPEN_SDK_PUSH_COULDNT_RESOLVE_HOST | 760006 | 给定的远程主机没有得到解析 | 这里是指platform域名无法正常解析,可能是DNS没有配置或者机器没有连网 |
OPEN_SDK_PUSH_COULDNT_CONNECT | 760007 | 远程主机不可达 | 这里是指无法访问platform,可能是platform地址配置错误。 |
OPEN_SDK_PUSH_OPERATION_TIMEOUT | 760028 | 请求操作超时, 超时时间为20s | 请求平台超时,请检查platform地址配置错误或者网络不好,无法访问萤石开放平台 |
未定义级别 | |||
OPEN_SDK_ALLOCSESSION_FAILED | 900001 | AllocSession 失败 | |
OPEN_SDK_SEARCH_RECORD_FAILED | 900002 | 查询回放记录失败 | |
OPEN_SDK_START_ALARM_REC_FAILED | 900003 | 开启告警失败 | |
取流级别 | 通过消息回调函数返回,下面为常见错误码,完整请参考INS_ErrorCode.h头文件 | ||
OPEN_SDK_OPERATIONCODE_FAILED | 45 | 获取操作码失败 | 一般是由于用户开启终端绑定了,会报这个错误 |
OPEN_SDK_STREAM_LIMIT | 410 | 取流路数限制 | 设备达到连接上线(设备端的限制) |
OPEN_SDK_DEV_NO_ONLINE | 3121 | 设备不在线 | |
OPEN_SDK_PERMANENTKEY_EXCEPTION | 2012 | 重新输入密钥 1.明文密钥和输入MD5密钥不相等 | 输入的验证码有误 |
OPEN_SDK_VTDU_TIMEOUT | 2021 | 流媒体向设备发送或接受信令超时 | 查看设备连接网络是否稳定。一般是网络问题 |
OPEN_SDK_VTDU_CLIENT_TIMEOUT | 2025 | vtdu客户端接收回应超时 | 可能摄像头与后端设备接触有问题 |
OPEN_SDK_VTDU_STOP | 2034 | vtdu取流停止失败 | |
OPEN_SDK_VTDU_TOKEN_NOCONNECT_VTM | 2047 | VTDU 客户端连接不上VTM,预览时候断网,包重连异常 | |
OPEN_SDK_VTDU_TOKEN_NOCONNECT_VTDU | 2048 | VTDU 客户端连接不上VTDU | |
OPEN_SDK_DEVICE_UNCONNECT_VTDU | 2051 | 设备连接不上流媒体 | |
OPEN_SDK_PLATFORM_CLIENT_NO_SIGN_RELEATED | 3128 | 没有关联特征码 | 一般是用户为开启终端绑定,请登录萤石云关闭终端绑定功能。 |
OPEN_SDK_TTS_DEV_NO_ONLINE | 5012 | TTS设备不在线 | |
OPEN_SDK_GET_OPERATIONCODE_PARAMETER_ERROR | 2056 | 获取操作码参数错误 | |
OPEN_SDK_PRIVATE_VTDU_REQUEST_TIMEOUT | 2225 | 网络带宽受限或者短时间对同一个请求过于频繁 | |
OPEN_SDK_PRIVATE_VTDU_DISCONNECTED_LINK | 2226 | 网络无法连通 | |
OPEN_SDK_PRIVATE_VTDU_STATUS_411 | 5411 | token无权限 | |
OPEN_SDK_PRIVATE_VTDU_STATUS_452 | 5452 | 设备连接预览流媒体服务器失败 | |
OPEN_SDK_PRIVATE_VTDU_STATUS_546 | 5546 | 并发路数限制 |