SDK使用

*SDK初始化*

打开AppDelegate.m文件，在[AppDelegate application:didFinishLaunchingWithOptions:]方法中使用开发平台获取的AppID和AppToken调用接口初始化SDK：

请求参数：

例子：

[[IOTSmartSDK sharedInstance] IOTCloudSDK_startWithAppID:
<
#your_app_id#
>
AppToken:
<
#your_app_token#
>
 success:^{


NSLog
(
@
"
install success
"
);


} failure:^(
int 
errNo,
NSString
 *errMessage) {


NSLog
(
@
"
install failure: %@
"
, errMessage);


}
];

*用户注册*

用户相关的所有功能对应IOTSmartUser类。

1）发送注册验证码到手机：

请求参数：

例子：

- (
void
)sendVerifyCode {


[[IOTSmartUser sharedInstance] IOTCloudSDK_registerSendVerifyCodeByPhoneNum:
@
"
your_phone_number
"
zone:
 @
"
your_phone_zone
"
success:^{


NSLog
(
@
"
sendVerifyCode success
"
);


} failure:^(
int 
errNo,
NSString
 *errMessage) {


NSLog
(
@
"
sendVerifyCode failure: %@
"
, errMessage);


}];


}

2）使用手机验证码注册

请求参数：

例子：

- (
void
)registerByPhone {


[[IOTSmartUser sharedInstance] IOTCloudSDK_registerByPhoneNum:
@
"
your_phone_number
"
zone:
 @
"
your_phone_zone
"
 password:
@
"
your_password
"
 smsCode:
@
"
verify_code
"
 success:^{


NSLog
(
@
"
register success
"
);


} failure:^(
 int 
errNo,
NSString
 *errMessage) {


NSLog
(
@
"
register failure: %@
"
, errMessage);


}];


}

*用户登录*

1）使用手机号与密码进行登录：

请求参数：

例子：

- (
void
)loginByPhoneAndPassword {


[[IOTSmartUser sharedInstance] IOTCloudSDK_loginByPhoneNum:
@
"
your_phone_number
"
 password:
@
"
your_password
"
zone:
 @
"
your_phone_zone
"
success:^{


NSLog
(
@
"
login success
"
);


} failure:^(
 int 
errNo,
NSString
 *errMessage) {


NSLog
(
@
"
login failure: %@
"
, errMessage);


}];


}

2）用户退出登录

请求参数：无

例子：

- (
void
)
 signOut
 {


[[IOTSmartUser sharedInstance] IOTCloudSDK_Signout];


}

*获取产品列表*

添加产品配置到应用中就会在产品列表接口中获取到

产品相关的所有功能对应IOTSmartProduct类。

通过调用以下接口获取所有产品列表。返回IOTSmartProductListModel类对象数组。

请求参数：无

例子：

• (void)getProductList{
  [IOTSmartProductIOTCloudSDK_getProductListSuccess:^(NSArray<IOTSmartProductListModel *> *productListModelArr) {
  NSLog(@"getProductList success");
  } failure:^(interrNo,NSString*errMessage) {
  NSLog(@"getProductList failure: %@", errMessage);
  }];
  }

*设备配网*

设备配网有两种类型：

1）直接调用硬件厂商的配网SDK给已知模组配网，目前支持的模组：乐鑫ESP8266、汉枫LPB120、庆科WIFI模组、高通WIFI、AirKissWIFI模组。

请求参数：

例子：

• (void)start{
  [[IOTSmartActivator shareInstance]IOTCloudSDK_startConfigWithActivatorType:@"your_choose_activatorType"password:@"your_wifi_password"success:^{
  NSLog(@"activator success");
  } failure:^{
  NSLog(@"activator failure");
  }];
  }

2）把设备作为热点，手机连到设备热点，把目标网络的ssid的password传给设备实现AP配网。

请求参数：

例子：

• (void)APstart{
  [[IOTSmartActivator shareInstance]IOTCloudSDK_startAPConfigWithSSID:@"wifi_ssid"password:@" wifi_password"success:^{
  NSLog(@"activator success");
  } failure:^{
  NSLog(@"activator failure");
  }];
  }

3）停止配网

请求参数：

例子：

• (void)stop{
  [[IOTSmartActivator shareInstance] IOTCloudSDK_stopConfigWithActivatorType:@"your_choose_activatorType"];
  }

\4.6 搜索设备

硬件正常上网后，搜索设备发现设备，采用udp发包形式，发现设备相关的所有功能对应IOTSmartFindDevices类。

1）调用以下方法发现设备后立即成功回调返回IOTSmartFindDeviceModel实体类对象，可以多次成功回调。

请求参数：

例子：

• (void)startFind{
  [[IOTSmartFindDevices shareInstance]IOTCloudSDK_getDeviceWithProductId:@"your_choose_productId"timeout：@"your_choose_timeout"success:^( IOTSmartFindDeviceModel *findDeviceModel){
  NSLog(@"findDevices success");
  } failure:^(interrNo,NSString*errMessage) {
  NSLog(@"findDevices failure: %@", errMessage);
  }];
  }

2）停止搜索设备

请求参数：无

例子：

• (void)stopfind{
  [[IOTSmartFindDevices shareInstance] IOTCloudSDK_stopUDP];
  }

\4.7 绑定设备

一个设备只能被一个用户绑定，不允许多个用户绑定一个设备。设备相关的所有功能对应IOTSmartDevice类。绑定成功返回IOTSmartDeviceListModel实体类对象。

1）调用以下接口实现用户与搜索到的设备进行绑定：

请求参数：

例子：

• (void)bindDevice{
  [IOTSmartDevice IOTCloudSDK_bindDeviceWithIotId:@"your_findDevice_iotId"iotToken：@"your_ findDevice_iotToken"success:^(IOTSmartDeviceListModel * deviceModel){
  NSLog(@"bindDevice success");
  } failure:^(interrNo,NSString*errMessage) {
  NSLog(@"bindDevice failure: %@", errMessage);
  }];
  }

2）解绑设备

请求参数：无

例子：

• (void)unbindDevice{
  [**self.**device IOTCloudSDK_unbindDeviceSuccess: ^{
  NSLog(@"unbindDevice success");
  } failure:^(interrNo,NSString*errMessage) {
  NSLog(@"unbindDevice failure: %@", errMessage);
  }];
  }

\4.8 获取设备列表

通过调用以下接口获取所有设备列表。返回IOTSmartDevice类对象数组。

请求参数：无

例子：

• (void)getDeviceList{
  [IOTSmartDevice IOTCloudSDK_getDeviceListSuccess: ^(NSArray<IOTSmartDevice *> * deviceLisArr) {
  NSLog(@"getDeviceList success");
  } failure:^(interrNo,NSString*errMessage) {
  NSLog(@"getDeviceList failure: %@", errMessage);
  }];
  }

\4.9 控制设备

控制设备之前需要为该设备所属的产品增加功能点，点击进入产品功能后，添加功能点即可。

请求参数：

例子：

• (void)cmdDps{
  [**self.**device IOTCloudSDK_publishDps：@"your_dps_Arr"sucess:^{
  NSLog(@"cmdDps success");
  } failure:^(NSString*errMessage) {
  NSLog(@"cmdDps failure: %@", errMessage);
  }];
  }

\4.10 监听设备状态上报

手机端要监听该用户下的所有设备的数据点更新，需要将自身作为IOTSmartNotificationDeviceNewDPsUpdateArr通知的观察者。在相应的通知方法里，取出notice.userInfo，根据[notice.userInfo objectForKey:@"iotId"],判断哪个设备有数据点更新。