收藏官网首页
查看: 4550|回复: 1

Android SDK使用系列教程——2.SDK初始化和常用类介绍

8

主题

39

帖子

256

积分

版主

Rank: 7Rank: 7Rank: 7

积分
256
发表于 2015-6-18 11:33:31 | 显示全部楼层 |阅读模式
教您5分钟接入机智云,实现傻瓜式开发
本帖最后由 碎羽 于 2015-6-18 11:36 编辑

上次讲到SDK的下载和导入,这次来讲讲SDK的初始化和常用类的介绍。
一、初始化SDK
初始化SDK,首先要获得对应设备的AppID。AppID在每个产品的设备详细信息那里可以看到。
什么是AppID呢?
AppID是应用标识码。当开发者需要为一款智能产品开发应用(包括iOS、Android、Web应用等)时,后台会自动生成一个AppID,并与此设备进行关联。应用开发时需要填入此AppID。每个AppID对应的用户系统都是独立的,也就是在AppID A对应的App注册的用户,无法在AppID B对应的App中登录,需要重新注册并绑定设备。应用标识码(ProductKey )和产品标识码(AppID)在产品创建时同时生成,但两者之间没有直接的对应关系,一个AppID可以对应多个ProductKey,一个ProductKey也可以对应多个AppID。

获取到AppID以后,在项目的Application或者第一个启动的Activity的onCreate中调用
XPGWifiSDK.sharedInstance().startWithAppID方法,该方法指定sdk的APP ID,指定后使用注册登录等的所有用户关系都将保存在该APP ID中,替换别的APP ID以后,需要重新注册用户。另外,还可以通过XPGWifiSDK.setLogLevel方法指令日志输出的级别。可参考如下代码:
  1. import com.xtremeprog.xpgconnect.XPGWifiSDK;

  2. public void onCreate() {
  3.                 super.onCreate();
复制代码

二、常用类介绍

XPGWifiSDK
机智云sdk控制类。机智云sdk中提供了用户注册登录,设备配置,设备连接绑定等操作的接口,该类是对这些接口的抽象。该类是一个单例。它提供了如下接口:

1.sdk初始化的接口。包括appid的指定,日志的设定。
2.用户账号相关的接口。包括用户的注册,登录,密码重置等。
3.设备配置相关的接口。包括设备的配置入网,绑定,获取设备列表等。
4.设备连接相关的接口。包括设备的登录等。

XPGWifiDevice

机智云sdk设备类。机智云的设备包含了许多属性,该类是对这些属性的抽象。它提供了如下接口:

1.设备操作。包括设备的登录,控制,断开等。
2.设备基础信息获取。包括设备的did,passcode,硬件信息等。
3.设备实时状态获取。例如热水器的水温等,因不同设备而异。

XPGWifiSSID

机智云SDK Wi-Fi类。该类包含了sdk搜索到的Wi-Fi信号的名称和信号强度。

XPGWifiSDKListener

SDK通用**,该**是SDK使用中十分重要的一个**,与SDK相关的操作都会在这里会回调,如果没有正确注册通用**,将无法正常使用SDK。

回调包括:
didBindDevice:绑定设备结果回调
didChangeUserEmail:更换用户Email结果回调
didChangeUserPhone:更换用户手机号结果回调
didChangeUserPassword:更换用户密码结果回调
didDiscovered:获取设备列表结果回调
didGetSSIDList:获取模块周围Wi-Fi热点列表结果回调
didRegisterUser:用户注册结果回调
didRequestSendVerifyCode:发送手机验证码结果回调
didSetDeviceWifi:配置模块结果回调
didUnbindDevice:设备解除绑定结果回调
didUserLogin:用户登录结果回调
didUserLogout:用户注销结果回调

XPGWifiDeviceListener

SDK设备**,该**是SDK使用中十分重要的一个**,与设备相关的方法都会在该**中回调。

回调包括:
didQueryHardwareInfo:设备硬件信息回调
didDeviceOnline:设备上下线状态回调
didDisconnected:设备断开连接回调
didLogin:设备登录回调
didReceiveData:接收到设备状态上报回调

以上几个类的具体介绍和用法,请参考官方说明文档,这里不一一细说,会在后面的教程中再详细介绍用法。

今天的教程就到这里。
下一篇教程《Android SDK使用系列教程——3.SDK的用户注册功能》



5

主题

63

帖子

855

积分

高级会员

Rank: 4

积分
855
发表于 2015-10-22 01:39:29 | 显示全部楼层
学习了,谢谢分享!
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

加入Q群 返回顶部

© 2011-2017 Gizwits ( 粤ICP备11090211号 )

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