SDK 介绍
SDK名称
SDK名称:IOTSDK.framework
接入说明
下载IOTSDK.framework,将该文件拷贝到工程目录下即可。(友情提示:如果出现库文件不能正确导入,可尝试新建New Copy Files Phase,选择Frameworks,添加IOTSDK.framework)
注意事项
SDK内置了Esptouch、HFSmartLink、EasyLink、LTLink、JMAirKiss和MQTTClient第三方框架,并进行了再次封装,以下有详细说明。所以,为避免冲突,客户端App不宜再导入相同类库。
SDK使用
SDK初始化
初始化SDK
1.在项目TAGETS—>Build Phases—>New Copy Files Phase下点击加号,加入IOTSDK.framework。
2.在项目TAGETS—>Build Phases—>Link Binary With Libraries下点击加号,加入IOTSDK.framework。
3.在项目的预编译文件PrefixHeader.pch中添加以下内容:
#import <IOTSDK/IOTSDK.h>
4.打开AppDelegate.m文件,在[AppDelegate application:didFinishLaunchingWithOptions:]方法中使用开发平台获取的AppID和AppToken初始化SDK:
初始化SDK有以下两种方式:
1、 不自由配置域名和端口(默认使用青莲云域名及端口)
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
AppId | String | 应用id | 云平台获取 | 是 |
AppToken | String | 应用token | 云平台获取 | 是 |
isDebug | Bool | 是否为调试模式 | 调试模式可打印log | 是 |
例子:
[[IOTSmartSDK sharedInstance] IOTCloudSDK_startWithAppID:<#your_app_id#> AppToken:<#your_app_token#> isDebug: @"your_app_isDebug" success:^{
NSLog(@"install success");
} failure:^(int errNo,NSString *errMessage) {
NSLog(@"install failure: %@", errMessage);
}];
2、自由配置域名和端口
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
AppId | String | 应用id | 云平台获取 | 是 |
AppToken | String | 应用token | 云平台获取 | 是 |
APIHost | String | 接口服务器域名地址 | 贵公司申请的域名 | 是 |
FileHost | String | 文件服务器域名地址 | 贵公司申请的域名 | 是 |
SocketHost | String | 长连接服务器域名地址 | 贵公司申请的域名 | 是 |
SocketPort | Int | 长连接端口 | 贵公司申请的端口 | 是 |
isDebug | Bool | 是否为调试模式 | 调试模式可打印log | 是 |
例子:
[[IOTSmartSDK sharedInstance] IOTCloudSDK_startWithAppID:<#your_app_id#> AppToken:<#your_app_token#> APIHost: <#your_apihost_url#> FileHost: <#your_ filehost_url #> SocketHost: <#your_ sockethost_url #> SocketPort: <#your_ sockethost _port#> isDebug: @"your_app_isDebug" success:^{
NSLog(@"install success");
} failure:^(int errNo,NSString *errMessage) {
NSLog(@"install failure: %@", errMessage);
}];