腾讯云物联网开发平台(Tencent IoT)是集智能生活、智能制造、智能人居等功能于一体的解决方案。如家庭生活类产品,智能门锁可通过 wifi 设备接入腾讯云 IoT 平台进行管理。
项目工程中包含三大块,App 体验模块、SDK Demo、SDK 模块。 用户可通过 App 体验产品功能,通过现有 App 快速搭建起属于自己的 IoT 应用。 也可通过 SDK 接入到自己的工程来完成与腾讯云物联网开发平台对接功能。
腾讯连连是一个完整的应用项目,集成了业内主流的推送、定位、日志系统、性能统计和微信授权登录等功能。推送集成了信鸽推送,定位使用了腾讯地图,日志系统和性能统计依赖 Firebase,微信授权登录则需要微信的支持。
用户需要根据实际情况调整 app-config.json 中的内容,app-config.json 位于项目的/LinkApp/Supporting Files目录下 app-config.json 需要配置的内容,如所示。
{
"WXAccessAppId": "",
"TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
"TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端,此处仅为演示,如有泄露概不负责",
"XgAccessId": "",
"XgAccessKey": "",
"XgUSAAccessId": "",
"XgUSAAccessKey": "",
"TencentMapSDKValue":"",
"HEweatherKey":""
}
1、物联网平台
- TencentIotLinkAppkey 和 TencentIotLinkAppSecret 请使用在物联网开发平台创建应用时生成的 APP Key 和 APP Secret。App Key 和 App Secret 用于访问应用端 API 时生成签名串,参见应用端 API 简介。签名算法务必在服务端实现,腾讯连连 App 开源版的使用方式仅为演示,请勿将 App Key 和 App Secret 保存在客户端,避免泄露。
2、信鸽(可选)
腾讯连连开源体验版集成了信鸽推送,用于实现消息推送。
- 若不使用推送功能,XgAccessId 和 XgAccessKey 设置为长度为0的字符串即可。
- 若确认使用推送功能,需要前往信鸽推送平台申请获得的 AccessID 和 AccessKey,申请步骤。
- 将申请获得的 AccessID 和 AccessKey,填写到物联网开发平台中
- 将申请获得的 AccessID 和 AccessKey,写入在app-config.json文件中对应位置。
{
"WXAccessAppId": "",
"TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
"TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端,此处仅为演示,如有泄露概不负责",
"XgAccessId": "请输入从信鸽推送平台申请的AccessID",
"XgAccessKey": "请输入从信鸽推送平台申请的AccessKey",
"TencentMapSDKValue":"请输入从腾讯位置服务申请的key",
"HEweatherKey":"请输入从和风天气开发平台申请的key"
}
3、 Firebase (可选)
腾讯连连开源体验版集成了 Firebase 插件,用于记录应用的异常日志和性能状况。
- 若用户确认使用 Firebase 插件,需通过 Firebase 官网 创建应用并获取 GoogleService-Info.plist 文件;将 GoogleService-Info.plist 文件放在项目 /LinkApp/Supporting Files 目录下。
4、微信授权登录(可选)
腾讯连连开源体验版集成了微信授权登录。
-
若确认使用自定义的微信授权登录,需要在微信开放平台注册开发者帐号,创建移动应用,审核通过后,即可获得相应的 AppID 和 AppSecret,申请步骤;同时需要自行搭建微信授权登录的接入服务器,可参考接入服务器的接口。
使用微信授权登录还需:
- 将配置项 WXAccessAppId 设置为在微信开放平台申请并获得的 AppID;同时请遵从官方建议自建微信接入服务器,保证 AppSecret 不被泄露;在 app-config.json 文件中修改 WXAccessAppId 配置项,如下:
{ "WXAccessAppId": "", "TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写", "TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端,此处仅为演示,如有泄露概不负责", "XgAccessId": "", "XgAccessKey": "", "XgUSAAccessId": "", "XgUSAAccessKey": "", "TencentMapSDKValue":"", "HEweatherKey":"" }
- 最后将配置项 LinkAPP_WEIXIN_APPID 设置为在微信开放平台申请并获得的 AppID;同时请遵从官方建议自建微信接入服务器,保证 AppSecret 不被泄露;在工程中 Supporting Files 目录下的 LinkApp.xcconfig 文件中修改 LinkAPP_WEIXIN_APPID 配置项,如下:
{ LinkAPP_NAME = LinkAPP_WEIXIN_APPID = LinkAPP_BUNDLE_TEAM = LinkAPP_BUNDLE_SIGN = LinkAPP_BUNDLE_ID = LinkAPP_BUNDLE_PROVISIONING = }
-
若不使用微信授权登录功能,WXAccessAppId 设置为长度为0字符串即可。
5、 腾讯位置服务 (可选)
腾讯连连开源体验版集成了腾讯地图位置服务,用于定位选址和搜索周边地点。
- 若使用自定义接入的腾讯位置服务,需要在腾讯位置服务注册开发者账号,创建移动应用,即可获取应用对的key,申请步骤,在编辑key时需要启用产品的 WebServiceAPI 和地图 SDK;将申请的 key 写入 app-config.json 文件中对应位置。
{
"WXAccessAppId": "",
"TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
"TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端,此处仅为演示,如有泄露概不负责",
"XgAccessId": "请输入从信鸽推送平台申请的AccessID",
"XgAccessKey": "请输入从信鸽推送平台申请的AccessKey",
"TencentMapSDKValue":"请输入从腾讯位置服务申请的key",
"HEweatherKey":"请输入从和风天气开发平台申请的key"
}
- 若不使用腾讯位置服务,TencentMapSDKValue 设置为长度为0字符串即可。
6、 和风天气 (可选)
腾讯连连开源体验版集成了和风天气开发平台,用于设置和显示天气。
-
腾讯连连开源体验版集成和风天气对应的 key 类型为 Web API,若创建应用对应 key 类型非 Web API,需要单独接入对应平台的 SDK,SDK 接入和配置。
-
将和风天气开发平台申请的 key 写入 app-config.json 文件中对应位置。
{
"WXAccessAppId": "",
"TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
"TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端,此处仅为演示,如有泄露概不负责",
"XgAccessId": "请输入从信鸽推送平台申请的AccessID",
"XgAccessKey": "请输入从信鸽推送平台申请的AccessKey",
"TencentMapSDKValue":"请输入从腾讯位置服务申请的key",
"HEweatherKey":"请输入从和风天气开发平台申请的key"
}
- 若不适用和风天气服务,HEweatherKey 设置为长度为0字符串即可。
完成上述配置后,依赖 Xcode 的构建,即可在手机上运行。