Android SDK使用系列教程——2.SDK初始化和常用类介绍
本帖最后由 碎羽 于 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方法指令日志输出的级别。可参考如下代码:
import com.xtremeprog.xpgconnect.XPGWifiSDK;
…
public void onCreate() {
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的用户注册功能》
学习了,谢谢分享!
页:
[1]