收藏官网首页
查看: 8346|回复: 0

iOS SDK 2.0文档 9 - 新旧SDK功能对比

562

主题

1222

帖子

8115

积分

版主

Rank: 7Rank: 7Rank: 7

积分
8115
发表于 2016-7-7 16:43:58 | 显示全部楼层 |阅读模式
校园创客福利
1. 新旧SDK兼容方式SDK采取以下兼容方式:

  • 兼容接口参数对应转换为新接口参数后,在兼容接口内调用新接口。
  • 回调时同时回调兼容接口。之前使用1.6.2 SDK的APP,仍然可以收到兼容接口的回调。

新版SDK对1.6.2 SDK的未废弃接口做了无缝兼容。
2. 新旧SDK功能对比
下面对新旧SDK的功能做些对比说明:

  • 下载配置文件功能

        2.0 SDK会自动探测配置文件是否有更新,有更新时会主动推送给APP。APP只保留didUpdateProduct回调即可,不需要再使用updateDeviceFromServer这个兼容接口做强制更新了。
  • 获取设备列表功能

        2.0 SDK会主动发现当前局域网设备,用户登录、绑定或解绑后也会主动刷新已绑定设备,并推送给APP。APP只要实现didDiscovered回调即可得到最新的设备列表。2.0 SDK提供设备列表缓存,APP可以使用deviceList缓存刷新界面。
        APP仍然可以使用getBoundDevices接口调用,但getBoundDevices接口需要访问外网获取绑定设备列表,回调刷新的快慢取决于网络请求时间。
  • 设备绑定功能

        对于局域网wifi设备,只要用户登录了,2.0 SDK就会自动绑定已订阅的设备;对于非局域网设备,APP需要调用绑定接口手动绑定。使用passcode绑定的兼容接口将被新的mac地址绑定接口取代。
  • 用户注销功能

        云端一直都不支持用户注销功能,2.0 SDK也仅对接口调用做兼容,并不实现真正的用户注销功能。 APP如果不想继续使用当前用户,可以切换用户登录。
  • 设备passcode属性值

        设备passcode仅在设备绑定时会被使用到。从安全角度考虑,2.0 SDK的新接口中,不推荐继续使用passcode绑定的兼容接口,并且也不再提供有效的passcode值。
  • 设备登录功能

        设备登录兼容接口,会触发设备订阅。2.0 SDK对已订阅设备会自动登录,只要不取消订阅,自动登录会一直尝试直到成功为止。APP只需要订阅设备,接收设备的netStatus变化上报即可。
        2.0 SDK设备登录过程,包含设备连接、获取passcode、登录验证、获取设备状态四个步骤。其中有一个步骤失败,即登录失败。登录失败后,SDK会间隔1秒重试。
  • 设备断开连接功能

        设备断开连接兼容接口,会触发设备解除订阅。2.0 SDK对已解除订阅的设备,不再推送任何状态更新,同时会断开设备连接。
  • 设备控制指令下发功能

        旧的设备write接口,不带sn参数。SDK在兼容处理时,sn按0下发。新的write接口中,控制指令下发时可以指定sn,2.0 SDK就可以精确回调该条指令对应的应答。
        2.0 SDK对于下发的设备指令,对以下数据类型做了约定,并且要求只能包含可写指令。不符合类型约定和要求的指令,被视为无效指令,下发指令格式支持字典键值对。
布尔类型命令参数必须传true或false
枚举类型命令参数只能传索引值或枚举字符串
数值类型命令参数只能是数值
扩展类型直接传二进制数据,不需要再做base64编码了
透传数据直接传二进制数据,不需要再做base64编码了
  • 设备状态上报功能

        新的回调接口中会携带下发指令的sn。上报的数据点,以字典键值对的格式回调,数据点标识名和值组成键值对。
        扩展类型和透传数据,回调的数据格式是二进制数据,不需要APP做base64转码。
3. 新旧SDK枚举定义对比        APP端替换新SDK时不需要替换枚举,以下仅列出新旧枚举的对应关系,APP端可以查阅。
【XPGConfigureMode】
兼容枚举新定义枚举
XPGConfigureModeGizWifiConfigureMode
1: XPGWifiSDKSoftAPMode0: GizWifiSoftAP
2: XPGWifiSDKAirLinkMode1: GizWifiAirLink
【XPGWifiDeviceType】
兼容枚举新定义枚举
XPGWifiDeviceTypeGizWifiDeviceType
0: XPGWifiDeviceTypeNormal0: GizDeviceNormal
1: XPGWifiDeviceTypeCenterControl1: GizDeviceCenterControl
【XPGWifiThirdAccountType】
兼容枚举新定义枚举
XPGWifiThirdAccountTypeGizThirdAccountType
0: XPGWifiThirdAccountTypeBAIDU0: GizThirdBAIDU
1: XPGWifiThirdAccountTypeSINA1: GizThirdSINA
2: XPGWifiThirdAccountTypeQQ2: GizThirdQQ
【XPGUserAccountType】
兼容枚举新定义枚举
XPGUserAccountTypeGizUserAccountType
0: XPGUserAccountTypeNormal0: GizUserNormal
1: XPGUserAccountTypePhone1: GizUserPhone
2: XPGUserAccountTypeEmail2: GizUserEmail
【XPGWifiGAgentType】
兼容枚举新定义枚举
XPGWifiGAgentTypeGizWifiGAgentType
0: XPGWifiGAgentTypeMXCHIP0: GizGAgentMXCHIP
1: XPGWifiGAgentTypeHF1: GizGAgentHF
2: XPGWifiGAgentTypeRTK2: GizGAgentRTK
3: XPGWifiGAgentTypeWM3: GizGAgentWM
4: XPGWifiGAgentTypeESP4: GizGAgentESP
5: XPGWifiGAgentTypeQCA5: GizGAgentQCA
6: XPGWifiGAgentTypeTI6: GizGAgentTI
7: XPGWifiGAgentTypeFSK7: GizGAgentFSK
8: XPGWifiGAgentTypeMXCHIP38: GizGAgentMXCHIP3
9: XPGWifiGAgentTypeBL9: GizGAgentBL
【XPGUserGenderType】
兼容枚举新定义枚举
XPGUserGenderTypeGizUserGenderType
0: Male0: GizUserGenderMale
1: Female1: GizUserGenderFemale
2: Unknown2: GizUserGenderUnknown
【XPGWifiErrorCode】
兼容枚举
新定义枚举


