准备工作
注意
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
iOS
参考
Source/LinkSDKDemo/Supporting Files/AppDelegate.m
文件,并配置物联网开发平台申请的 App Key 和 App Secret。- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {/** 此处仅供参考, 需自建服务接入物联网平台服务,以免 App Secret 泄露* 自建服务可参考此处 https://cloud.tencent.com/document/product/1081/45901#.E6.90.AD.E5.BB.BA.E5.90.8E.E5.8F.B0.E6.9C.8D.E5.8A.A1.2C-.E5.B0.86-app-api-.E8.B0.83.E7.94.A8.E7.94.B1.E8.AE.BE.E5.A4.87.E7.AB.AF.E5.8F.91.E8.B5.B7.E5.88.87.E6.8D.A2.E4.B8.BA.E7.94.B1.E8.87.AA.E5.BB.BA.E5.90.8E.E5.8F.B0.E6.9C.8D.E5.8A.A1.E5.8F.91.E8.B5.B7*/TIoTCoreAppEnvironment *environment = [TIoTCoreAppEnvironment shareEnvironment];[environment setEnvironment];environment.appKey = @"物联网开发平台申请的 App Key";environment.appSecret = @"物联网开发平台申请的 App Secret";self.window.rootViewController = [[UINavigationController alloc] initWithRootViewController:[UIViewController new]];return YES;}
Android
选择
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/45901#.E6.90.AD.E5.BB.BA.E5.90.8E.E5.8F.B0.E6.9C.8D.E5.8A.A1.2C-.E5.B0.86-app-api-.E8.B0.83.E7.94.A8.E7.94.B1.E8.AE.BE.E5.A4.87.E7.AB.AF.E5.8F.91.E8.B5.B7.E5.88.87.E6.8D.A2.E4.B8.BA.E7.94.B1.E8.87.AA.E5.BB.BA.E5.90.8E.E5.8F.B0.E6.9C.8D.E5.8A.A1.E5.8F.91.E8.B5.B7*/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 接入指南