准备工作
注意:
iOS 安装环境
安装 Xcode 开发工具。
集成 SDK 方式。
执行如下命令采用 Cocoapods 方式集成。
pod TIoTLinkKit
手动集成。
将 LinkCore 目录拖入到工程中。
Android 安装环境
安装 Android Studio 开发工具
集成 SDK 方式
依赖 maven 远程构建
implementation 'com.tencent.iot.explorer:explorer-link-android:1.0.0'
依赖本地 SDK 源码 构建
修改应用模块的 build.gradle,使应用模块依赖 SDK 源码,示例如下:
implementation project(path: ':sdk')
使用说明
1. 导入配置,初始化 SDK。
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {/** 此处仅供参考, 需自建服务接入物联网平台服务,以免 App Secret 泄露* 自建服务可参考此处 https://cloud.tencent.com/document/product/1081/67508#16db0cee-3a20-4272-8ca3-1de6beb44112*/TIoTCoreAppEnvironment *environment = [TIoTCoreAppEnvironment shareEnvironment];[environment setEnvironment];environment.appKey = @"物联网开发平台申请的 App Key";environment.appSecret = @"物联网开发平台申请的 App Secret";self.window.rootViewController = [[UINavigationController alloc] initWithRootViewController:[UIViewController new]];return YES;}
选择
sdkdemo/src/main/java/com/tencent/iot/explorer/link/core/demo/App.java
,配置 App key。class App : Application() {companion object {val data = AppData.instance}private val APP_KEY = "物联网开发平台申请的 App Key"private val APP_SECRET = "物联网开发平台申请的 App Secret"override fun onCreate() {super.onCreate()/** 此处仅供参考, 需自建服务接入物联网平台服务,以免 App Secret 泄露* 自建服务可参考此处 https://cloud.tencent.com/document/product/1081/67508#16db0cee-3a20-4272-8ca3-1de6beb44112*/IoTAuth.openLog(true)IoTAuth.init(APP_KEY, APP_SECRET)}override fun onTerminate() {super.onTerminate()}}
2. App SDK 功能划分说明。
iOS
iOS 对应模块 | 实现相关功能 |
QCDeviceCenter | 配网模块。 |
QCAPISets | 设备控制、消息相关、家庭管理、账户管理等 API。 |
QCFoundation | 工具类。 |
Android
Android 子模块 | 实现相关功能 |
link | 配网模块。 |
auth | 设备控制、消息相关、家庭管理、账户管理等 API。 |
utils | 工具类。 |
log | 日志模块。 |
3. 账户相关接口,包含手机号、邮箱注册,登入登出,密码操作,用户信息操作。账户详细接口请参考 官方文档, 或者 App SDK 文件中 iOS 文件 (TIoTCoreAccountSet.h) 或 Android 文件( IoTAuth.kt)。
注意:
此处仅为 Demo 演示功能,请遵从官方建议自建账户后台服务后,由自建服务接入物联网平台服务,以免 App Secret 泄露。
4. 详细功能请参考 App SDK 接入指南。