XPGWifiErrorCode
GizWifiErrorCode


0
XPGWifiError_NONE
0
GIZ_SDK_SUCCESS
-1
XPGWifiError_GENERAL
8100
GIZ_SDK_OTHERWISE
-7
XPGWifiError_CONNECTION_CLOSED
8047
GIZ_SDK_CONNECTION_CLOSED
-9
XPGWifiError_LOGIN_VERIFY_FAILED
8049
GIZ_SDK_DEVICE_LOGIN_VERIFY_FAILED
-11
XPGWifiError_NOT_CONNECTED
8029
GIZ_SDK_DEVICE_NOT_SUBSCRIBED
-15
XPGWifiError_THREAD_CREATE
8102
GIZ_SDK_THREAD_CREATE_FAILED
-19
XPGWifiError_CONNECTION_ERROR
8046
GIZ_SDK_CONNECTION_ERROR
-20
XPGWifiError_INVALID_PARAM
8006
GIZ_SDK_PARAM_INVALID
8033
GIZ_SDK_DEVICE_CONTROL_WITH_INVALID_COMMAND


8036
GIZ_SDK_DEVICE_CONTROL_VALUE_TYPE_ERROR


8037
GIZ_SDK_DEVICE_CONTROL_VALUE_OUT_OF_RANGE


8038
GIZ_SDK_DEVICE_CONTROL_NOT_WRITABLE_COMMAND


-21
XPGWifiError_CONNECT_TIMEOUT
8044
GIZ_SDK_CONNECTION_TIMEOUT
-23
XPGWifiError_INSUFFIENT_MEM
8101
GIZ_SDK_MEMORY_MALLOC_FAILED
-25
XPGWifiError_HTTP_FAIL
8099
GIZ_SDK_HTTP_REQUEST_FAILED
-27
XPGWifiError_DNS_FAILED
8041
GIZ_SDK_DNS_FAILED
-30
XPGWifiError_UDP_PORT_BIND_FAILED
8004
GIZ_SDK_UDP_PORT_BIND_FAILED
-39
XPGWifiError_CONFIGURE_SSID_NOT_MATCHED
8310
GIZ_SDK_PHONE_NOT_CONNECT_TO_SOFTAP_SSID
8311
GIZ_SDK_DEVICE_CONFIG_SSID_NOT_MATCHED


-40
XPGWifiError_CONFIGURE_TIMEOUT
8023
GIZ_SDK_DEVICE_CONFIG_TIMEOUT
8308
GIZ_SDK_REQUEST_TIMEOUT


-41
XPGWifiError_CONFIGURE_SENDFAILED
8021
GIZ_SDK_DEVICE_CONFIG_SEND_FAILED
-42
XPGWifiError_NOT_IN_SOFTAPMODE
8312
GIZ_SDK_NOT_IN_SOFTAPMODE
-45
XPGWifiError_CONNECTION_REFUSED
8045
GIZ_SDK_CONNECTION_REFUSED
-46
XPGWifiError_IS_RUNNING
8022
GIZ_SDK_DEVICE_CONFIG_IS_RUNNING
8315
GIZ_SDK_PRODUCT_IS_DOWNLOADING


-47
XPGWifiError_UNSUPPORTED_API
8307
GIZ_SDK_UNSUPPORTED_API
-49
XPGWifiError_START_SDK_FAILED
8002
GIZ_SDK_CLIENT_NOT_AUTHEN
旧的错误码在以上对照表中没有的,新SDK一律按新的错误码8100处理。

1、机智云QQ群: 287087942
机智云爱好者-APP开发群: 599735135
QQ群目前非常活跃,欢迎大家参与进来,交流,讨论,答疑,解惑~~
2、机智云微信公众号: 机智云 gizwits /   机智云智能宠物屋go-kit
关注机智云Gizwits官方公众号随时掌握最新资讯和活动信息
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

加入Q群 返回顶部

版权与免责声明 © 2006-2024 Gizwits IoT Technology Co., Ltd. ( 粤ICP备11090211号 )

快速回复 返回顶部 返回列表