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

碎羽

上次讲到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. …
   
3. public void onCreate() {
   
4.                 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的用户注册功能》

QH_飞蓬

学习了，谢谢分享！