# iot-link-ios

**Repository Path**: mirrors_tencentyun/iot-link-ios

## Basic Information

- **Project Name**: iot-link-ios
- **Description**: IoT 应用端 App & SDK
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: video-v2.4.x
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2025-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 产品介绍

腾讯云物联网开发平台（Tencent IoT）是集智能生活、智能制造、智能人居等功能于一体的解决方案。如家庭生活类产品，智能门锁可通过 wifi 设备接入腾讯云 IoT 平台进行管理。

项目工程中包含三大块，App 体验模块、SDK Demo、SDK 模块。 用户可通过 App 体验产品功能，通过现有 App 快速搭建起属于自己的 IoT 应用。 也可通过 SDK 接入到自己的工程来完成与腾讯云物联网开发平台对接功能。


  

## 安装包指引

* [腾讯连连体验包下载](https://github.com/tencentyun/iot-link-ios/wiki/下载安装)

  

## 接入的第三方组件

腾讯连连是一个完整的应用项目，集成了业内主流的推送、定位、日志系统、性能统计和微信授权登录等功能。推送集成了信鸽推送，定位使用了腾讯地图，日志系统和性能统计依赖 Firebase，微信授权登录则需要微信的支持。

  

## 快速开始

用户需要根据实际情况调整 **app-config.json** 中的内容，app-config.json 位于项目的/LinkApp/Supporting Files目录下 app-config.json 需要配置的内容，如所示。   
  
```json
{
  "WXAccessAppId": "",
  "TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
  "TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端，此处仅为演示，如有泄露概不负责",
  "XgAccessId": "",
  "XgAccessKey": "",
  "XgUSAAccessId": "",
  "XgUSAAccessKey": "",
  "TencentMapSDKValue":"",
  "HEweatherKey":""
}
```   

**1、物联网平台**
* **TencentIotLinkAppkey** 和 **TencentIotLinkAppSecret** 请使用在[物联网开发平台](https://cloud.tencent.com/product/iotexplorer)创建应用时生成的 **APP Key** 和 **APP Secret**。<u>***App Key 和 App Secret 用于访问应用端 API 时生成签名串，参见[应用端 API 简介](https://cloud.tencent.com/document/product/1081/40773)。签名算法务必在服务端实现，腾讯连连 App 开源版的使用方式仅为演示，请勿将 App Key 和 App Secret 保存在客户端，避免泄露***</u>。

**2、信鸽（可选）**

&emsp;&emsp;腾讯连连开源体验版集成了**信鸽推送**，用于实现消息推送。

* 若不使用推送功能，**XgAccessId** 和 **XgAccessKey**  设置为**长度为0的字符串**即可。
* 若确认使用推送功能，需要前往[信鸽推送平台](https://cloud.tencent.com/product/tpns?fromSource=gwzcw.2454256.2454256.2454256&utm_medium=cpc&utm_id=gwzcw.2454256.2454256.2454256)申请获得的 **AccessID** 和 **AccessKey**，[申请步骤](https://cloud.tencent.com/product/tpns/getting-started)。
*  将申请获得的 **AccessID** 和 **AccessKey**，填写到[物联网开发平台中](https://console.cloud.tencent.com/iotexplorer/project/prj-hwcjnzaa/app/list)
*  将申请获得的 **AccessID** 和 **AccessKey**，写入在app-config.json文件中对应位置。

```json
{
  "WXAccessAppId": "",
  "TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
  "TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端，此处仅为演示，如有泄露概不负责",
  "XgAccessId": "请输入从信鸽推送平台申请的AccessID",
  "XgAccessKey": "请输入从信鸽推送平台申请的AccessKey",
  "TencentMapSDKValue":"请输入从腾讯位置服务申请的key",
  "HEweatherKey":"请输入从和风天气开发平台申请的key"
}
```     

**3、 Firebase （可选）**

&emsp;&emsp;腾讯连连开源体验版集成了 **Firebase** 插件，用于记录应用的异常日志和性能状况。
* 若用户确认使用 Firebase 插件，需通过 [Firebase 官网](https://firebase.google.cn/?hl=zh-cn) 创建应用并获取 **GoogleService-Info.plist** 文件；将 GoogleService-Info.plist 文件放在项目 /LinkApp/Supporting Files 目录下。

**4、微信授权登录（可选）**
  
&emsp;&emsp;腾讯连连开源体验版集成了微信授权登录。    

* 若确认使用自定义的微信授权登录，需要在[微信开放平台](https://open.weixin.qq.com/)注册开发者帐号，创建移动应用，审核通过后，即可获得相应的 AppID 和 AppSecret，[申请步骤](https://developers.weixin.qq.com/doc/oplatform/Mobile_App/WeChat_Login/Development_Guide.html)；同时需要自行搭建微信授权登录的**接入服务器**，可参考接入服务器的[接口](https://cloud.tencent.com/document/product/1081/40781)。

   使用微信授权登录还需：
   * 将配置项 **WXAccessAppId** 设置为在微信开放平台申请并获得的 **AppID**；***<u>同时请遵从官方建议自建微信接入服务器，保证 AppSecret 不被泄露</u>***；在 app-config.json 文件中修改 **WXAccessAppId**  配置项，如下：
   ```json
      {
        "WXAccessAppId": "",
        "TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
        "TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端，此处仅为演示，如有泄露概不负责",
        "XgAccessId": "",
        "XgAccessKey": "",
        "XgUSAAccessId": "",
        "XgUSAAccessKey": "",
        "TencentMapSDKValue":"",
        "HEweatherKey":""
      }
   ```   


   * 最后将配置项 **LinkAPP_WEIXIN_APPID** 设置为在微信开放平台申请并获得的 **AppID**；***<u>同时请遵从官方建议自建微信接入服务器，保证 AppSecret 不被泄露</u>***；在工程中 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、 腾讯位置服务 （可选）**   

&emsp;&emsp;腾讯连连开源体验版集成了腾讯地图位置服务，用于定位选址和搜索周边地点。   

* 若使用自定义接入的腾讯位置服务，需要在[腾讯位置服务](https://lbs.qq.com/)注册开发者账号，创建移动应用，即可获取应用对的key，[申请步骤](https://lbs.qq.com/faq/accountQuota/faqKey)，**在编辑key时需要启用产品的 WebServiceAPI 和地图 SDK**；将申请的 key 写入 app-config.json 文件中对应位置。
	
```json
{
  "WXAccessAppId": "",
  "TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
  "TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端，此处仅为演示，如有泄露概不负责",
  "XgAccessId": "请输入从信鸽推送平台申请的AccessID",
  "XgAccessKey": "请输入从信鸽推送平台申请的AccessKey",
  "TencentMapSDKValue":"请输入从腾讯位置服务申请的key",
  "HEweatherKey":"请输入从和风天气开发平台申请的key"
}
```        

* 若不使用腾讯位置服务，**TencentMapSDKValue** 设置为**长度为0字符串**即可。

**6、 和风天气 （可选）**    

&emsp;&emsp;腾讯连连开源体验版集成了和风天气开发平台，用于设置和显示天气。   

* 若使用自定义的和风天气服务，需要在[和风天气开发平台](https://dev.qweather.com/)注册开发者账号，创建移动应用，获取应用对应key ，[申请步骤](https://dev.qweather.com/docs/start)。      

* **腾讯连连开源体验版集成和风天气对应的 key 类型为 Web API**，若创建应用对应 key 类型非 Web API，需要单独接入对应平台的 SDK，[SDK 接入和配置](https://dev.qweather.com/docs/)。   

* 将和风天气开发平台申请的 key 写入 app-config.json 文件中对应位置。   

```json
{
  "WXAccessAppId": "",
  "TencentIotLinkAppkey": "请输入从物联网开发平台申请的Appkey, 正式发布前务必填写",
  "TencentIotLinkAppSecret": "请输入从物联网开发平台申请的AppSecrect, AppSecrect请保存在服务端，此处仅为演示，如有泄露概不负责",
  "XgAccessId": "请输入从信鸽推送平台申请的AccessID",
  "XgAccessKey": "请输入从信鸽推送平台申请的AccessKey",
  "TencentMapSDKValue":"请输入从腾讯位置服务申请的key",
  "HEweatherKey":"请输入从和风天气开发平台申请的key"
}
```

* 若不适用和风天气服务，**HEweatherKey** 设置为**长度为0字符串**即可。   


完成上述配置后，依赖 Xcode 的构建，即可在手机上运行。


## 定制 App 相关指引

* [定制 App 快速接入](doc/平台技术文档/部署设置.md)
* [定制 App 部署整体流程](doc/第三方APP部署流程.md)
* [定制 App 接入须知](doc/第三方定制APP接入指南.md)
* [定制 App 常见问题](doc/第三方定制APP常见问题.md)
* [APP发布前确认事项](doc/APP发布前确认事项.md)
* [SDK 说明文档](doc/平台技术文档/SDK%20接入说明.md)


## 第三方服务接入指引

* [实时音视频接入指南](Source/SDK/LinkRTC/README.md)
* [物联网智能视频服务](Source/SDK/LinkVideo/README.md)