本文介绍开发者如何基于物联网开发平台 APP SDK(下称 SDK)构建自主品牌 APP,通过 SDK 使用平台提供的用户管理,设备管理等能力。
App 源码获取
iOS 版本 App 可通过 腾讯连连-iOS 下载源码 。
Android 版本 App 可通过 腾讯连连-Android 下载源码 。
创建应用
1. 登录 物联网智能视频服务(消费版)控制台,在左侧导航栏选择应用开发。
2. 单击新建应用,创建应用成功后,即可获取系统自动生成的 AppKey 与 AppSecret。
3. 将App Key 写入配置文件, 将 App Secret 保存在 自建后台, 将 appapi 调用由设备端发起切换为由自建后台服务发起。
搭建后台服务
注意:
登录前所使用的 API URL 为
https://iot.cloud.tencent.com/api/exploreropen/appapi
,不建议在设备端调用,需要替换为自建的后台服务,以避免密钥的泄漏。api/studioapp/* 为公版 App 专用,OEM 的 App 使用的是应用端 API(api/exploreropen/),当在 App 参数写入配置文件中配置 TencentIotLinkAppkey 后,api/studioapp 调用将自动切换为应用端 API 调用。
App API (api/exploreropen/appapi)请在自建后台进行调用,Token API(api/exploreropen/tokenapi)可安全在设备端调用。
iOS 版本 可通过 TIoTAppEnvironment.m 的 selectEnvironmentType 方法中设置此 API 。
登录前所使用的 API URL 在 environment.oemAppApi 配置,请务必替换成自建的后台服务地址。
- (void)selectEnvironmentType {TIoTAppConfigModel *model = [TIoTAppConfig loadLocalConfigList];TIoTCoreAppEnvironment *environment = [TIoTCoreAppEnvironment shareEnvironment];[environment setEnvironment];environment.appKey = model.TencentIotLinkAppkey;environment.appSecret = model.TencentIotLinkAppSecret;// 请在 [environment setEnvironment]; 之后设置 oemAppApi 以免被覆盖。environment.oemAppApi = @"需要替换为自建后台服务地址";}
- (void)setEnvironment {//公版&开源体验版使用 当在 app-config.json 中配置 TencentIotLinkAppkey TencentIotLinkAppSecret 后,将自动切换为 OEM 版本。self.studioBaseUrl = @"https://iot.cloud.tencent.com/api/studioapp";self.studioBaseUrlForLogined = @"https://iot.cloud.tencent.com/api/studioapp/tokenapi";//OEM App 使用self.oemAppApi = @"https://iot.cloud.tencent.com/api/exploreropen/appapi"; // 需要在 TIoTAppEnvironment.m 的 -selectEnvironmentType: 中替换为自建后台服务地址。self.oemTokenApi = @"https://iot.cloud.tencent.com/api/exploreropen/tokenapi"; // 可安全在设备端调用。self.wsUrl = @"wss://iot.cloud.tencent.com/ws/explorer";self.h5Url = @"https://iot.cloud.tencent.com/explorer-h5";}
Android 版本 可通过 HttpRequest 中设置API 。
登录前所使用的 API URL 在 OEM_APP_API 配置,请务必替换成自建的后台服务地址。
/*接口请求文件*/class HttpRequest private constructor() {companion object {// 公版&开源体验版使用 当在 app-config.json 中配置 TencentIotLinkAppkey TencentIotLinkAppSecret 后,将自动切换为 OEM 版本。const val STUDIO_BASE_URL = "https://iot.cloud.tencent.com/api/studioapp"const val STUDIO_BASE_URL_FOR_LOGINED = "https://iot.cloud.tencent.com/api/studioapp/tokenapi"// OEM App 使用const val OEM_APP_API = "https://iot.cloud.tencent.com/api/exploreropen/appapi" // 需要替换为自建后台服务地址const val OEM_TOKEN_API = "https://iot.cloud.tencent.com/api/exploreropen/tokenapi" // 可安全在设备端调用。const val APP_COS_AUTH = "https://iot.cloud.tencent.com/api/studioapp/AppCosAuth"const val BUSI_APP = "studioapp"const val BUSI_OPENSOURCE = "studioappOpensource"}}